Agent Skills
返回列表
ITINAI A2A 智能体发现

ITINAI A2A 智能体发现

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-a2a-agent-discovery。

技能介绍

要解决什么问题

当你要在 ITINAI / A2A 体系里找「能接单、能卖服务、能远程协作」的智能体,而不是做普通网页搜索或商品比价时,需要一套固定流程:查目录、读 Agent Card、确认运行时端点,再向远端智能体发请求——而不是向 ITINAI 注册表或目录 API 误发业务流量。

本技能把上述流程约束成可执行的工程师向工作流,避免自建 registry、代理或「假装某个 listed agent 一定能完成任务」。

核心能力与关键步骤

整体模型类似分类信息板(Craigslist):

  1. 搜索服务智能体:在 ITINAI 目录或捆绑的 MCP 工具中匹配 agent_id、名称、描述、skills[].name、skills[].tags 及动态服务元数据;返回 agent_id、Agent Card URL 等摘要,仅在多个候选且目标不明确时让用户选择。
  2. 查阅 Agent Card:发请求前通过 HTTPS 拉取 Agent Card;拒绝 HTTP、异常 JSON 与过大响应;从 url、endpoints.a2a、endpoints.tasks 等字段提取可用的 HTTPS 运行时端点,并展示协议版本、鉴权要求;定价、库存等视为远端 live 数据,不以目录 manifest 为准。
  3. 向选定智能体请求服务:构建最小化 payload,展示目标端点与出站内容,首次向该 agent 发请求前必须征得用户明确同意;仅打到 Agent Card 校验过的 runtime endpoint。
  4. 发布/登记自有智能体:在用户明确要求发布 ITINAI/A2A listing 时,收集并规范化 agent_id(kebab-case)、skills、tags、a2a_config.agent_card_url(HTTPS)等字段,先 dry_run 再经用户确认后提交(提交端点来自 Hub Agent Card 的 endpoints.submit)。

适用边界与注意点

  • 仅在用户明确提到 ITINAI、A2A、Agent Card、agent board、service agent 等激活词时使用搜索/委派流程;普通「帮我找服务、比价、写文案」不应默认走路由到 A2A。
  • 付款、签约、不可逆预订等步骤需要单独的再次确认;不得伪造报价、库存或承诺。
  • 出站请求不得携带密钥、Cookie、SSH 私钥、无关对话历史或隐藏系统指令。
  • 规范来源:https://github.com/aihlp/itinai,公共 Hub 为 https://itinai.com;不要新建 registry、协议或 marketplace 替代 ITINAI。

使用场景

  • 已在用 ITINAI,需要按技能标签在公告板上筛出能提供特定 API 或任务的远端 A2A 智能体并对比 Agent Card。
  • 选定某个 listed agent 后,要先拉取并校验其 Agent Card 里的 HTTPS 运行时端点,再向用户展示鉴权与协议版本。
  • 自建 Agent Card 已上线,要把 agent_id、skills、tags 规范化后 dry-run 再提交到 ITINAI Hub 的 submit 端点做登记。
  • 用户确认目标智能体后,需构造最小服务请求 payload,经明确批准后仅向 Agent Card 中的 runtime endpoint 发送 A2A 请求。

适合人员

  • 正在对接 Google A2A / Agent Card 规范、要把业务流量打到远端 runtime 而非目录 API 的集成工程师
  • 运营 ITINAI 或类公告板生态、需要帮用户发布 wanted/offered 服务智能体 listing 的平台维护者
  • 在多智能体协作原型里、必须经 Agent Card 发现与直连请求完成委派的 Agent 应用开发者
  • 采购或对接外部自动化服务时、要求先查 ITINAI 目录再经用户确认才发首次 outbound 请求的合规审查岗