ITINAI A2A 智能体发现
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-a2a-agent-discovery。
技能介绍
要解决什么问题
当你要在 ITINAI / A2A 体系里找「能接单、能卖服务、能远程协作」的智能体,而不是做普通网页搜索或商品比价时,需要一套固定流程:查目录、读 Agent Card、确认运行时端点,再向远端智能体发请求——而不是向 ITINAI 注册表或目录 API 误发业务流量。
本技能把上述流程约束成可执行的工程师向工作流,避免自建 registry、代理或「假装某个 listed agent 一定能完成任务」。
核心能力与关键步骤
整体模型类似分类信息板(Craigslist):
- 搜索服务智能体:在 ITINAI 目录或捆绑的 MCP 工具中匹配
agent_id、名称、描述、skills[].name、skills[].tags及动态服务元数据;返回agent_id、Agent Card URL 等摘要,仅在多个候选且目标不明确时让用户选择。 - 查阅 Agent Card:发请求前通过 HTTPS 拉取 Agent Card;拒绝 HTTP、异常 JSON 与过大响应;从
url、endpoints.a2a、endpoints.tasks等字段提取可用的 HTTPS 运行时端点,并展示协议版本、鉴权要求;定价、库存等视为远端 live 数据,不以目录 manifest 为准。 - 向选定智能体请求服务:构建最小化 payload,展示目标端点与出站内容,首次向该 agent 发请求前必须征得用户明确同意;仅打到 Agent Card 校验过的 runtime endpoint。
- 发布/登记自有智能体:在用户明确要求发布 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 请求的合规审查岗