运行智能体

运行智能体

curl --request POST \
  --url http://localhost:8000/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": "user-001",
  "sessionId": "session-001"
}
'

import requests

url = "http://localhost:8000/run"

payload = {
    "userId": "user-001",
    "sessionId": "session-001"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({userId: 'user-001', sessionId: 'session-001'})
};

fetch('http://localhost:8000/run', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "modelVersion": "<string>",
    "content": {
      "parts": [
        {
          "mediaResolution": {
            "level": "MEDIA_RESOLUTION_UNSPECIFIED",
            "numTokens": 123
          },
          "codeExecutionResult": {
            "outcome": "OUTCOME_UNSPECIFIED",
            "output": "<string>",
            "id": "<string>"
          },
          "executableCode": {
            "code": "<string>",
            "language": "LANGUAGE_UNSPECIFIED",
            "id": "<string>"
          },
          "fileData": {
            "displayName": "<string>",
            "fileUri": "<string>",
            "mimeType": "<string>"
          },
          "functionCall": {
            "id": "<string>",
            "args": {},
            "name": "<string>",
            "partialArgs": [
              {
                "boolValue": true,
                "jsonPath": "<string>",
                "nullValue": "NULL_VALUE",
                "numberValue": 123,
                "stringValue": "<string>",
                "willContinue": true
              }
            ],
            "willContinue": true
          },
          "functionResponse": {
            "willContinue": true,
            "scheduling": "SCHEDULING_UNSPECIFIED",
            "parts": [
              {
                "inlineData": {
                  "mimeType": "<string>",
                  "data": "<string>",
                  "displayName": "<string>"
                },
                "fileData": {
                  "fileUri": "<string>",
                  "mimeType": "<string>",
                  "displayName": "<string>"
                }
              }
            ],
            "id": "<string>",
            "name": "<string>",
            "response": {}
          },
          "inlineData": {
            "data": "<string>",
            "displayName": "<string>",
            "mimeType": "<string>"
          },
          "text": "<string>",
          "thought": true,
          "thoughtSignature": "<string>",
          "videoMetadata": {
            "endOffset": "<string>",
            "fps": 123,
            "startOffset": "<string>"
          },
          "toolCall": {
            "id": "<string>",
            "toolType": "TOOL_TYPE_UNSPECIFIED",
            "args": {}
          },
          "toolResponse": {
            "id": "<string>",
            "toolType": "TOOL_TYPE_UNSPECIFIED",
            "response": {}
          },
          "partMetadata": {}
        }
      ],
      "role": "<string>"
    },
    "groundingMetadata": {
      "imageSearchQueries": [
        "<string>"
      ],
      "groundingChunks": [
        {
          "image": {
            "sourceUri": "<string>",
            "imageUri": "<string>",
            "title": "<string>",
            "domain": "<string>"
          },
          "maps": {
            "placeAnswerSources": {
              "reviewSnippet": [
                {
                  "authorAttribution": {
                    "displayName": "<string>",
                    "photoUri": "<string>",
                    "uri": "<string>"
                  },
                  "flagContentUri": "<string>",
                  "googleMapsUri": "<string>",
                  "relativePublishTimeDescription": "<string>",
                  "review": "<string>",
                  "reviewId": "<string>",
                  "title": "<string>"
                }
              ],
              "flagContentUri": "<string>",
              "reviewSnippets": [
                {
                  "authorAttribution": {
                    "displayName": "<string>",
                    "photoUri": "<string>",
                    "uri": "<string>"
                  },
                  "flagContentUri": "<string>",
                  "googleMapsUri": "<string>",
                  "relativePublishTimeDescription": "<string>",
                  "review": "<string>",
                  "reviewId": "<string>",
                  "title": "<string>"
                }
              ]
            },
            "placeId": "<string>",
            "text": "<string>",
            "title": "<string>",
            "uri": "<string>",
            "route": {
              "distanceMeters": 123,
              "duration": "<string>",
              "encodedPolyline": "<string>"
            }
          },
          "retrievedContext": {
            "documentName": "<string>",
            "ragChunk": {
              "pageSpan": {
                "firstPage": 123,
                "lastPage": 123
              },
              "text": "<string>",
              "chunkId": "<string>",
              "fileId": "<string>"
            },
            "text": "<string>",
            "title": "<string>",
            "uri": "<string>",
            "customMetadata": [
              {
                "key": "<string>",
                "numericValue": 123,
                "stringListValue": {
                  "values": [
                    "<string>"
                  ]
                },
                "stringValue": "<string>"
              }
            ],
            "fileSearchStore": "<string>",
            "pageNumber": 123,
            "mediaId": "<string>"
          },
          "web": {
            "domain": "<string>",
            "title": "<string>",
            "uri": "<string>"
          }
        }
      ],
      "groundingSupports": [
        {
          "confidenceScores": [
            123
          ],
          "groundingChunkIndices": [
            123
          ],
          "segment": {
            "startIndex": 123,
            "endIndex": 123,
            "partIndex": 123,
            "text": "<string>"
          },
          "renderedParts": [
            123
          ]
        }
      ],
      "retrievalMetadata": {
        "googleSearchDynamicRetrievalScore": 123
      },
      "searchEntryPoint": {
        "renderedContent": "<string>",
        "sdkBlob": "<string>"
      },
      "webSearchQueries": [
        "<string>"
      ],
      "googleMapsWidgetContextToken": "<string>",
      "retrievalQueries": [
        "<string>"
      ],
      "sourceFlaggingUris": [
        {
          "flagContentUri": "<string>",
          "sourceId": "<string>"
        }
      ]
    },
    "partial": true,
    "turnComplete": true,
    "turnCompleteReason": "TURN_COMPLETE_REASON_UNSPECIFIED",
    "finishReason": "FINISH_REASON_UNSPECIFIED",
    "errorCode": "<string>",
    "errorMessage": "<string>",
    "interrupted": true,
    "customMetadata": {},
    "usageMetadata": {
      "cacheTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "cachedContentTokenCount": 123,
      "candidatesTokenCount": 123,
      "candidatesTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "promptTokenCount": 123,
      "promptTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "thoughtsTokenCount": 123,
      "toolUsePromptTokenCount": 123,
      "toolUsePromptTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "totalTokenCount": 123,
      "trafficType": "TRAFFIC_TYPE_UNSPECIFIED"
    },
    "liveSessionResumptionUpdate": {
      "newHandle": "<string>",
      "resumable": true,
      "lastConsumedClientMessageIndex": 123
    },
    "liveSessionId": "<string>",
    "goAway": {
      "timeLeft": "<string>"
    },
    "inputTranscription": {
      "text": "<string>",
      "finished": true,
      "languageCode": "<string>"
    },
    "outputTranscription": {
      "text": "<string>",
      "finished": true,
      "languageCode": "<string>"
    },
    "avgLogprobs": 123,
    "logprobsResult": {
      "chosenCandidates": [
        {
          "logProbability": 123,
          "token": "<string>",
          "tokenId": 123
        }
      ],
      "topCandidates": [
        {
          "candidates": [
            {
              "logProbability": 123,
              "token": "<string>",
              "tokenId": 123
            }
          ]
        }
      ],
      "logProbabilitySum": 123
    },
    "cacheMetadata": {
      "fingerprint": "<string>",
      "contents_count": 1,
      "cache_name": "<string>",
      "expire_time": 123,
      "invocations_used": 1,
      "created_at": 123
    },
    "citationMetadata": {
      "citations": [
        {
          "endIndex": 123,
          "license": "<string>",
          "publicationDate": {
            "day": 123,
            "month": 123,
            "year": 123
          },
          "startIndex": 123,
          "title": "<string>",
          "uri": "<string>"
        }
      ]
    },
    "interactionId": "<string>",
    "invocationId": "",
    "author": "",
    "actions": {
      "skipSummarization": true,
      "stateDelta": {},
      "artifactDelta": {},
      "transferToAgent": "<string>",
      "escalate": true,
      "requestedAuthConfigs": {},
      "requestedToolConfirmations": {},
      "compaction": {
        "startTimestamp": 123,
        "endTimestamp": 123,
        "compactedContent": {
          "parts": [
            {
              "mediaResolution": {
                "level": "MEDIA_RESOLUTION_UNSPECIFIED",
                "numTokens": 123
              },
              "codeExecutionResult": {
                "outcome": "OUTCOME_UNSPECIFIED",
                "output": "<string>",
                "id": "<string>"
              },
              "executableCode": {
                "code": "<string>",
                "language": "LANGUAGE_UNSPECIFIED",
                "id": "<string>"
              },
              "fileData": {
                "displayName": "<string>",
                "fileUri": "<string>",
                "mimeType": "<string>"
              },
              "functionCall": {
                "id": "<string>",
                "args": {},
                "name": "<string>",
                "partialArgs": [
                  {
                    "boolValue": true,
                    "jsonPath": "<string>",
                    "nullValue": "NULL_VALUE",
                    "numberValue": 123,
                    "stringValue": "<string>",
                    "willContinue": true
                  }
                ],
                "willContinue": true
              },
              "functionResponse": {
                "willContinue": true,
                "scheduling": "SCHEDULING_UNSPECIFIED",
                "parts": [
                  {
                    "inlineData": {
                      "mimeType": "<string>",
                      "data": "<string>",
                      "displayName": "<string>"
                    },
                    "fileData": {
                      "fileUri": "<string>",
                      "mimeType": "<string>",
                      "displayName": "<string>"
                    }
                  }
                ],
                "id": "<string>",
                "name": "<string>",
                "response": {}
              },
              "inlineData": {
                "data": "<string>",
                "displayName": "<string>",
                "mimeType": "<string>"
              },
              "text": "<string>",
              "thought": true,
              "thoughtSignature": "<string>",
              "videoMetadata": {
                "endOffset": "<string>",
                "fps": 123,
                "startOffset": "<string>"
              },
              "toolCall": {
                "id": "<string>",
                "toolType": "TOOL_TYPE_UNSPECIFIED",
                "args": {}
              },
              "toolResponse": {
                "id": "<string>",
                "toolType": "TOOL_TYPE_UNSPECIFIED",
                "response": {}
              },
              "partMetadata": {}
            }
          ],
          "role": "<string>"
        }
      },
      "endOfAgent": true,
      "agentState": {},
      "rewindBeforeInvocationId": "<string>",
      "route": true,
      "renderUiWidgets": [
        {
          "id": "<string>",
          "provider": "<string>",
          "payload": {}
        }
      ],
      "setModelResponse": null
    },
    "output": null,
    "nodeInfo": {
      "path": "",
      "outputFor": [
        "<string>"
      ],
      "messageAsOutput": true
    },
    "longRunningToolIds": [
      "<string>"
    ],
    "branch": "<string>",
    "isolationScope": "<string>",
    "id": "",
    "timestamp": 123
  }
]

{
  "error": "<string>"
}

{
  "detail": "<string>"
}

{
  "error": "CONTENT_LENGTH_REQUIRED"
}

{
  "error": "REQUEST_TOO_LARGE"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

POST

run

运行智能体

curl --request POST \
  --url http://localhost:8000/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userId": "user-001",
  "sessionId": "session-001"
}
'

import requests

url = "http://localhost:8000/run"

payload = {
    "userId": "user-001",
    "sessionId": "session-001"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({userId: 'user-001', sessionId: 'session-001'})
};

fetch('http://localhost:8000/run', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "modelVersion": "<string>",
    "content": {
      "parts": [
        {
          "mediaResolution": {
            "level": "MEDIA_RESOLUTION_UNSPECIFIED",
            "numTokens": 123
          },
          "codeExecutionResult": {
            "outcome": "OUTCOME_UNSPECIFIED",
            "output": "<string>",
            "id": "<string>"
          },
          "executableCode": {
            "code": "<string>",
            "language": "LANGUAGE_UNSPECIFIED",
            "id": "<string>"
          },
          "fileData": {
            "displayName": "<string>",
            "fileUri": "<string>",
            "mimeType": "<string>"
          },
          "functionCall": {
            "id": "<string>",
            "args": {},
            "name": "<string>",
            "partialArgs": [
              {
                "boolValue": true,
                "jsonPath": "<string>",
                "nullValue": "NULL_VALUE",
                "numberValue": 123,
                "stringValue": "<string>",
                "willContinue": true
              }
            ],
            "willContinue": true
          },
          "functionResponse": {
            "willContinue": true,
            "scheduling": "SCHEDULING_UNSPECIFIED",
            "parts": [
              {
                "inlineData": {
                  "mimeType": "<string>",
                  "data": "<string>",
                  "displayName": "<string>"
                },
                "fileData": {
                  "fileUri": "<string>",
                  "mimeType": "<string>",
                  "displayName": "<string>"
                }
              }
            ],
            "id": "<string>",
            "name": "<string>",
            "response": {}
          },
          "inlineData": {
            "data": "<string>",
            "displayName": "<string>",
            "mimeType": "<string>"
          },
          "text": "<string>",
          "thought": true,
          "thoughtSignature": "<string>",
          "videoMetadata": {
            "endOffset": "<string>",
            "fps": 123,
            "startOffset": "<string>"
          },
          "toolCall": {
            "id": "<string>",
            "toolType": "TOOL_TYPE_UNSPECIFIED",
            "args": {}
          },
          "toolResponse": {
            "id": "<string>",
            "toolType": "TOOL_TYPE_UNSPECIFIED",
            "response": {}
          },
          "partMetadata": {}
        }
      ],
      "role": "<string>"
    },
    "groundingMetadata": {
      "imageSearchQueries": [
        "<string>"
      ],
      "groundingChunks": [
        {
          "image": {
            "sourceUri": "<string>",
            "imageUri": "<string>",
            "title": "<string>",
            "domain": "<string>"
          },
          "maps": {
            "placeAnswerSources": {
              "reviewSnippet": [
                {
                  "authorAttribution": {
                    "displayName": "<string>",
                    "photoUri": "<string>",
                    "uri": "<string>"
                  },
                  "flagContentUri": "<string>",
                  "googleMapsUri": "<string>",
                  "relativePublishTimeDescription": "<string>",
                  "review": "<string>",
                  "reviewId": "<string>",
                  "title": "<string>"
                }
              ],
              "flagContentUri": "<string>",
              "reviewSnippets": [
                {
                  "authorAttribution": {
                    "displayName": "<string>",
                    "photoUri": "<string>",
                    "uri": "<string>"
                  },
                  "flagContentUri": "<string>",
                  "googleMapsUri": "<string>",
                  "relativePublishTimeDescription": "<string>",
                  "review": "<string>",
                  "reviewId": "<string>",
                  "title": "<string>"
                }
              ]
            },
            "placeId": "<string>",
            "text": "<string>",
            "title": "<string>",
            "uri": "<string>",
            "route": {
              "distanceMeters": 123,
              "duration": "<string>",
              "encodedPolyline": "<string>"
            }
          },
          "retrievedContext": {
            "documentName": "<string>",
            "ragChunk": {
              "pageSpan": {
                "firstPage": 123,
                "lastPage": 123
              },
              "text": "<string>",
              "chunkId": "<string>",
              "fileId": "<string>"
            },
            "text": "<string>",
            "title": "<string>",
            "uri": "<string>",
            "customMetadata": [
              {
                "key": "<string>",
                "numericValue": 123,
                "stringListValue": {
                  "values": [
                    "<string>"
                  ]
                },
                "stringValue": "<string>"
              }
            ],
            "fileSearchStore": "<string>",
            "pageNumber": 123,
            "mediaId": "<string>"
          },
          "web": {
            "domain": "<string>",
            "title": "<string>",
            "uri": "<string>"
          }
        }
      ],
      "groundingSupports": [
        {
          "confidenceScores": [
            123
          ],
          "groundingChunkIndices": [
            123
          ],
          "segment": {
            "startIndex": 123,
            "endIndex": 123,
            "partIndex": 123,
            "text": "<string>"
          },
          "renderedParts": [
            123
          ]
        }
      ],
      "retrievalMetadata": {
        "googleSearchDynamicRetrievalScore": 123
      },
      "searchEntryPoint": {
        "renderedContent": "<string>",
        "sdkBlob": "<string>"
      },
      "webSearchQueries": [
        "<string>"
      ],
      "googleMapsWidgetContextToken": "<string>",
      "retrievalQueries": [
        "<string>"
      ],
      "sourceFlaggingUris": [
        {
          "flagContentUri": "<string>",
          "sourceId": "<string>"
        }
      ]
    },
    "partial": true,
    "turnComplete": true,
    "turnCompleteReason": "TURN_COMPLETE_REASON_UNSPECIFIED",
    "finishReason": "FINISH_REASON_UNSPECIFIED",
    "errorCode": "<string>",
    "errorMessage": "<string>",
    "interrupted": true,
    "customMetadata": {},
    "usageMetadata": {
      "cacheTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "cachedContentTokenCount": 123,
      "candidatesTokenCount": 123,
      "candidatesTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "promptTokenCount": 123,
      "promptTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "thoughtsTokenCount": 123,
      "toolUsePromptTokenCount": 123,
      "toolUsePromptTokensDetails": [
        {
          "modality": "MODALITY_UNSPECIFIED",
          "tokenCount": 123
        }
      ],
      "totalTokenCount": 123,
      "trafficType": "TRAFFIC_TYPE_UNSPECIFIED"
    },
    "liveSessionResumptionUpdate": {
      "newHandle": "<string>",
      "resumable": true,
      "lastConsumedClientMessageIndex": 123
    },
    "liveSessionId": "<string>",
    "goAway": {
      "timeLeft": "<string>"
    },
    "inputTranscription": {
      "text": "<string>",
      "finished": true,
      "languageCode": "<string>"
    },
    "outputTranscription": {
      "text": "<string>",
      "finished": true,
      "languageCode": "<string>"
    },
    "avgLogprobs": 123,
    "logprobsResult": {
      "chosenCandidates": [
        {
          "logProbability": 123,
          "token": "<string>",
          "tokenId": 123
        }
      ],
      "topCandidates": [
        {
          "candidates": [
            {
              "logProbability": 123,
              "token": "<string>",
              "tokenId": 123
            }
          ]
        }
      ],
      "logProbabilitySum": 123
    },
    "cacheMetadata": {
      "fingerprint": "<string>",
      "contents_count": 1,
      "cache_name": "<string>",
      "expire_time": 123,
      "invocations_used": 1,
      "created_at": 123
    },
    "citationMetadata": {
      "citations": [
        {
          "endIndex": 123,
          "license": "<string>",
          "publicationDate": {
            "day": 123,
            "month": 123,
            "year": 123
          },
          "startIndex": 123,
          "title": "<string>",
          "uri": "<string>"
        }
      ]
    },
    "interactionId": "<string>",
    "invocationId": "",
    "author": "",
    "actions": {
      "skipSummarization": true,
      "stateDelta": {},
      "artifactDelta": {},
      "transferToAgent": "<string>",
      "escalate": true,
      "requestedAuthConfigs": {},
      "requestedToolConfirmations": {},
      "compaction": {
        "startTimestamp": 123,
        "endTimestamp": 123,
        "compactedContent": {
          "parts": [
            {
              "mediaResolution": {
                "level": "MEDIA_RESOLUTION_UNSPECIFIED",
                "numTokens": 123
              },
              "codeExecutionResult": {
                "outcome": "OUTCOME_UNSPECIFIED",
                "output": "<string>",
                "id": "<string>"
              },
              "executableCode": {
                "code": "<string>",
                "language": "LANGUAGE_UNSPECIFIED",
                "id": "<string>"
              },
              "fileData": {
                "displayName": "<string>",
                "fileUri": "<string>",
                "mimeType": "<string>"
              },
              "functionCall": {
                "id": "<string>",
                "args": {},
                "name": "<string>",
                "partialArgs": [
                  {
                    "boolValue": true,
                    "jsonPath": "<string>",
                    "nullValue": "NULL_VALUE",
                    "numberValue": 123,
                    "stringValue": "<string>",
                    "willContinue": true
                  }
                ],
                "willContinue": true
              },
              "functionResponse": {
                "willContinue": true,
                "scheduling": "SCHEDULING_UNSPECIFIED",
                "parts": [
                  {
                    "inlineData": {
                      "mimeType": "<string>",
                      "data": "<string>",
                      "displayName": "<string>"
                    },
                    "fileData": {
                      "fileUri": "<string>",
                      "mimeType": "<string>",
                      "displayName": "<string>"
                    }
                  }
                ],
                "id": "<string>",
                "name": "<string>",
                "response": {}
              },
              "inlineData": {
                "data": "<string>",
                "displayName": "<string>",
                "mimeType": "<string>"
              },
              "text": "<string>",
              "thought": true,
              "thoughtSignature": "<string>",
              "videoMetadata": {
                "endOffset": "<string>",
                "fps": 123,
                "startOffset": "<string>"
              },
              "toolCall": {
                "id": "<string>",
                "toolType": "TOOL_TYPE_UNSPECIFIED",
                "args": {}
              },
              "toolResponse": {
                "id": "<string>",
                "toolType": "TOOL_TYPE_UNSPECIFIED",
                "response": {}
              },
              "partMetadata": {}
            }
          ],
          "role": "<string>"
        }
      },
      "endOfAgent": true,
      "agentState": {},
      "rewindBeforeInvocationId": "<string>",
      "route": true,
      "renderUiWidgets": [
        {
          "id": "<string>",
          "provider": "<string>",
          "payload": {}
        }
      ],
      "setModelResponse": null
    },
    "output": null,
    "nodeInfo": {
      "path": "",
      "outputFor": [
        "<string>"
      ],
      "messageAsOutput": true
    },
    "longRunningToolIds": [
      "<string>"
    ],
    "branch": "<string>",
    "isolationScope": "<string>",
    "id": "",
    "timestamp": 123
  }
]

{
  "error": "<string>"
}

{
  "detail": "<string>"
}

{
  "error": "CONTENT_LENGTH_REQUIRED"
}

{
  "error": "REQUEST_TOO_LARGE"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

先在 harness_agent 应用下创建会话。此接口等待运行完成后返回事件数组，仅支持 harness.mcp_servers 覆盖；模型、工具、技能和提示词覆盖使用调用 Harness

运行会保存会话事件，并可能调用模型、工具和外部资源。重复发送请求可能再次执行这些操作

streaming 不改变 JSON 响应格式。服务认证与共享 OAuth 限制见Harness Runtime 概述

授权

Authorization

string

header

必填

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

请求体

application/json

userId

string

必填

用户 ID

sessionId

string

必填

会话 ID

appName

string | null

应用名称；省略时使用 ADK_DEFAULT_APP_NAME，未配置默认应用则返回 400

newMessage

Content · object | null

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

Show child attributes

streaming

boolean

默认值:false

本接口仍返回一次性 JSON 事件数组，此字段不启用流式响应

stateDelta

Statedelta · object | null

本次写入的会话状态增量

functionCallEventId

string | null

对应函数调用的事件 ID，用于函数响应相关的流式处理

invocationId

string | null

调用 ID

customMetadata

Custommetadata · object | null

自定义元数据

harness

object

Show child attributes

响应

请求成功

modelVersion

string | null

模型版本

content

Content · object | null

消息内容

Show child attributes

groundingMetadata

GroundingMetadata · object | null

Show child attributes

partial

boolean | null

是否为增量内容片段

turnComplete

boolean | null

是否完成当前轮次

turnCompleteReason

enum<string> | null

可用选项:

TURN_COMPLETE_REASON_UNSPECIFIED,

MALFORMED_FUNCTION_CALL,

RESPONSE_REJECTED,

NEED_MORE_INPUT,

PROHIBITED_INPUT_CONTENT,

IMAGE_PROHIBITED_INPUT_CONTENT,

INPUT_TEXT_CONTAIN_PROMINENT_PERSON_PROHIBITED,

INPUT_IMAGE_CELEBRITY,

INPUT_IMAGE_PHOTO_REALISTIC_CHILD_PROHIBITED,

INPUT_TEXT_NCII_PROHIBITED,

INPUT_OTHER,

INPUT_IP_PROHIBITED,

BLOCKLIST,

UNSAFE_PROMPT_FOR_IMAGE_GENERATION,

GENERATED_IMAGE_SAFETY,

GENERATED_CONTENT_SAFETY,

GENERATED_AUDIO_SAFETY,

GENERATED_VIDEO_SAFETY,

GENERATED_CONTENT_PROHIBITED,

GENERATED_CONTENT_BLOCKLIST,

GENERATED_IMAGE_PROHIBITED,

GENERATED_IMAGE_CELEBRITY,

GENERATED_IMAGE_PROMINENT_PEOPLE_DETECTED_BY_REWRITER,

GENERATED_IMAGE_IDENTIFIABLE_PEOPLE,

GENERATED_IMAGE_MINORS,

OUTPUT_IMAGE_IP_PROHIBITED,

GENERATED_OTHER,

MAX_REGENERATION_REACHED

finishReason

enum<string> | null

生成结束原因

可用选项:

FINISH_REASON_UNSPECIFIED,

STOP,

MAX_TOKENS,

SAFETY,

RECITATION,

LANGUAGE,

OTHER,

BLOCKLIST,

PROHIBITED_CONTENT,

SPII,

MALFORMED_FUNCTION_CALL,

IMAGE_SAFETY,

UNEXPECTED_TOOL_CALL,

IMAGE_PROHIBITED_CONTENT,

NO_IMAGE,

IMAGE_RECITATION,

IMAGE_OTHER

errorCode

string | null

错误代码

errorMessage

string | null

错误说明

interrupted

boolean | null

是否被中断

customMetadata

Custommetadata · object | null

自定义元数据

usageMetadata

GenerateContentResponseUsageMetadata · object | null

模型用量信息

Show child attributes

liveSessionResumptionUpdate

LiveServerSessionResumptionUpdate · object | null

Show child attributes

liveSessionId

string | null

goAway

LiveServerGoAway · object | null

Show child attributes

inputTranscription

Transcription · object | null

Show child attributes

outputTranscription

Transcription · object | null

Show child attributes

avgLogprobs

number | null

logprobsResult

LogprobsResult · object | null

Show child attributes

cacheMetadata

CacheMetadata · object | null

Show child attributes

citationMetadata

CitationMetadata · object | null

Show child attributes

interactionId

string | null

交互 ID

invocationId

string

默认值:""

调用 ID

author

string

默认值:""

事件作者，通常为 user 或智能体名称

actions

EventActions · object

事件携带的状态、制品和控制操作

Show child attributes

output

unknown

nodeInfo

NodeInfo · object

Show child attributes

longRunningToolIds

string[] | null

等待结果的长时间运行工具调用 ID

branch

string | null

事件所属的执行分支

isolationScope

string | null

string

默认值:""

标识符

timestamp

number

事件时间，Unix 时间戳，单位为秒

最后修改于 2026年9月19日

Agent API Server 接口

Harness Runtime 接口

授权

请求体

响应