文档中心

AgentKit

请输入

调用Agent

文本指令调用示例（prompt）

本文介绍基于URL嵌入Prompt的Agent纯文本调试方法。

前提条件

已通过控制台创建智能体运行时且状态为运行中。

通过控制台调试功能

说明

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

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

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

单击目标智能体运行时操作列的“在线测试”按钮，指定请求方法、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格式。

若调试结果回显以下类似信息，则表示Agent运行正常。

通过invoke命令

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

使用方法

agentkit invoke [消息内容] [选项]

示例

agentkit invoke "今天杭州天气如何？"

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

💬 正在调用 Agent...
✅ Runtime ID: r-xxxxxx
🌐 调用地址: http://xxxx.apigateway-xxxx.volceapi.com
✅ 调用成功！

📡 Agent 响应:
杭州今天天气晴，温度 22°C，适合出行。

通过curl命令

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

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

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格式数据。

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

{​
  "code": 200,​
  "message": "success",​
  "data": {​
    "city": "武汉",​
    "date": "2025-10-22",​
    "weather": "阴转小雨",​
    "temperature": {​
      "min": 16,​
      "max": 22,​
      "unit": "℃"​
    }​

最近更新时间：2026.08.28 17:46:26

这个页面对您有帮助吗？

有用

无用