DebugModel - 调试模型-智能体构建和治理平台 AgentCore-阿里云帮助中心

通过已发布的模型连接调用指定模型，用于验证模型调用链路是否可用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /workspaces/{workspaceId}/models/{modelId}/actions/debug HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	是	工作空间 ID。	ws-1
modelId	string	是	模型 ID。	model-1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体。
prompt	string	是	用于验证模型调用链路的提示词。	hello

返回参数

名称	类型	描述	示例值
	object	模型调试成功时返回的模型文本响应；调试失败时为空。
requestId	string	请求 ID。	request-1
message	string	请求处理结果消息。	success
httpStatusCode	integer	HTTP 状态码。成功时为 200。	200
code	string	业务状态码。成功时为 SUCCESS。	SUCCESS
success	boolean	请求是否成功。
data	object	模型调试结果。
modelId	string	模型 ID。	model-1
connectionId	string	模型连接 ID。	mc-1
debugSuccess	boolean	模型调试是否成功。
status	string	调试结果状态	NORMAL
latencyMs	integer	本次模型调试调用耗时，单位为毫秒。	12
inputTokens	integer	本次模型调试请求消耗的输入 Token 数量。	3
outputTokens	integer	本次模型调试响应消耗的输出 Token 数量。	2
response	string	模型调试成功时返回的模型文本响应；调试失败时为空。	ok
errorCode	string	调试失败错误码	UPSTREAM_MODEL_ERROR
errorMessage	string	调试失败错误描述	The model endpoint rejected the debug request.

示例

正常返回示例

JSON格式

{
  "requestId": "request-1",
  "message": "success",
  "httpStatusCode": 200,
  "code": "SUCCESS",
  "success": true,
  "data": {
    "modelId": "model-1",
    "connectionId": "mc-1",
    "debugSuccess": true,
    "status": "NORMAL",
    "latencyMs": 12,
    "inputTokens": 3,
    "outputTokens": 2,
    "response": "ok",
    "errorCode": "UPSTREAM_MODEL_ERROR",
    "errorMessage": "The model endpoint rejected the debug request."
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	A model debugging parameter is invalid.
404	Resource.NotFound	The specified AgentCore workspace does not exist.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。