本文介绍调试Agent的操作步骤。 ## 前提操作已[通过控制台创建智能体运行时](https://www.volcengine.com/docs/86681/1844831)且状态为**运行中**。 ## 通过控制台调试功能 :::tip * 仅当**网络访问**选择**公网访问**时，才能使用调试功能。 * 若需在控制台调试已启用OAuth入站身份认证的智能体，请在[用户池](https://www.volcengine.com/docs/86848/1928256)创建**M2M类型客户端**。 ::: 单击目标智能体运行时操作列的“在线测试”按钮，指定请求方法、Headers、Body，然后单击“确定”，验证Agent是否正常工作。 |参数 |说明 |示例值 | |---|---|---| |请求方法 |支持Get、POST、PUT、DELETE、PATCH、HEAD、OPTIONS。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ba95fabcab32439ad555669cc94ce66b.png =254x) | |URL |系统自动生成的智能体公网访问域名，不支持修改。 |^^| |Headers |请求头。包括：|![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cbb3fe985cb450c2817990f16606785e.png =331x) |\ | || |\ | |* 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格式。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47864f9026c1d5f833d27d54362eccc3.png =267x) | 若调试结果回显以下类似信息，则表示Agent运行正常。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b2c460e2a80b4b5f8b0a4b4aee2ee0c7.png =704x) ## 通过`curl`命令创建成功后，智能体运行时将自动生成访问域名，如下图所示。您可通过`curl`命令指定域名发起POST请求，以此验证Agent是否正常工作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c97ed1f7938c903a1466aef9c551b821.png =633x) 本示例以查询天气为例，进行验证。 ```Bash curl -v -X POST http://sd3rltac7npja1818xxxx.apigateway-cn-beijing.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\-cn\-beijing.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