文档中心

AgentKit

调用Agent

文本指令调用示例（prompt）

本文介绍如何通过控制台在线测试、AgentKit CLI 和 curl 命令，向 Agent 发送 prompt 文本指令并验证响应结果。适用于创建智能体运行时后，快速检查 Agent 是否能正常接收请求并返回预期结果的场景。

前提条件

已创建智能体运行时且状态为运行中。

通过控制台调试功能

说明

基于 OAuth 入站身份认证创建的智能体运行时，仅支持 M2M 类型客户端进行在线测试，其他客户端类型不支持在线测试。若创建智能体运行时时，未指定客户端类型，可前往用户池创建 M2M 类型客户端后，进行在线测试。

单击目标智能体运行时操作列的“在线测试”按钮，指定请求方法、Headers、Body，然后单击“确定”，验证 Agent 是否正常工作。

参数	说明	示例值
请求方法	支持 Get、POST、PUT、DELETE、PATCH、HEAD、OPTIONS。
URL	平台自动生成的智能体公网访问域名，不支持修改。
Headers	请求头。包括： Content-Type：声明请求体格式。默认值：application/json。 Authorization：入站身份验证。即创建智能体运行时配置的入站身份验证的 API Key 或 OAuth JWT。默认使用 API Key。 session_id：自定义会话标识请求头，用于标记当前用户的会话。默认值：defaultSession。 user_id：自定义会话标识请求头，用于标记发起请求的用户身份。默认值：defaultUser。
Body	请求体，支持 raw、form-data、x-www-form-urlencoded 格式。 raw（默认）：自定义原始请求报文，支持 JSON、文本、XML 等多种自定义负载，当前接口推荐使用 JSON (raw)。 form‑data：支持文本字段与二进制文件上传，适用于图片、附件上传场景。 x‑www‑form‑urlencoded：标准表单格式，用于传递简单键‑值参数，不支持文件上传。

查看调试结果，确认状态码为 200，并验证返回内容符合预期。

通过invoke命令

创建成功后，您可以通过agentkit invoke命令向 Agent 发送测试请求，验证功能是否正常。

通过curl命令

创建成功后，智能体运行时将自动生成访问域名，如下图所示。您可通过curl命令指定域名发起 POST 请求，以此验证 Agent 是否正常工作。

本示例以查询天气为例，进行验证。

参数说明如下表所示，请根据实际值替换。

参数	说明
-X POST	指定 HTTP 请求方法为 POST。
http://sd3rltac7npja1818xxxx.apigateway-xxxx.volceapi.com/invoke	智能体运行时公网访问域名。
-H "Authorization: Bearer 6-CVnQDrvNM4iYRLTsw8mPe4RerrQnOq****"	入站身份验证。即创建智能体运行时配置的入站身份验证的API Key 或 OAuth JWT。本示例使用 API Key。
-H "Content-Type: application/json"	声明请求体格式。本示例指定为 JSON 格式。
-H "user_id: 123"	自定义用户标识请求头，用于标记发起请求的用户身份。
-H "session_id: 123"	自定义会话标识请求头，用于标记当前用户的会话。
-d '{"prompt": "武汉天气怎么样"}'	POST 请求体，包含 JSON 格式数据。

若回显以下信息，则表示调用成功。

最近更新时间：2026.10.19 14:28:33

这个页面对您有帮助吗？

有用

无用