本文介绍基于URL嵌入Prompt的Agent纯文本调试方法。 ## 前提条件已[通过控制台创建智能体运行时](https://www.volcengine.com/docs/86681/1844831)且状态为**运行中**。 ## 通过控制台调试功能

说明

仅当网络访问选择公网访问时，才支持使用在线调试功能。

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

ChatUI（智能对话界面）在线测试方式，仅对应用广场一键部署的部分应用提供支持。详情请参见调试Agent应用。

单击目标智能体运行时操作列的“在线测试”按钮，指定请求方法、Headers、Body，然后单击“确定”，验证Agent是否正常工作。 |参数 |说明 |示例值 | |---|---|---| |请求方法 |支持Get、POST、PUT、DELETE、PATCH、HEAD、OPTIONS。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ba95fabcab32439ad555669cc94ce66b.png) | |URL |平台自动生成的智能体公网访问域名，不支持修改。 || |Headers |请求头。包括：

* Content\-Type：声明请求体格式。默认值：application/json。

* Authorization：入站身份验证。即创建智能体运行时配置的入站身份验证的API Key或OAuth JWT。默认使用API Key。

* session_id：自定义会话标识请求头，用于标记当前用户的会话。默认值：defaultSession。

* user_id：自定义会话标识请求头，用于标记发起请求的用户身份。默认值：defaultUser。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cbb3fe985cb450c2817990f16606785e.png)

| |Body |请求体，支持raw、form\-data、x\-www\-form\-urlencoded格式。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47864f9026c1d5f833d27d54362eccc3.png)

| 若调试结果回显以下类似信息，则表示Agent运行正常。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b2c460e2a80b4b5f8b0a4b4aee2ee0c7.png) ## 通过`invoke`命令创建成功后，您可以通过`agentkit invoke`命令向Agent发送测试请求，验证功能是否正常。 * 使用方法 ```Bash agentkit invoke [消息内容] [选项] ``` * 示例 ```Bash agentkit invoke "今天杭州天气如何？" ``` 若回显以下信息，则表示调用成功。 ```Bash 💬 正在调用 Agent... ✅ Runtime ID: r-xxxxxx 🌐 调用地址: http://xxxx.apigateway-xxxx.volceapi.com ✅ 调用成功！ 📡 Agent 响应: 杭州今天天气晴，温度 22°C，适合出行。 ``` ## 通过`curl`命令创建成功后，智能体运行时将自动生成访问域名，如下图所示。您可通过`curl`命令指定域名发起POST请求，以此验证Agent是否正常工作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d639a1eb72be7c4934c3c79308ab93f.png) 本示例以查询天气为例，进行验证。 ```Bash curl -v -X POST http://sd3rltac7npja1818xxxx.apigateway-xxxx.volceapi.com/invoke \ -H "Authorization: Bearer 6-CVnQDrvNM4iYRLTsw8mPe4RerrQnOq****" \ -H "Content-Type: application/json" \ -H "user_id: 123" \ -H "session_id: 123" \ -d '{"prompt": "武汉天气怎么样"}' ``` 参数说明如下表所示，请根据实际值替换。 |参数 |说明 | |---|---| |\-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格式数据。 | 若回显以下信息，则表示调用成功。 ```JSON { "code": 200, "message": "success", "data": { "city": "武汉", "date": "2025-10-22", "weather": "阴转小雨", "temperature": { "min": 16, "max": 22, "unit": "℃" } ``` ###

AgentKit