使用 Azure AI Projects SDK 构建企业级 AI 应用

通过使用 azure-ai-projects SDK，开发者可以在 Microsoft Foundry 平台上快速构建具备复杂工具调用、持久化内存和版本管理能力的 AI Agents，并实现从开发到评估的完整闭环。

为什么需要这个技能

在构建企业级 AI 应用时，简单的 API 调用难以满足需求。开发者通常需要处理复杂的 Agent 状态管理、集成企业内部数据集、配置外部工具（如 Bing 搜索或 SharePoint）以及进行量化的模型评估。

azure-ai-projects SDK 提供了高层级的抽象，将模型部署、索引管理、连接配置和 Agent 编排集成在同一个 AIProjectClient 中。它不仅支持原生的 Foundry 操作，还兼容 OpenAI 客户端，允许开发者在快速原型开发和严谨的生产级管理之间无缝切换。

适用场景

• 复杂 Agent 构建：需要为 AI 赋予代码解释器、文件搜索或自定义函数调用能力。
• RAG 应用开发：需要将 AI 与 Azure AI Search 或 SharePoint 等企业数据源关联。
• 生产级版本管理：需要对 Agent 的指令（Instructions）进行版本化控制。
• 量化评估：需要使用内置评估器对 AI 生成内容的流畅度、任务达成率进行打分。

核心工作流

1. 环境初始化与认证

安装必要的依赖并配置项目端点。

pip install azure-ai-projects azure-identity

import os
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

credential = DefaultAzureCredential()
client = AIProjectClient(
    endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
    credential=credential,
)

2. 构建具备工具能力的 Agent

根据需求选择工具（如 CodeInterpreterTool 或 FileSearchTool）来增强 Agent。

from azure.ai.agents import CodeInterpreterTool, FileSearchTool

agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="tool-agent",
    instructions="你可以执行代码并搜索文件。",
    tools=[CodeInterpreterTool(), FileSearchTool()],
)

3. 管理对话线程与执行

通过 Thread 维护上下文，使用 create_and_process 简化执行流程。

# 创建线程并发送消息
thread = client.agents.threads.create()
client.agents.messages.create(thread_id=thread.id, role="user", content="分析这份数据报告")

# 执行并获取响应
run = client.agents.runs.create_and_process(thread_id=thread.id, agent_id=agent.id)
if run.status == "completed":
    messages = client.agents.messages.list(thread_id=thread.id)
    print(messages[0].content[0].text.value)

4. 质量评估（Evaluation）

通过获取 OpenAI 兼容客户端，调用内置评估器进行质量检查。

openai_client = client.get_openai_client()
eval_run = openai_client.evals.runs.create(
    eval_id="quality-check",
    name="fluency-test",
    testing_criteria=[{"type": "fluency"}, {"type": "task_adherence"}],
)

下载和安装

下载 azure-ai-projects-py 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐