1. Agent 对话
Dora接口
  • fine_auth_token使用规范
  • Agent 对话
    • 发起正式 Agent 对话
      POST
    • 发起 Agent 预览对话
      POST
    • 中断正在执行的对话
      POST
    • 获取推荐追问
      POST
  • 会话管理
    • 关闭会话
      POST
    • 查询会话历史
      POST
    • 查询会话引用的 BI 资源
      GET
    • 查询单轮资源引用
      POST
    • 查询 Agent 会话列表
      POST
    • 删除会话
      POST
    • 重命名会话
      POST
  • Artifact
    • 获取 artifact 预览内容
      POST
    • 保存 artifact 文本内容
      POST
    • 下载 artifact
      GET
    • 将 artifact 安装为自定义技能
      POST
  • Agent 配置
    • 查询可编辑 Agent 列表
      GET
    • 查询可编辑 Agent 详情
      GET
    • 查询已发布 Agent 展示信息
      GET
    • 查询 Agent 已绑定 Skill
      GET
    • 获取已发布到工作台的 Agent
      GET
    • 创建 Agent 草稿
      POST
    • 保存 Agent 配置
      POST
    • 发布 Agent
      POST
  • 会话文件
    • 将文件加入会话
      POST
    • 查询会话文件
      GET
    • 删除会话文件
      POST
  • Skill
    • 查询可用 Skill
  • LLM
    • 查询 LLM 配置
  • 数据模型
    • ApiResponseBase
    • SuccessEnvelope
    • AgentDisplayInfoListResponse
    • ErrorResponse
    • ObjectEnvelope
    • AgentDisplayInfo
    • AgentTag
    • AgentUploadRequest
    • SessionExperienceConfig
    • QuestionCategory
    • UploadDeleteRequest
    • UploadFileItem
    • UploadResult
    • UploadFileList
    • UploadResultEnvelope
    • UploadFileListEnvelope
    • AgentChatRequest
    • AgentTestChatRequest
    • AgentHistoryRequest
    • AgentAbortRequest
    • DisplayMessage
    • SessionHistory
    • SessionHistoryEnvelope
    • AgentChatResource
    • AgentChatConnectorGroup
    • AgentChatResources
    • AgentChatResourcesEnvelope
    • QueryResourceReferenceRequest
    • QueryResourceReference
    • QueryResourceReferenceListEnvelope
    • AgentArtifactRequest
    • AgentArtifactSaveRequest
    • AgentArtifactInstallRequest
    • AgentArtifactContent
    • AgentArtifactContentEnvelope
    • SessionListRequest
    • SessionDeleteRequest
    • SessionRenameRequest
    • ScheduledTaskBrief
    • SessionItem
    • SessionItemListEnvelope
    • RecommendQuestionsRequest
    • RecommendQuestionsResult
    • RecommendQuestionsEnvelope
    • SkillConfig
    • AgentSummary
    • AgentConfig
    • CreateAgentRequest
    • CreateAgentResult
    • AgentPublishRequest
    • PublishAgentResult
    • AvailableSkill
    • LlmConfig
    • AgentSummaryListEnvelope
    • AgentConfigEnvelope
    • AgentDisplayInfoEnvelope
    • SkillConfigListEnvelope
    • CreateAgentResultEnvelope
    • PublishAgentResultEnvelope
    • AvailableSkillListEnvelope
    • LlmConfigListEnvelope
  1. Agent 对话

发起 Agent 预览对话

POST
/ai/agent/chat/preview
使用请求中的未发布 Agent 配置进行 SSE 对话,需要 AGENT_MANAGE_CREATE 权限。

请求参数

Body 参数application/json必填

示例
{
    "agentConfig": {
        "id": "string",
        "name": "string",
        "description": "string",
        "avatar": "string",
        "welcomeMessage": "string",
        "sessionExperienceConfig": {
            "multiTurnEnabled": true,
            "firstRoundRecommendationEnabled": true,
            "useCustomRecommendations": true,
            "inputPlaceholder": "string",
            "categories": [
                {
                    "id": "string",
                    "name": "string",
                    "icon": "string",
                    "inputPlaceholder": "string",
                    "questions": [
                        "string"
                    ]
                }
            ]
        },
        "skillIds": [
            "string"
        ],
        "skillConfigs": [
            {
                "id": "string",
                "name": "string",
                "description": "string",
                "icon": "string",
                "skillType": "GENERAL",
                "skillScenario": "string",
                "skillCategory": "string",
                "skillCustomConfig": {
                    "property1": "string",
                    "property2": "string"
                },
                "skillStatus": "string",
                "datasourceIds": [
                    "string"
                ],
                "recommendedScenarios": [
                    "string"
                ],
                "createdBy": "string",
                "createdAt": 0,
                "updatedAt": 0,
                "editable": true,
                "deletable": true
            }
        ],
        "datasourceIds": [
            "string"
        ],
        "knowledgeSpaceIds": [
            "string"
        ],
        "mcpConfigIds": [
            "string"
        ],
        "tagIds": [
            "string"
        ],
        "tagDetails": [
            {
                "id": "string",
                "groupId": "string",
                "groupName": "string",
                "name": "string",
                "sortOrder": 0
            }
        ],
        "llmConfigId": "string",
        "systemPrompt": "string",
        "scheduledPushTasks": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "agentType": "WRAPPED",
        "agentStatus": "DRAFT",
        "publishToWorkspace": true,
        "publishToStandaloneUrl": true,
        "publishBIEntryIds": [
            "string"
        ],
        "reachabilityBaseMode": "string",
        "reachabilityEntries": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "vendor": "string",
        "apiUrl": "string",
        "apiToken": "pa$$word",
        "botId": "string"
    },
    "sessionId": "string",
    "queryId": "string",
    "query": "string",
    "agentId": "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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/ai/agent/chat/preview' \
--header 'Content-Type: application/json' \
--data '{
    "agentConfig": {
        "id": "string",
        "name": "string",
        "description": "string",
        "avatar": "string",
        "welcomeMessage": "string",
        "sessionExperienceConfig": {
            "multiTurnEnabled": true,
            "firstRoundRecommendationEnabled": true,
            "useCustomRecommendations": true,
            "inputPlaceholder": "string",
            "categories": [
                {
                    "id": "string",
                    "name": "string",
                    "icon": "string",
                    "inputPlaceholder": "string",
                    "questions": [
                        "string"
                    ]
                }
            ]
        },
        "skillIds": [
            "string"
        ],
        "skillConfigs": [
            {
                "id": "string",
                "name": "string",
                "description": "string",
                "icon": "string",
                "skillType": "GENERAL",
                "skillScenario": "string",
                "skillCategory": "string",
                "skillCustomConfig": {
                    "property1": "string",
                    "property2": "string"
                },
                "skillStatus": "string",
                "datasourceIds": [
                    "string"
                ],
                "recommendedScenarios": [
                    "string"
                ],
                "createdBy": "string",
                "createdAt": 0,
                "updatedAt": 0,
                "editable": true,
                "deletable": true
            }
        ],
        "datasourceIds": [
            "string"
        ],
        "knowledgeSpaceIds": [
            "string"
        ],
        "mcpConfigIds": [
            "string"
        ],
        "tagIds": [
            "string"
        ],
        "tagDetails": [
            {
                "id": "string",
                "groupId": "string",
                "groupName": "string",
                "name": "string",
                "sortOrder": 0
            }
        ],
        "llmConfigId": "string",
        "systemPrompt": "string",
        "scheduledPushTasks": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "agentType": "WRAPPED",
        "agentStatus": "DRAFT",
        "publishToWorkspace": true,
        "publishToStandaloneUrl": true,
        "publishBIEntryIds": [
            "string"
        ],
        "reachabilityBaseMode": "string",
        "reachabilityEntries": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "vendor": "string",
        "apiUrl": "string",
        "apiToken": "pa$$word",
        "botId": "string"
    },
    "sessionId": "string",
    "queryId": "string",
    "query": "string",
    "agentId": "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 事件流
Bodytext/event-stream

示例
null
修改于 2026-08-25 03:04:03
上一页
发起正式 Agent 对话
下一页
中断正在执行的对话
Built with