技能 agent-framework-azure-ai-py
📦

agent-framework-azure-ai-py

安全 ⚡ 包含脚本⚙️ 外部命令🌐 网络访问

构建Azure AI Foundry智能体

使用Microsoft Agent Framework Python SDK在Azure AI Foundry上创建持久化AI智能体。本技能提供代码示例,用于构建具有托管工具、函数工具和对话线程的智能体。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“agent-framework-azure-ai-py”。 创建一个基础的Azure AI智能体

预期结果:

智能体将使用AzureAIAgentsProvider创建。然后它可以使用配置的指令和工具处理用户查询并返回响应。

正在使用“agent-framework-azure-ai-py”。 西雅图的天气怎么样?

预期结果:

西雅图天气:72°F,晴天

正在使用“agent-framework-azure-ai-py”。 计算20的阶乘

预期结果:

智能体使用HostedCodeInterpreterTool执行Python代码并返回结果:2432902008176640000

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
100
规范符合性

你能构建什么

构建客服智能体

创建能在多次交互中保持对话上下文的持久化AI智能体

具备工具的研究助手

构建能够搜索网页、执行代码和分析结果的智能体

企业工作流自动化

创建能够通过MCP工具与企业系统集成的智能体

试试这些提示

基础智能体设置
使用agent-framework-azure-ai-py技能创建一个名为'MyAgent'的Azure AI Foundry智能体,指令为'You are a helpful assistant'。
具备函数工具的智能体
创建一个能够获取天气信息的智能体。定义一个get_weather函数,接受location参数并返回天气数据。
具备托管工具的智能体
使用HostedCodeInterpreterTool和HostedWebSearchTool构建一个能够执行Python代码和搜索网页的智能体。
多轮对话
创建一个使用线程管理来在多次交互中保持对话上下文的智能体。

最佳实践

  • 始终使用异步上下文管理器(async with)进行正确的资源清理
  • 直接将函数传递给tools参数——它们会自动转换为AIFunction
  • 对函数参数使用Annotated[type, Field(description=...)]以提供清晰的描述
  • 对多轮对话使用get_new_thread()来保持上下文

避免

  • 不要在async函数内使用同步操作——这会导致死锁
  • 避免硬编码凭据——使用AzureCliCredential或DefaultAzureCredential
  • 不要跳过异步上下文管理器——始终对providers使用'async with'
  • 避免直接传递非async函数而不进行适当包装

常见问题

什么是Azure AI Foundry?
Azure AI Foundry是Microsoft用于大规模构建、部署和管理AI应用程序和智能体的平台。
我需要Azure订阅吗?
是的,您需要拥有配置了Azure AI Foundry的Azure订阅才能使用本技能。
支持哪些身份验证方法?
开发时使用AzureCliCredential,生产部署时使用DefaultAzureCredential。
我可以将Claude Code与Azure AI智能体一起使用吗?
是的,本技能适用于Claude、Codex和Claude Code,用于构建Azure AI Foundry智能体。
什么是托管工具?
托管工具是Azure管理的功能,包括代码解释器、文件搜索和网页搜索,智能体可以使用这些功能。
如何管理对话状态?
使用线程对象(get_new_thread())在多次智能体交互中保持对话上下文。

开发者详情

文件结构

📄 SKILL.md