发起正式 Agent 对话

POST

/ai/agent/chat

使用当前用户可访问的已发布 Agent，通过 SSE 流式返回；超时时间 30 分钟。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "agentId": "string",
    "sessionId": "string",
    "queryId": "string",
    "runId": "string",
    "lastEventId": "string",
    "query": "string",
    "parameters": {},
    "files": [
        {
            "filename": "string",
            "size": "string",
            "path": "string",
            "virtualPath": "string",
            "artifactUrl": "string",
            "status": "uploaded",
            "markdownFile": "string",
            "markdownPath": "string",
            "markdownVirtualPath": "string",
            "markdownArtifactUrl": "string"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/ai/agent/chat' \
--header 'Last-Event-ID;' \
--header 'Content-Type: application/json' \
--data '{
    "agentId": "string",
    "sessionId": "string",
    "queryId": "string",
    "runId": "string",
    "lastEventId": "string",
    "query": "string",
    "parameters": {},
    "files": [
        {
            "filename": "string",
            "size": "string",
            "path": "string",
            "virtualPath": "string",
            "artifactUrl": "string",
            "status": "uploaded",
            "markdownFile": "string",
            "markdownPath": "string",
            "markdownVirtualPath": "string",
            "markdownArtifactUrl": "string"
        }
    ]
}'

返回响应

🟢200

text/event-stream

SSE 事件流，常见事件为 messages、custom、metadata、end、stream_error。

Bodytext/event-stream

示例

null

修改于 2026-08-25 03:04:03

fine_auth_token使用规范

发起 Agent 预览对话