跳至内容
HeartBeatAgents

自定义集成

以 Markdown 查看

为内部 API 或任何不在内置目录中的提供商定义你自己的集成,享有与默认提供的 90 种集成相同的安全保障。

何时使用它

内置目录覆盖 90 种服务(参见集成指南)。对于其他任何情况——内部 API、小众供应商、还没有人构建过的提供商——不必等待官方支持上线,而是定义一个自定义集成。从设置 → 自定义集成为你的组织开启此功能;默认是关闭的。

从 curl 命令导入

最快的方式:直接从提供商自己的文档中粘贴一条可用的 curl 命令。向导会为你检测认证方式、请求头和基础 URL,让你审核而不是重新输入。

手动构建

  • 基础信息:一个 ID、显示名称、类别、描述,以及它声明的能力,以便智能体能够判断何时应该使用它。
  • 身份验证:一个 API 密钥(作为 Bearer 令牌、自定义请求头、查询参数,或 HTTP Basic)或 OAuth 2.0,包括为要求 PKCE 的提供商(Twitter/X 风格)提供 PKCE,以及为在刷新令牌前设置门槛的提供商提供额外的授权参数(Google 的 access_type=offline、Reddit 的 duration=permanent)。
  • 字段:连接的成员所提供的凭证。每个字段默认在静态时加密;将某个字段标记为非机密(例如明文的账户 ID 或区域)仅在该字段明显不是凭证时才被允许。名称类似 token、secret、key、password 或 credential 的字段会被阻止这样分类,除非明确覆盖。
  • API 主机:该集成被允许访问的主机名,支持通配符,与每个内置集成相同的出站模型。
  • 验证:在连接时调用的一个端点,用于在集成被视为已连接之前确认成员的凭证确实有效。

草稿与发布

新的集成会保存为草稿,对任何智能体都不可见,直到你发布它。发布会使其出现在设置 → 集成中供成员连接各自的凭证,并为已绑定的智能体授予访问权限。取消发布会重新隐藏它而不删除任何内容:已连接的加密凭证会被保留,因此重新发布可以恢复访问,而不必从头开始。

相同的安全保障

自定义集成继承内置集成所拥有的一切:按行加密的凭证、凭证代理、出站允许列表、按智能体绑定,以及相同的审计跟踪。定义你自己的集成并不意味着走出平台的安全模型,而是将其扩展到多一个服务。

相关内容

  • 集成指南:这一功能所扩展的 90 种内置集成
  • 安全:每个集成(无论内置还是自定义)所运作的边界