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 Make your first AI Studio API call.

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

Task

Use it when

Create a channel instance

You need a new channel instance.

List channel instances

You need to select or confirm a target channel.

Get channel instance details

You need to confirm a channel before updating, testing, or deleting it.

Update a channel instance

You have the channel ID and need to change it.

Test an unsaved channel configuration

You need to validate a proposed configuration before creating it.

Test a created channel instance

You need to validate an existing channel.

Delete a channel instance

You checked the operation page for its impact and conditions.

Manage connections and MCP tools

Task

Use it when

Create a connection

You need a new agent connection.

List connections

You need to select or confirm a target connection.

Get connection details

You need to confirm a connection before updating or probing it.

Update a connection

You have the connection ID and need to change it.

Probe an MCP connection

You need to check an MCP connection after creating or updating it.

Batch-create MCP tools

You confirmed an MCP connection and need to create tools.

Manage skills

Task

Use it when

Create a skill

You need a new skill.

Import a skill package

You have a skill package to import.

Inspect a skill package

You need to inspect a skill package before importing it.

Polish a skill draft with streaming output

You need to process a skill draft.

List skills

You need to select or confirm a skill.

Get skill details

You need to confirm a skill before updating it or setting its version.

Update a skill

You have the skill ID and need to change it.

List skill versions

You need to choose a skill version.

Set the current skill version

You need to switch the current version.

List skill files

You need to inspect skill files.

Download a skill file

You need to obtain a skill file.

List skill tags

You need to understand skills by tag.

Execute a skill

You need to run a target skill.

List agents that reference a skill

You need to check skill references before updating or deleting it.

Manage tools and tool connections

Task

Use it when

Create a tool

You need a new tool.

List tools

You need to select or confirm a tool.

Get tool details

You need to confirm a tool before updating or deleting it.

Update a tool

You have the tool ID and need to change it.

List tool tags

You need to understand tools by tag.

List agents that reference a tool

You need to check tool references before deleting it.

Save a GitHub tool connection

You need to configure a GitHub tool connection.

Get a GitHub tool connection

You need to confirm a GitHub tool connection.

Delete a GitHub tool connection

You need to remove a confirmed GitHub connection.

Save a Grafana tool connection

You need to configure a Grafana tool connection.

Get a Grafana tool connection

You need to confirm a Grafana tool connection.

Delete a Grafana tool connection

You need to remove a confirmed Grafana connection.

Save a mail tool connection

You need to configure a mail tool connection.

Get a mail tool connection

You need to confirm a mail tool connection.

Delete a mail tool connection

You need to remove a confirmed mail connection.

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

Last updated on