curl --request POST \
--url http://localhost:8000/harness/invoke \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "Hello",
"harness_name": "harness",
"run_agent_request": {
"user_id": "user-001",
"session_id": "session-001"
}
}
'
{
"harness_name": "harness",
"overwrite": false,
"output": "Hello",
"error": null
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Harness 调用
调用 Harness
仅用于 KeyAuth 部署，等待调用完成后返回 JSON；共享 OAuth 部署不提供此接口。覆盖只对本次请求生效，未提供的字段继承部署配置，不支持 harness_merge 或 harness_enhance
tools 与 skills 追加到已有配置；mcp_servers 按整个列表替换，空数组清空本次 MCP。运行失败仍可能返回 HTTP 200，应检查响应 error；成功时 error 为 null。仅覆盖 MCP 时 overwrite 可能为 false
POST
/
harness
/
invoke
curl --request POST \
--url http://localhost:8000/harness/invoke \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "Hello",
"harness_name": "harness",
"run_agent_request": {
"user_id": "user-001",
"session_id": "session-001"
}
}
'
{
"harness_name": "harness",
"overwrite": false,
"output": "Hello",
"error": null
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}适用于 KeyAuth 部署，使用
响应在完成后一次性返回。检查
prompt 提供文本，通过 run_agent_request 指定用户和会话。harness_name 是请求和响应中的名称，会话仍使用 harness_agent 应用；共享 OAuth 部署不提供此接口
harness 只影响本次调用，字段省略时继承部署配置。tools 追加已注册的内置工具，mcp_servers 替换远程 MCP 列表
本接口会运行智能体并保存会话事件，可能调用模型、工具和云资源。重试可能再次执行外部操作
error 是否为 null，不要仅凭 HTTP 200 或 overwrite 判断成功；失败时 output 为空字符串授权
本地未配置网关时可不提供；云部署使用 Runtime API Key 或部署要求的用户池 JWT，不能使用模型 API Key
请求体
application/json
最后修改于 2026年9月19日