调用智能体运行时 - InvokeRuntime

agent_name

是

String

参数解释：

智能体运行时名称。

智能体运行时名称获取方式：

1. 进入AgentArts平台，在左侧导航栏选择“部署运行 > 智能体运行时 ”。

2. 在智能体运行时列表中“智能体运行时名称/ID”处获取智能体运行时名称。

约束限制:

不涉及。

取值范围：

以小写字母开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-48个字符。

默认取值:

不涉及。

endpoint

否

String

参数解释：

用于调用智能体运行时使用的访问方式名称，访问指定的智能体运行时版本。

获取访问方式名称请参考如下：

1. 进入AgentArts平台，在左侧导航栏选择“部署运行 > 智能体运行时 ”。

2. 单击已创建的智能体运行时名称，在“基本信息”页签下即可查看访问方式。

如未创建访问方式，则默认使用该运行时的Latest访问方式。

约束限制:

不涉及。

取值范围：

以字母开头，以字母或数字结尾，可以包含字母、数字和中划线，长度为2-48个字符。

默认取值:

Latest

X-Hw-Agentarts-Session-Id

是

String

参数解释：

会话ID，每个会话的唯一标识符。用户可将会话ID设置为任意字符串，例如“123e4567e89b12d3a456426614174000”，无需在其他地方获取。

约束限制:

不涉及。

取值范围：

由英文，数字，“-”，“_”组成，不超过64位字符。

默认取值:

不涉及。

X-Hw-Agentgateway-User-Id

否

String

参数解释：

本次智能体运行时调用对应的用户唯一ID，用于标识此次调用的用户身份，用户可将会话ID设置为任意字符串，例如“123e4567e89b12d3a456426614174000”，无需在其他地方获取。

约束限制:

不涉及。

取值范围：

由英文，数字，“-”，“_”组成，不超过128位字符。

默认取值:

不涉及。

Authorization

是

String

参数解释：

本次智能体运行时调用对应的身份认证凭据。需要根据实际的智能体运行时的入站身份认证方式获取对应的身份认证凭据。

API Key认证、IAM认证及OAuth 2.0认证具体请参见认证鉴权。

约束限制:

不涉及。

取值范围：

不超过4096位字符。

默认取值:

不涉及。

X-Sdk-Content-Sha256

否

String

参数解释：

如果智能体运行时的入站认证类型为IAM认证时，需要指定该Header头为UNSIGNED-PAYLOAD。

约束限制:

不涉及。

取值范围：

固定为UNSIGNED-PAYLOAD。

默认取值:

不涉及。

code

Integer

参数解释:

异常错误码。

取值范围:

不涉及。

message

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

code

Integer

参数解释:

异常错误码。

取值范围:

不涉及。

message

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

200

智能体调用成功的响应Body体。

401

未授权（认证令牌缺失、无效或已过期）。

500

服务器内部错误。