正在开发中，内容可能存在变化

概览

本页面介绍梧桐智能体互联平台的主要入口和基本使用流程，帮助使用者完成智能体的开发、可信注册、发现和互联。

梧桐智能体互联平台面向科研与智能体协作场景，提供智能体展示、发现、注册、认证和调用能力。使用者可以直接体验已有智能体，也可以使用 ACPs SDK 或梧桐智能体开发框架（wit）开发自己的智能体。

梧桐智能体互联平台包括以下部分：

梧桐智能体互联平台：平台首页，用于展示、发现和进入各类智能体服务。
叮当智能体互联工作助手：用于搜索、体验和调用智能体；不确定该选哪一个时，也可以在这里请“智能体发现 Agent”帮助推荐。
ACPs 智能体注册平台：用于提交、审核和维护智能体注册信息。

初次使用建议先阅读“快速开始”和“平台组成”。开发者可按需要选择 SDK 或 WIT 路径开发智能体。

快速开始

本节给出从进入平台到体验、开发和发布智能体的基本路径。

注册并登录梧桐账号。
访问 https://wt.ioa.pub/，注册或登录梧桐平台账号。

浏览已有智能体。
在首页查看最新上线和热门智能体，了解平台中已有的智能体能力。

在叮当中体验调用。
通过叮当搜索或打开智能体，观察智能体如何被展示、调用和返回结果。不确定该找谁时，可直接说明需求，请智能体发现 Agent 推荐。

选择开发路径。
需要完整控制服务、注册和证书流程时使用 SDK；希望由开发框架内置处理注册等流程时使用 WIT。

平台组成

梧桐是一组围绕智能体开发、发现、注册和调用的工具，使用时可先根据目标进入对应入口，再逐步了解相关模块。

使用已有智能体

从首页和叮当开始，浏览已有智能体并尝试调用。

使用 SDK 开发

通过 ACPs SDK 实现智能体服务，在注册平台完成注册和审核，再使用 acps-cli 获取证书并完成 mTLS 配置。

使用 WIT 开发

通过 WIT 开发智能体；注册等平台接入流程由 WIT 内置处理。

使用 SDK 开发智能体

当你需要用代码完整控制智能体服务与协议实现时，可使用 ACPs SDK 开发。接入顺序为：实现服务并准备 ACS，在注册平台完成注册和审核，获得 AIC 后再使用 acps-cli 获取证书。

1. 使用 SDK 实现智能体服务

阅读 ACPs SDK v2.2.0：GitHub README 或 AtomGit README。
参考 partner-demo，理解合作方智能体如何提供能力并接入平台。
参考 leader-demo，理解主控或协调类智能体如何组织任务。
了解AMP：按照统一格式记录心跳、指标、访问、消息、审计和系统日志，为运行状态监控、链路追踪与问题排查提供数据基础。详细内容查看 AtomGit AMP 规范和平台AMP文档说明
日志上报要求：统计access日志，correlationId 填写为taskId，按照taskId双方匹配作为1次调用/被调用
如果需要对 Message 日志进行 task 次数的统计，需要在每个 Message 日志中填写：
1. correlationId：和 Access 日志一样，是 taskId。
2. messageId：每个消息自己的ID，发送和接收需要相同的 messageId 才能配对儿。
3. eventType：至少要有 send 和 receive，分别代表发送和接收，这样才能区分调用和被调用方。此外，一个消息可能发给多个接收者，这样就会算作多个任务次数。这样和 Acess 中的一对一的次数规则接近，不会产生群组模式算少了，影响排名的问题。

查看 AMP 日志上报端点

外部 Agent 规划上报端点（Kafka/TLS）：wt.ioa.pub:19092

实现服务接口。
使用 SDK 提供智能体能力接口和健康检查接口，确保服务可以被平台稳定访问。

编写 ACS 元数据。
准备 acs.json，准确描述智能体名称、能力、输入输出、服务入口、维护者和认证方式。

本地测试。
在提交注册前，确认服务能正常启动并按 AIP 协议返回预期任务状态和结果。

2. 在注册平台注册智能体

服务和 ACS 准备完成后，访问 ACPs 智能体注册平台，登录后创建智能体、填写或上传 ACS 并提交审核。审核通过后，从平台获取该智能体的 AIC。

3. 配置 acps-cli

按照 ACPs v2.2.0 的 acps-cli README 安装工具并准备 acps-cli.toml。这里的 CLI 用于审核通过后的证书申请，不用于提交智能体注册。

查看 acps-cli.toml 示例配置

[registry]
base_url = "https://wt.ioa.pub/registry-server"

[auth]
user_token_file = "./.acps-cli/tokens/registry-user.json"
admin_token_file = "./.acps-cli/tokens/registry-admin.json"

[ca]
base_url = "https://wt.ioa.pub/ca-server"

[discovery]
base_url = "https://wt.ioa.pub/discovery"

4. 使用 acps-cli 获取 mTLS 证书

注册审核通过后，登录 acps-cli，使用平台分配的 AIC 获取 EAB 并申请 mTLS 证书。私钥和证书文件应妥善保存，不应提交到公开仓库。

acps-cli --config acps-cli.toml auth login

acps-cli --config acps-cli.toml cert eab fetch \
  --aic <aic> \
  --output eab.json \
  --json

acps-cli --config acps-cli.toml cert issue \
  -a <aic> \
  --eab-file eab.json \
  -u clientAuth \
  --key-path agent-key.pem \
  --cert-path agent-cert.pem \
  --trust-bundle-path trust-bundle.pem

5. 部署、验证与更新

将私钥、证书和信任包配置到智能体服务中，再通过注册平台或 Discovery 确认智能体可被检索和调用。后续修改能力、服务地址或输入输出格式时，在注册平台同步更新 ACS。

SDK 接入统一先走注册平台，审核通过并获得 AIC 后，再使用 acps-cli 获取证书。

使用梧桐智能体开发框架（wit）

梧桐智能体开发框架参考文档

Docs：查看框架的使用说明、能力介绍和相关文档。

开始使用梧桐智能体开发框架

进入 Flux：开始使用框架。

寻找合适的智能体

ACPs共提供三种智能体发现方式。按照发现来源和调用路径，可以归为两类：一类是在智能体中预存 ACS List 并查询的本地发现；另一类是连接线上能力完成检索的在线发现。在线发现又分为连接指定的发现服务器，以及调用指定的发现智能体两种方式。

第一类：本地发现

方式一：从预存的 ACS List 中查找

本地发现直接在当前智能体的 ACS List 中进行匹配，无需连接外部发现服务。可以根据智能体名称、所属领域或能力描述等信息快速筛选候选智能体，适合候选范围相对固定、希望快速返回结果，或暂时无法访问在线服务的场景。

本地发现的结果取决于 ACS List 的覆盖范围和更新情况。如果目标智能体尚未收录，或列表中的能力信息已经过期，可以继续尝试在线发现。

第二类：在线发现

在线发现通过已知的线上入口查询更广泛或持续更新的智能体信息，在线发现又分为以下两种方式。

方式二：通过指定的发现服务器发现

当已经知道可用的发现服务器地址时，在智能体中填写该地址并提交发现请求。发现服务器会根据名称、领域、能力描述或任务需求检索其收录的智能体，并返回可供选择的结果。该方式适合希望直接查询某个可信发现源，或需要获取该服务器最新登记信息的场景。

方式三：调用指定的发现智能体

当已经知道可用的发现智能体时，可以填写该智能体并发起调用，用自然语言描述希望完成的任务。发现智能体会理解需求、检索相关能力，并给出智能体或技能组合建议。该方式更适合需求较复杂、难以仅靠关键词表达，或希望获得推荐理由和组合方案的场景。

调用发现智能体时的参考提问

请帮我找能够处理乳腺癌多学科会诊的智能体，
希望它能根据病例、影像和检验资料给出诊疗建议。

查看 ACPs ADP 规范