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

# 自定义集成

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

## 何时使用它

内置目录覆盖 90 种服务（参见[集成指南](/zh/docs/guides/integrations-guide)）。对于其他任何情况——内部 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 主机**：该集成被允许访问的主机名，支持通配符，与每个内置集成相同的出站模型。
- **验证**：在连接时调用的一个端点，用于在集成被视为已连接之前确认成员的凭证确实有效。

## 草稿与发布

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

## 相同的安全保障

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

## 相关内容

- [集成指南](/zh/docs/guides/integrations-guide)：这一功能所扩展的 90 种内置集成
- [安全](/zh/docs/guides/security)：每个集成（无论内置还是自定义）所运作的边界