Connect tools, skills, and channels

Create, test, and maintain channel instances, connections, skills, and tools, and confirm whether agents reference them. This page does not bind these objects to agent resource configurations.

Prerequisites

Prepare credentials that can access the target workspace and the information required by the target agent or external service. For service endpoints, authentication, and general request formats, see Prepare to call an API.

Before updating, deleting, or testing an object, obtain its ID from the corresponding list. After creating a connection or tool, confirm it through its details or list before referencing or binding it.

Call sequence

1. For the integration target, create or test an unsaved channel configuration, or create and probe a connection.

2. After confirming the channel or connection, create, import, or update skills and tools. For MCP tools, confirm the connection before batch creation.

3. Query object details, versions, files, and referencing agents to confirm available objects and dependencies.

4. Before deleting a connection, tool, skill, or channel, query its references and check the relevant operation page for impact and conditions.

API operations

Manage channel instances

What you need to do	API operation	Use it when
Create a channel instance	Create a channel instance	You need a new channel instance.
List channel instances	List channel instances	You need to select or confirm a target channel.
Get channel instance details	Get channel instance	You need to confirm a channel before updating, testing, or deleting it.
Update a channel instance	Update a channel instance	You have the channel ID and need to change it.
Test an unsaved channel configuration	Test a new channel configuration	You need to validate a proposed configuration before creating it.
Test a created channel instance	Test a channel instance	You need to validate an existing channel.
Delete a channel instance	Delete a channel instance	You checked the operation page for its impact and conditions.

Manage connections and MCP tools

What you need to do	API operation	Use it when
Create a connection	Create a connection	You need a new agent connection.
List connections	List connections	You need to select or confirm a target connection.
Get connection details	Get a connection	You need to confirm a connection before updating or probing it.
Update a connection	Update a connection	You have the connection ID and need to change it.
Probe an MCP connection	Probe an MCP connection	You need to check an MCP connection after creating or updating it.
Batch-create MCP tools	Batch-create MCP tools	You confirmed an MCP connection and need to create tools.

Manage skills

What you need to do	API operation	Use it when
Create a skill	Create a skill	You need a new skill.
Import a skill package	Import a skill package	You have a skill package to import.
Inspect a skill package	Inspect a skill package	You need to inspect a skill package before importing it.
Polish a skill draft with streaming output	Generate a skill with AI	You need to process a skill draft.
List skills	List skills	You need to select or confirm a skill.
Get skill details	Get a skill	You need to confirm a skill before updating it or setting its version.
Update a skill	Update a skill	You have the skill ID and need to change it.
List skill versions	List skill versions	You need to choose a skill version.
Set the current skill version	Set the current skill version	You need to switch the current version.
List skill files	List skill files	You need to inspect skill files.
Download a skill file	Download a skill file	You need to obtain a skill file.
List skill tags	List skill tags	You need to understand skills by tag.
Execute a skill	Execute a skill	You need to run a target skill.
List agents that reference a skill	List agents that reference a skill	You need to check skill references before updating or deleting it.

Manage tools and tool connections

What you need to do	API operation	Use it when
Create a tool	Create a tool	You need a new tool.
List tools	List tools	You need to select or confirm a tool.
Get tool details	Get a tool	You need to confirm a tool before updating or deleting it.
Update a tool	Update a tool	You have the tool ID and need to change it.
List tool tags	List tool tags	You need to understand tools by tag.
List agents that reference a tool	List agents that reference a tool	You need to check tool references before deleting it.
Save a GitHub tool connection	Connect GitHub	You need to configure a GitHub tool connection.
Get a GitHub tool connection	Get GitHub connection	You need to confirm a GitHub tool connection.
Delete a GitHub tool connection	Disconnect GitHub	You need to remove a confirmed GitHub connection.
Save a Grafana tool connection	Connect Grafana	You need to configure a Grafana tool connection.
Get a Grafana tool connection	Get Grafana connection	You need to confirm a Grafana tool connection.
Delete a Grafana tool connection	Disconnect Grafana	You need to remove a confirmed Grafana connection.
Save a mail tool connection	Connect mail	You need to configure a mail tool connection.
Get a mail tool connection	Get mail connection	You need to confirm a mail tool connection.
Delete a mail tool connection	Disconnect mail	You need to remove a confirmed mail connection.
Generate WeCom callback secrets	Generate WeCom callback secrets	You need the secrets required to configure a WeCom callback.

Confirm the result

After creating, updating, or testing an object, use its corresponding details or list operation to confirm it. To assess deletion impact, first query agents that reference the skill or agents that reference the tool.

Limitations and notes

Deleting channels, tool connections, or referenced objects may affect related agents. Check the relevant operation page for conditions and results before proceeding.

Next steps

• Bind knowledge bases, workflows, and resources

• Create and maintain agents

Last updated on Sep 3, 2026