# 连接工具、技能和通道

创建、测试和维护通道实例、连接、技能与工具，并确认它们是否被智能体引用。本页不负责将这些对象绑定到智能体资源配置。

## 前提条件

准备可访问目标工作区的凭据，以及目标智能体或外部服务所需的信息。有关服务地址、认证和通用请求格式，请参阅 [调用前准备](../../api-call-basics.md)。

更新、删除或测试前，先从相应列表中取得目标对象标识。创建连接或工具后，应通过详情或列表确认对象，再继续引用或绑定。

## 调用顺序

1. 根据接入目标，先创建或测试未保存的通道配置，或创建和探测连接。
2. 确认通道或连接后，创建、导入或更新技能与工具；需要 MCP 工具时先确认连接再批量创建。
3. 查询对象详情、版本、文件和引用智能体，确认当前可用对象和依赖关系。
4. 删除连接、工具、技能或通道前，先查询其引用关系，并在对应动作页确认影响和条件。

## API 操作

### 管理通道实例

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建通道实例 | [创建通道实例](../../../../reference/api/ai-studio/agents/channel-instances/create-channel-instance.md) | 需要新建通道实例时使用。 |
| 查询通道实例列表 | [查询通道实例列表](../../../../reference/api/ai-studio/agents/channel-instances/list-channel-instances.md) | 选择或确认目标通道时使用。 |
| 查询通道实例详情 | [查询通道实例详情](../../../../reference/api/ai-studio/agents/channel-instances/get-channel-instance.md) | 更新、测试或删除前确认通道时使用。 |
| 更新通道实例 | [更新通道实例](../../../../reference/api/ai-studio/agents/channel-instances/update-channel-instance.md) | 已取得通道标识，需要修改时使用。 |
| 测试未保存的通道配置 | [测试未保存的通道配置](../../../../reference/api/ai-studio/agents/channel-instances/test-new-channel-configuration.md) | 创建前验证待提交配置时使用。 |
| 测试已创建的通道实例 | [测试已创建的通道实例](../../../../reference/api/ai-studio/agents/channel-instances/test-channel-instance.md) | 已创建后验证目标通道时使用。 |
| 删除通道实例 | [删除通道实例](../../../../reference/api/ai-studio/agents/channel-instances/delete-channel-instance.md) | 删除前先在动作页确认影响和条件。 |

### 管理连接和 MCP 工具

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建连接 | [创建连接](../../../../reference/api/ai-studio/agents/connections/create-connection.md) | 需要新的智能体连接时使用。 |
| 查询连接列表 | [查询连接列表](../../../../reference/api/ai-studio/agents/connections/list-connections.md) | 选择或确认目标连接时使用。 |
| 查询连接详情 | [查询连接详情](../../../../reference/api/ai-studio/agents/connections/get-connection.md) | 更新或探测前确认连接时使用。 |
| 更新连接 | [更新连接](../../../../reference/api/ai-studio/agents/connections/update-connection.md) | 已取得连接标识，需要修改时使用。 |
| 探测 MCP 连接 | [探测 MCP 连接](../../../../reference/api/ai-studio/agents/connections/probe-mcp-connection.md) | 创建或更新后检查 MCP 连接时使用。 |
| 批量创建 MCP 工具 | [批量创建 MCP 工具](../../../../reference/api/ai-studio/agents/connections/batch-create-mcp-tools.md) | 已确认 MCP 连接，需要创建工具时使用。 |

### 管理技能

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建技能 | [创建技能](../../../../reference/api/ai-studio/agents/skills/create-skill.md) | 需要新建技能时使用。 |
| 导入技能包 | [导入技能包](../../../../reference/api/ai-studio/agents/skills/import-skill-package.md) | 已准备技能包，需要导入时使用。 |
| 检查技能包 | [检查技能包](../../../../reference/api/ai-studio/agents/skills/inspect-skill-package.md) | 导入前检查技能包时使用。 |
| 流式润色技能草稿 | [AI 生成技能](../../../../reference/api/ai-studio/agents/skills/polish-skill-stream.md) | 需要处理技能草稿时使用。 |
| 查询技能列表 | [查询技能列表](../../../../reference/api/ai-studio/agents/skills/list-skills.md) | 选择或确认技能时使用。 |
| 查询技能详情 | [查询技能详情](../../../../reference/api/ai-studio/agents/skills/get-skill.md) | 更新或设置版本前确认技能时使用。 |
| 更新技能 | [更新技能](../../../../reference/api/ai-studio/agents/skills/update-skill.md) | 已取得技能标识，需要修改时使用。 |
| 查询技能版本 | [查询技能版本](../../../../reference/api/ai-studio/agents/skills/list-skill-versions.md) | 选择技能版本时使用。 |
| 设置当前技能版本 | [设置当前技能版本](../../../../reference/api/ai-studio/agents/skills/set-current-skill-version.md) | 需要切换当前版本时使用。 |
| 查询技能文件 | [查询技能文件](../../../../reference/api/ai-studio/agents/skills/list-skill-files.md) | 查看技能文件时使用。 |
| 下载技能文件 | [下载技能文件](../../../../reference/api/ai-studio/agents/skills/download-skill-file.md) | 需要取得技能文件时使用。 |
| 查询技能标签 | [查询技能标签](../../../../reference/api/ai-studio/agents/skills/list-skill-tags.md) | 按标签了解技能时使用。 |
| 执行技能 | [执行技能](../../../../reference/api/ai-studio/agents/skills/execute-skill.md) | 需要执行目标技能时使用。 |
| 查询引用该技能的智能体 | [查询引用该技能的智能体](../../../../reference/api/ai-studio/agents/skills/list-referencing-agents.md) | 更新或删除前确认技能引用时使用。 |

### 管理工具和工具连接

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建工具 | [创建工具](../../../../reference/api/ai-studio/agents/tools/create-tool.md) | 需要新建工具时使用。 |
| 查询工具列表 | [查询工具列表](../../../../reference/api/ai-studio/agents/tools/list-tools.md) | 选择或确认工具时使用。 |
| 查询工具详情 | [查询工具详情](../../../../reference/api/ai-studio/agents/tools/get-tool.md) | 更新或删除前确认工具时使用。 |
| 更新工具 | [更新工具](../../../../reference/api/ai-studio/agents/tools/update-tool.md) | 已取得工具标识，需要修改时使用。 |
| 查询工具标签 | [查询工具标签](../../../../reference/api/ai-studio/agents/tools/list-tool-tags.md) | 按标签了解工具时使用。 |
| 查询引用该工具的智能体 | [查询引用该工具的智能体](../../../../reference/api/ai-studio/agents/tools/list-referencing-agents.md) | 删除前确认工具引用时使用。 |
| 保存 GitHub 工具连接 | [保存 GitHub 工具连接](../../../../reference/api/ai-studio/agents/tools/connect-github.md) | 配置 GitHub 工具连接时使用。 |
| 查询 GitHub 工具连接 | [查询 GitHub 工具连接](../../../../reference/api/ai-studio/agents/tools/get-github-connection.md) | 确认 GitHub 工具连接时使用。 |
| 删除 GitHub 工具连接 | [删除 GitHub 工具连接](../../../../reference/api/ai-studio/agents/tools/disconnect-github.md) | 删除前先确认目标连接时使用。 |
| 保存 Grafana 工具连接 | [保存 Grafana 工具连接](../../../../reference/api/ai-studio/agents/tools/connect-grafana.md) | 配置 Grafana 工具连接时使用。 |
| 查询 Grafana 工具连接 | [查询 Grafana 工具连接](../../../../reference/api/ai-studio/agents/tools/get-grafana-connection.md) | 确认 Grafana 工具连接时使用。 |
| 删除 Grafana 工具连接 | [删除 Grafana 工具连接](../../../../reference/api/ai-studio/agents/tools/disconnect-grafana.md) | 删除前先确认目标连接时使用。 |
| 保存邮件工具连接 | [保存邮件工具连接](../../../../reference/api/ai-studio/agents/tools/connect-mail.md) | 配置邮件工具连接时使用。 |
| 查询邮件工具连接 | [查询邮件工具连接](../../../../reference/api/ai-studio/agents/tools/get-mail-connection.md) | 确认邮件工具连接时使用。 |
| 删除邮件工具连接 | [删除邮件工具连接](../../../../reference/api/ai-studio/agents/tools/disconnect-mail.md) | 删除前先确认目标连接时使用。 |
| 生成企业微信回调密钥 | [生成企业微信回调密钥](../../../../reference/api/ai-studio/agents/tools/generate-wecom-callback-secrets.md) | 配置企业微信回调所需密钥时使用。 |

## 结果确认

创建、更新或测试后，使用相应详情或列表动作确认对象。需要确认删除影响时，先查询[查询引用该技能的智能体](../../../../reference/api/ai-studio/agents/skills/list-referencing-agents.md)或[查询引用该工具的智能体](../../../../reference/api/ai-studio/agents/tools/list-referencing-agents.md)。

## 限制和注意事项

删除通道、工具连接或已被引用的对象可能影响相关智能体。执行前请在对应动作页确认条件和结果。

## 下一步

- [绑定知识库、工作流和资源](knowledge-workflow-resource-bindings.md)
- [创建和维护智能体](agents.md)