集成与 API
你可以从自己的脚本或服务连接 DesireCore，验证连接、执行对话、从外部事件触发智能体，或接入模型代理和工作流。先取得对应服务的地址与凭据，再根据用途选择指南。
选择接入方式
| 你想做什么 | 所需条件 | 阅读指南 |
|---|---|---|
| 用自己的程序连接实例 | 管理员提供 HTTPS 地址和实例访问令牌 | 连接与认证 |
| 提交对话并观察结果 | 实例所有者访问权限、Agent ID；运行示例需要 Node.js 22+ | 对话与 Run |
| 从外部事件触发智能体 | 已启用事件和 Agent 级 Webhook secret；所有者配置需服务支持 webhookManagement | Agent Webhook |
| 通过本机代理调用模型协议 | 正在运行的本机代理和绑定供应商的安全 token | 模型代理 |
| 触发现有工作流 | 独立 Workflow Service 地址、服务令牌和管理员提供的定义 | 工作流集成 |
| 将 HTTP 合同导入工具 | 选择对应服务的规范文件 | OpenAPI 下载 |
| 让 DesireCore 调用你的业务服务 | 通过 MCP、工具或技能连接 | MCP 服务器连接与集成能力概览 |
凭据与结果
Agent Service 使用 X-Agent-Service-Token，外部 Webhook 使用 Authorization: Bearer <Webhook secret>。模型代理和 Workflow Service 各有独立凭据与权限范围；模型供应商 API Key 不能代替实例访问令牌。
握手的 200 证明该次请求已通过认证。对话提交的 202 和 Webhook 的 200 accepted 表示接纳或接收，应按对应指南观察完成与交付。对话事件使用 Socket.IO，工作流进度使用 SSE。
开始接入
- 向管理员取得实际服务地址与对应凭据。远程调用使用经过证书验证的 HTTPS 地址。
- 完成连接验证或所选指南中的最小示例。
- 检查实际响应与结果交付。遇到失败时参见错误与排查。
文档地址与实例地址
https://docs.desirecore.com/api 是文档页面。调用接口时，使用你自己的实例地址，例如 https://agent.example.com。