发现
get_api_document加载当前任务所需的确切 API 契约。
将产品的核心操作开放为 API,把相关文档附加到聊天中,AgentChat 就能将它们转化为智能体能力。无需为每项功能单独集成自定义工具。
POST/storiesPOST/imagesGET/documents/searchget_api_document()
http_request()
sleep()
view_image()
核心理念
传统智能体需要为每个操作定义自定义工具。AgentChat 使用 API 文档和通用 HTTP 执行器,因此能力会随着 API 覆盖范围扩展,而不是随着智能体代码扩展。
get_api_document加载当前任务所需的确切 API 契约。
http_request调用任何有文档说明的 HTTP 端点,并接收结构化结果。
sleep在创建异步任务与轮询状态之间暂停。
view_image检查创意或媒体 API 返回的图片 URL。
集成模型
你的 API 是围绕产品现有操作构建的受控封装。智能体调用这些 API;你的 SaaS 读取同一个数据库,并以自然的方式呈现结果。
注册封装产品数据库和业务操作的 API。它们将成为智能体可用的能力。
仅附加该聊天所需的文档,选择其模型,并为当前用户或租户添加请求头。
智能体通过你的 API 运行。你的应用读取自身的数据库,并像往常一样显示新创建或更新的数据。
真实产品模式
创建聊天时,附加一份搜索 API 文档。智能体可以检索相关段落,对其进行推理,并利用应用的私有知识回答问题。
GET /documents/search?q=...
→ {
"results": [
{ "text": "...", "source": "..." }
]
} 提供故事写作 API 和图像生成 API。智能体编写章节,根据提示生成插图,通过你的 API 保存这两类内容,而你的故事应用则从自有数据库中展示它们。
面向租户的安全性
为每个聊天配置特定主机的请求头。你的 API 接收当前用户或租户的凭证,应用自身的授权规则,并仅返回该用户有权访问的数据。
X-Tenant-ID: tenant_a只能搜索和修改租户 A 的数据。
X-Tenant-ID: tenant_b使用相同的 API 契约,但遵循租户 B 的权限。
AgentChat