# 调用智能体和管理会话

从 MCP 客户端或其他智能体调用智能体，并创建、查询和更新调用会话。本页不配置智能体自身、模型或工具。

## 前提条件

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

调用前可获取智能体调用说明；需要持久化或维护会话时，创建会话后保留会话标识。

## 调用顺序

1. 先[获取智能体调用说明](../../../../reference/api/ai-studio/agents/agent-invocation/get-agent-card.md)，确认目标智能体的调用信息。
2. 根据调用方选择从 MCP 客户端或由其他智能体调用。
3. 需要单独管理上下文时创建会话，并保留会话标识以查询、更新或读取消息。
4. 调用或更新后，查询会话详情和消息确认可观察的会话结果。

## API 操作

### 获取调用信息并调用智能体

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 获取智能体调用说明 | [获取智能体调用说明](../../../../reference/api/ai-studio/agents/agent-invocation/get-agent-card.md) | 调用前确认目标智能体的调用信息时使用。 |
| 从 MCP 客户端调用 | [从 MCP 客户端调用](../../../../reference/api/ai-studio/agents/agent-invocation/call-agent-from-mcp-client.md) | 调用方为 MCP 客户端时使用。 |
| 由其他智能体调用 | [由其他智能体调用](../../../../reference/api/ai-studio/agents/agent-invocation/call-agent-from-agent.md) | 调用方为其他智能体时使用。 |

### 创建和维护会话

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建会话 | [创建会话](../../../../reference/api/ai-studio/agents/agent-sessions/create-session.md) | 需要会话标识来持续管理上下文时使用。 |
| 查询会话列表 | [查询会话列表](../../../../reference/api/ai-studio/agents/agent-sessions/list-sessions.md) | 选择或确认目标会话时使用。 |
| 查询会话详情 | [查询会话详情](../../../../reference/api/ai-studio/agents/agent-sessions/get-session.md) | 查看单个会话当前信息时使用。 |
| 查询会话消息 | [查询会话消息](../../../../reference/api/ai-studio/agents/agent-sessions/list-session-messages.md) | 查看会话中的消息时使用。 |
| 更新会话 | [更新会话](../../../../reference/api/ai-studio/agents/agent-sessions/update-session.md) | 已取得会话标识，需要修改会话时使用。 |

## 结果确认

调用后的具体结果以调用动作页为准。创建或更新会话后，使用[查询会话详情](../../../../reference/api/ai-studio/agents/agent-sessions/get-session.md)和[查询会话消息](../../../../reference/api/ai-studio/agents/agent-sessions/list-session-messages.md)确认会话内容。

## 下一步

- [创建和维护智能体](agents.md)
- [监测运行与处理反馈](runtime-observability-feedback.md)