Skip to main content
POST
cURL
使用 app_name: "harness_agent"、user_id、session_id 和 new_message 提交消息。普通调用或仅覆盖 MCP 时,应先创建会话;streaming: true 请求模型增量输出 KeyAuth 部署传入普通 harness 覆盖时,服务等待执行完成后发送单个 SSE 事件,仅提取 new_message.parts 中的文本;不会应用 state_delta 或 invocation_id。顶层 max_llm_calls 仅在这类普通覆盖中生效,并优先于 harness.max_llm_calls
运行会保存会话事件,并可能调用模型与工具。重试可能重复产生外部操作。共享 OAuth 仅允许 MCP 覆盖,完整限制见服务概述
每条 SSE 消息使用 data: <JSON> 并以空行分隔。使用 curl -N 读取到流结束,同时处理文本、状态或制品事件,以及 data: {"error":"..."};HTTP 200 不表示执行成功。普通覆盖的成功事件形如:

授权

Authorization
string
header
必填

本地未配置网关时可不提供;云部署使用 Runtime API Key 或部署要求的用户池 JWT,不能使用模型 API Key

请求体

application/json
app_name
string | null
必填

应用名称,普通调用应明确提供 harness_agent;本接口不使用 ADK_DEFAULT_APP_NAME 作为缺省应用

user_id
string
必填

用户 ID

session_id
string
必填

会话 ID

new_message
Content · object | null

本轮输入消息;恢复调用时可省略,具体取决于应用支持的调用方式

streaming
boolean
默认值:false

是否请求模型增量流式输出,默认 false

state_delta
Statedelta · object | null

本次写入的会话状态增量

function_call_event_id
string | null

此字段可被请求模型接受,但所核验 SDK 的 /run_sse 不应用该值

invocation_id
string | null

调用 ID

custom_metadata
Custommetadata · object | null

此字段可被请求模型接受,但所核验 SDK 的 /run_sse 不应用该值

harness
HarnessOverrides · object

仅对本次请求生效的覆盖;未提供的字段继承部署配置;使用覆盖时,顶层请求字段按本页使用 snake_case

max_llm_calls
integer | null

仅在 KeyAuth 普通 Harness 覆盖中生效;顶层值优先于 harness.max_llm_calls,再其次为部署配置。普通调用与仅 MCP 覆盖不应用此字段

必填范围: x >= 1

响应

请求成功

The response is of type string.

最后修改于 2026年9月19日