SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场azure-foundry-agent

azure-foundry-agent

智能体与模型

查看项目

更新于 10-16 06:38

技能介绍

用途

Azure Foundry Agent 技能用于调用 Azure Foundry 智能体，以完成诸如任务分类、优先级排序等 AI 工作流。当用户消息中包含触发关键词（如“rate my task”“prioritize”）时，使用该技能的工作流。

主要能力

  • 发现 Foundry 资源：列出订阅中的 AIServices 资源及其端点和已部署模型。
  • 列出项目中的智能体：获取指定项目下可用的智能体。
  • 调用智能体：连接并查询特定智能体，执行任务分类等操作。
  • 其他命令：创建智能体、列出会话线程、获取线程消息。

使用方式

配置

将 config.example.yaml 复制为 config.yaml 并自定义：

# Azure subscription (optional - uses current if not set)
subscription: ""

# Foundry resource name (from foundry_resource_get)
resource: "shboyer-copilot-proj-resource"

# Project name
project: "shboyer-copilot-proj"

# Default agent
agent: "priority-detection-agent"

# Keywords that trigger this skill
triggers:
  - "rate my task"
  - "prioritize"

端点自动构造为：https://<resource>.services.ai.azure.com/api/projects/<project>

前置条件

  • 必须可用 Azure MCP 工具（azure-mcp-foundry）
  • 用户必须已通过 Azure 身份验证（az login）
  • 拥有已部署智能体的 Foundry 项目

工作流

步骤 1：获取当前订阅

az account show --query "{subscriptionId:id, name:name}" -o json

步骤 2：列出 Foundry 资源

使用 Azure MCP 列出订阅中的 Foundry 资源：

  • 工具：azure-mcp-foundry
  • 命令：foundry_resource_get
  • 参数：subscription: <subscription-id-from-step-1>

返回所有 AIServices 资源及其端点和已部署模型。

步骤 3：列出项目中的智能体

  • 工具：azure-mcp-foundry
  • 命令：foundry_agents_list
  • 参数：endpoint: https://<resource-name>.services.ai.azure.com/api/projects/<project-name>

注意：智能体的端点格式使用 .services.ai.azure.com（而非 .cognitiveservices.azure.com）。

步骤 4：调用智能体

  • 工具：azure-mcp-foundry
  • 命令：foundry_agents_connect
  • 参数：agent-id、endpoint、query

示例：任务优先级分类

对于 priority-detection-agent：

输入："Create a new PO for new supplies"

输出：

{
  "priority": "MEDIUM",
  "reasoning": "Creating a purchase order for new supplies is an important task that supports ongoing operations. While it should be addressed promptly, it is typically part of planned work and does not constitute an emergency.",
  "task_content": "Create a new PO for new supplies"
}

优先级指南

  • HIGH：关键紧急情况——生产中断、安全漏洞、系统故障、影响客户的问题
  • MEDIUM：有合理截止日期的重要任务、计划内工作、非关键缺陷
  • LOW：锦上添花的改进、外观变更、标记为“有时间再做”的任务

可用命令参考

命令 用途 必需参数
foundry_resource_get 列出 Foundry 资源 subscription
foundry_agents_list 列出项目中的智能体 endpoint
foundry_agents_connect 调用智能体 agent-id, endpoint, query
foundry_agents_create 创建新智能体 参见 MCP 文档
foundry_threads_list 列出会话线程 endpoint
foundry_threads_get-messages 获取线程消息 endpoint, thread-id

错误处理

  • 缺少订阅：运行 az account show 获取当前订阅
  • 身份验证失败：运行 az login 进行身份验证
  • 未找到智能体：使用 foundry_agents_list 验证智能体 ID
  • 端点无效：确保端点使用 .services.ai.azure.com/api/projects/ 格式

提示

  • 缓存订阅 ID 和端点以供后续调用
  • 来自 foundry_agents_list 的智能体 ID（如 asst_xxx）用于 foundry_agents_connect
  • 智能体响应中的线程 ID 可用于继续对话
  • 使用不带 resource-name 的 foundry_resource_get 列出所有资源

适用场景

  • 对任务进行优先级评估与分类
  • 与 Azure Foundry 中部署的智能体交互
  • 构建基于 Foundry 智能体的 AI 工作流

限制

  • 依赖 Azure MCP 工具（azure-mcp-foundry）的可用性
  • 需要 Azure 身份验证和已部署智能体的 Foundry 项目
  • 具体收费、价格、平台支持范围等资料暂未提供