Registry / llm-agents / promptflow-tools

promptflow-tools

library1.6.1pypypiunverified

Built-in tools for Microsoft Prompt flow, providing ready-to-use tools like LLM (OpenAI, Azure OpenAI), Python, SerpAPI, and more. Currently at version 1.6.1, with the parent promptflow package at 1.17.1. Regular releases track the promptflow SDK.

llm-agents ai-ml gcp

pip install promptflow-tools

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PROMPTFLOW-TOOLS

promptflow-tools

llm-agentspythonv1.6.1

Install

25.9s avg

Import

—

Disk

359MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.6.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 349.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 25.9s · import 0.000s · 339MB

359MB installed

● package 359MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

AzureOpenAITool

✓ from promptflow.tools.azure_openai import AzureOpenAITool

✗ from promptflow.tools.azure_openai import AzureOpenAITool

Initialize an Azure OpenAI tool and attach it to a flow.

from promptflow.tools.azure_openai import AzureOpenAITool from promptflow.core import Flow # Use environment variables for credentials azure_openai = AzureOpenAITool( api_key=os.environ.get('AZURE_OPENAI_API_KEY', ''), api_base=os.environ.get('AZURE_OPENAI_ENDPOINT', ''), api_version='2023-12-01-preview' ) # Create a simple flow flow = Flow() flow.add_node(azure_openai, inputs={'prompt': 'Hello'}) print(flow)

Debug

Known issues

breakingImport paths changed in promptflow-tools 1.0.0: all tools moved from 'promptflow.tools.<name>' to relative paths; top-level promptflow_tools is no longer importable.

fix

Use 'from promptflow.tools.azure_openai import AzureOpenAITool' (note the dot-separated path with 'promptflow.tools').

affects: >=1.0.0

gotchaThe tools classes have been renamed from generic names like 'OpenAI' to 'OpenAITool'. Using old class names will raise ImportError.

fix

Use the 'XxxTool' naming convention: e.g., 'AzureOpenAITool', 'OpenAITool', 'PythonTool'.

affects: >=1.0.0

deprecatedThe 'promptflow-tools' package is being deprecated in favor of built-in tools in 'promptflow'. Future releases of promptflow (>=1.12.0) include tools directly, so separate installation may become unnecessary.

fix

For promptflow >=1.12.0, import from 'promptflow.tools' directly without installing promptflow-tools separately.

affects: >=1.12.0

gotchaOpenAI and Azure OpenAI tools require the 'openai' and 'azure-ai-inference' packages respectively. Missing dependencies cause runtime errors on tool instantiation.

fix

Install optional dependencies: 'pip install openai' and/or 'pip install azure-ai-inference'.

affects: all

Upgrade

Version history

1.6.1latest on PyPI · released Jun 16, 2025

Audit

Dependencies

promptflowrequiredCore SDK required to run tools

openaioptionalRequired for OpenAI/LLM tools

azure-ai-inferenceoptionalRequired for Azure OpenAI tools

Agent activity

37 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/microsoft/promptflow ↗

packagehttps://pypi.org/project/promptflow-tools/ ↗

homepagehttps://microsoft.github.io/promptflow/ ↗