构建PromptFlow自定义连接至Azure AI Language服务遇阻求助

问题根源 #

你遇到的矛盾报错（要求密钥为空但留空又提示无效+模块缺失），核心是依赖包版本不匹配和连接配置逻辑误解导致的。

分步解决步骤 #

1. 修复ModuleNotFoundError: No module named 'azure.ai' #

该错误说明环境未正确安装适配的Azure AI Language SDK：

• 激活项目虚拟环境（若使用），在终端执行卸载冲突包：

  pip uninstall -y azure-cognitiveservices-language-textanalytics
  

• 安装PromptFlow兼容的稳定版本SDK：

  pip install azure-ai-textanalytics==5.3.0
  

2. 修正连接配置逻辑 #

官方文档表述可能存在歧义，正确配置如下：

• Config区域：填写endpoint，值为你的Azure Language资源终结点URL（格式示例：https://<resource-name>.cognitiveservices.azure.com/）
• Secrets区域：填写api_key，值为你的Azure Language资源密钥（必填，不可留空）
• 若模板中Secrets字段名显示为key2，手动修改为api_key——旧版本插件可能存在字段名错误

3. 预验证连接有效性 #

先通过脚本验证SDK、密钥和终结点是否正常，创建test_connection.py：

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

endpoint = "你的资源终结点URL"
api_key = "你的资源密钥"

def authenticate_client():
    ta_credential = AzureKeyCredential(api_key)
    return TextAnalyticsClient(endpoint=endpoint, credential=ta_credential)

client = authenticate_client()
# 测试关键短语提取功能
response = client.extract_key_phrases(documents=["Hello, I need help with my PromptFlow app."])
for doc in response:
    if not doc.is_error:
        print("关键短语:", doc.key_phrases)

运行脚本：

python test_connection.py

若能正常输出结果，说明底层连接无问题，再回到VSCode重新创建PromptFlow连接。

4. 更新VSCode PromptFlow插件 #

若以上步骤无效，检查插件版本并更新至最新——旧版本插件可能存在配置模板BUG，更新后重试连接创建。

内容的提问来源于stack exchange，提问作者Kuruption