Agent Framework Azur

专业版增强能力

能力概览

• This is a documentation-only skill for building Azure AI Foundry agents
• its cloud, web search, M

快速入门

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用范围

不适用于：需要人工判断的复杂决策场景

使用方法

1. 分析代码上下文: 读取目标代码文件,解析项目结构与依赖关系
2. 执行开发操作: 根据用户指令执行编写/审查/重构/测试等开发任务
3. 验证与反馈: 运行检查工具确认修改正确性,输出差异与建议
4. 异常处理: 如遇错误,参考错误处理章节中对应场景的处理方式

参数说明

响应格式

{
  "success": true,
  "data": {
    "final_result": {
      "py_result": "py_result_value",
      "py_metadata": "py_metadata_value",
      "py_status": "py_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/agent-framework-azure-ai-py_template

错误恢复方案

安装与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

import asyncio
from typing import Annotated
from pydantic import BaseModel, Field
from agent_framework import (
    HostedCodeInterpreterTool,
    HostedWebSearchTool,
    ProtocolStreamableHTTPTool,
)
from agent_framework.azure import AzureAIAgentsProvider
from azure.identity.aio import AzureCliCredential
# ...
def get_weather(
    location: Annotated[str, Field(description="City name")],
) -> str:
    """Get weather for a location."""
    return f"Weather in {location}: 72°F, sunny"
# ...
class AnalysisResult(BaseModel):
    summary: str
    key_findings: list[str]
    confidence: float
# ...
async def main():
    async with (
        AzureCliCredential() as credential,
        ProtocolStreamableHTTPTool(
            name="Docs 协议",
            url="https://learn.microsoft.com/api/协议",
        ) as mcp_tool,
        AzureAIAgentsProvider(credential=credential) as provider,
    ):
        agent = await provider.create_agent(
            name="ResearchAssistant",
            instructions="You are a research assistant with multiple capabilities.",
            tools=[
                get_weather,
                HostedCodeInterpreterTool(),
                HostedWebSearchTool(name="Bing"),
                mcp_tool,
            ],
        )
# ...
        thread = agent.get_new_thread()
# ...
        # Non-streaming
        result = await agent.run(
            "Search for Python best practices and summarize",
            thread=thread,
        )
        print(f"Response: {result.text}")
# ...
        # Streaming
        print("\nStreaming: ", end="")
        async for chunk in agent.run_stream("Continue with examples", thread=thread):
            if chunk.text:
                print(chunk.text, end="", flush=True)
        print()
# ...
        # Structured output
            "Analyze findings",
            thread=thread,
            response_format=AnalysisResult,
        )
        analysis = AnalysisResult.model_validate_json(result.text)
        print(f"\nConfidence: {analysis.confidence}")
# ...
if __name__ == "__main__":
    asyncio.run(main())

问答汇总

Q1: 如何开始使用Agent Framework Azur？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

错误处理机制

限制条件

• 依赖云服务，需要网络连接
• 需要有效的云服务凭证和配置好的CLI环境
• 产生的云资源可能产生费用，使用前请确认计费方式
• 不同区域的服务可用性和功能支持可能存在差异

常见问题FAQ

Q1: 如何在Azure AI Foundry中集成智能体框架AzureAI？

A: 在Azure AI Foundry中，您可以通过配置工具和代理来集成智能体框架AzureAI，使用其云搜索和多模型能力。

Q2: 智能体框架AzureAI支持哪些类型的AI模型？

A: 智能体框架AzureAI支持多种AI模型，包括云搜索模型和多模型，适用于文本分析、自然语言处理等场景。

Q3: 如果遇到网络错误，应该如何处理？

A: 网络错误可能是由于连接超时或不可达导致的。您可以尝试重试请求，并检查您的网络连接。

Q4: 如何配置API Key以使用智能体框架AzureAI？

A: 您可以通过设置环境变量API_KEY来配置API Key。确保将API Key保存在安全的地方，避免泄露。

Q5: 智能体框架AzureAI是否支持自定义模型？

A: 是的，智能体框架AzureAI支持自定义模型。您可以将自己的模型集成到框架中，以扩展其功能。

故障应对方案

安全提示

创新亮点

通过集成智能体框架AzureAI，开发人员可以更高效地构建Azure AI Foundry代理，实现自动化和智能化的开发流程。

功能介绍

• 自动化执行: 纯文档型技能,指导构建Azure AI Foundry Agent,覆盖云搜索与多模型能力。This is a docu
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

效率量化分析

差异化对比