{"id":21713,"library":"promptflow-tools","title":"Prompt Flow Built-in Tools","description":"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.","status":"active","version":"1.6.1","language":"python","source_language":"en","source_url":"https://github.com/microsoft/promptflow","tags":["promptflow","tools","llm","openai","azure","microsoft"],"install":[{"cmd":"pip install promptflow-tools","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core SDK required to run tools","package":"promptflow","optional":false},{"reason":"Required for OpenAI/LLM tools","package":"openai","optional":true},{"reason":"Required for Azure OpenAI tools","package":"azure-ai-inference","optional":true}],"imports":[{"wrong":"from promptflow.tools.azure_openai import AzureOpenAITool","symbol":"AzureOpenAITool","correct":"from promptflow.tools.azure_openai import AzureOpenAITool"}],"quickstart":{"code":"from promptflow.tools.azure_openai import AzureOpenAITool\nfrom promptflow.core import Flow\n\n# Use environment variables for credentials\nazure_openai = AzureOpenAITool(\n    api_key=os.environ.get('AZURE_OPENAI_API_KEY', ''),\n    api_base=os.environ.get('AZURE_OPENAI_ENDPOINT', ''),\n    api_version='2023-12-01-preview'\n)\n\n# Create a simple flow\nflow = Flow()\nflow.add_node(azure_openai, inputs={'prompt': 'Hello'})\nprint(flow)\n","lang":"python","description":"Initialize an Azure OpenAI tool and attach it to a flow."},"warnings":[{"fix":"Use 'from promptflow.tools.azure_openai import AzureOpenAITool' (note the dot-separated path with 'promptflow.tools').","message":"Import 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.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use the 'XxxTool' naming convention: e.g., 'AzureOpenAITool', 'OpenAITool', 'PythonTool'.","message":"The tools classes have been renamed from generic names like 'OpenAI' to 'OpenAITool'. Using old class names will raise ImportError.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"For promptflow >=1.12.0, import from 'promptflow.tools' directly without installing promptflow-tools separately.","message":"The '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.","severity":"deprecated","affected_versions":">=1.12.0"},{"fix":"Install optional dependencies: 'pip install openai' and/or 'pip install azure-ai-inference'.","message":"OpenAI and Azure OpenAI tools require the 'openai' and 'azure-ai-inference' packages respectively. Missing dependencies cause runtime errors on tool instantiation.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.17.1':40 '1.6.1':33 'azur':24,51 'built':4,8 'built-in':3,7 'current':30 'flow':2,14 'like':21 'llm':22,49 'microsoft':12,52 'openai':23,25,50 'packag':38 'parent':36 'prompt':1,13 'promptflow':37,45,47 'provid':15 'python':26 'readi':17 'ready-to-us':16 'regular':41 'releas':42 'sdk':46 'serpapi':27 'tool':6,10,20,48 'track':43 'use':19 'version':32","created_at":"2026-04-27T17:01:20.794218+00:00","updated_at":"2026-04-27T17:01:20.794218+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nModuleNotFoundError: No module named 'promptflow.tools.azure_openai'"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.6.1","cli_name":"","cli_version":null,"type":"library","homepage":"https://microsoft.github.io/promptflow/","github":"https://github.com/microsoft/promptflow","docs":null,"changelog":null,"pypi":"https://pypi.org/project/promptflow-tools/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["llm-agents","ai-ml","gcp"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}