{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/bmvkoayyv","result":{"data":{"markdownRemark":{"html":"

接口描述

\n

向指定 Agent 发起同步对话，等待 Agent 完成全部推理后一次性返回最终结果。适用于不需要实时反馈的场景。

\n

请求结构

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /v2/workspaces/{workspaceId}/dataagent/agents/{agentId}/query
\n
\n
\n
\n \n

路径参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名类型是否必填说明
workspaceIdstring是工作空间 ID
agentIdstring是Agent ID
\n

请求 Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名类型是否必填说明
querystring是用户问题
session_idstring否会话 ID；建议使用“创建 Agent”接口返回值，格式如 session_1735000000000_a3f2b9
timeout_secint否超时秒数，默认 120，最大 300
modestring否分析模式：auto（默认）/ analysis / ide
model_overridestring是覆盖 Agent 默认模型，仅对本次对话生效
temperature_overridefloat否覆盖 Agent 默认温度，仅对本次对话生效
reasoning_effortstring否推理强度覆盖：off / low / medium / high
selected_ontologystring[]否本次对话额外指定的本体类型列表
selected_functionsstring[]否本次对话额外指定的 Logic Function 列表
selected_datasearchesstring[]否本次对话额外指定的 DataSearch 列表
selected_skillsSelectedSkillRef[]否本次对话允许 Agent 使用的 Skill 发布版本列表
invoked_skillsSelectedSkillRef[]否本次对话由用户显式调用的 Skill 发布版本列表
tools_runtimeobject[]否工具运行时配置
configobject否Agent 运行配置
notepad_contentstring否对话上下文便签内容
\n

请求示例

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST \\\n2  'https://{host}/databuilder/api/databuilder/v2/workspaces/workspace_9862_0763f283d58a/dataagent/agents/default/query' \\\n3  -H 'Content-Type: application/json' \\\n4  -H 'X-App-Id: dataagent-service' \\\n5  -H 'Authorization: <签名串>' \\\n6  -d '{\n7    \"query\": \"最近30天各省份订单量排行\",\n8    \"session_id\": \"session_1735000000000_a3f2b9\",\n9    \"timeout_sec\": 120,\n10    \"selected_ontology\": [\"User\", \"Order\"]\n11  }'
\n
\n
\n
\n \n

响应

\n

成功（HTTP 200）

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"session_id\": \"session_1735000000000_a3f2b9\",\n3  \"final_answer\": \"## 最近30天各省份订单量排行\\n\\n| 排名 | 省份 | 订单量 |\\n|---|---|---|\\n| 1 | 广东 | 15,432 | 18.2% |\\n| 2 | 浙江 | 12,891 | 15.2% |...\",\n4  \"trace\": {\n5    \"steps\": [\n6      {\n7        \"step_id\": \"step_1\",\n8        \"tool_call_id\": \"call_abc123\",\n9        \"thought\": \"需要按省份统计订单量\",\n10        \"tool_name\": \"OntologyAggregation\",\n11        \"tool_input\": \"{\\\"object_type\\\":\\\"Order\\\",\\\"group_by\\\":\\\"province\\\",\\\"metric\\\":\\\"count\\\"}\",\n12        \"observation\": \"{\\\"result\\\":[{\\\"province\\\":\\\"广东\\\",\\\"count\\\":15432},...]}\"\n13      }\n14    ]\n15  },\n16  \"elapsed_ms\": 8756,\n17  \"turn_usage\": {\n18    \"total_input_tokens\": 12450,\n19    \"total_output_tokens\": 892,\n20    \"tool_input_tokens\": 380,\n21    \"observation_tokens\": 7823,\n22    \"thought_tokens\": 245,\n23    \"elapsed_ms\": 8756,\n24    \"step_count\": 3\n25  },\n26  \"lineage_graph\": {\n27    \"session_id\": \"session_1735000000000_a3f2b9\",\n28    \"nodes\": [\n29      {\"id\": \"node_datasource_Order\", \"type\": \"datasource\", \"label\": \"Order\", \"turn_id\": \"turn_1\"},\n30      {\"id\": \"node_op_step_1\", \"type\": \"operation\", \"label\": \"OntologyAggregation\", \"turn_id\": \"turn_1\"},\n31      {\"id\": \"node_result_turn_1\", \"type\": \"result\", \"label\": \"省份订单排行\", \"turn_id\": \"turn_1\"}\n32    ],\n33    \"edges\": [\n34      {\"from\": \"node_datasource_Order\", \"to\": \"node_op_step_1\"},\n35      {\"from\": \"node_op_step_1\", \"to\": \"node_result_turn_1\"}\n36    ],\n37    \"outline\": [\n38      {\"type\": \"question\", \"text\": \"最近30天各省份订单量排行\", \"node_id\": \"node_result_turn_1\"}\n39    ]\n40  }\n41}
\n
\n
\n
\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段类型说明
session_idstring会话 ID
final_answerstringAgent 最终回答，Markdown 格式
trace.stepsStepTrace[]推理过程步骤列表，结构同流式接口 StepTrace
elapsed_msint总耗时（毫秒）
turn_usageobjectToken 用量统计，结构同流式接口 turn_usage
lineage_graphobject数据血缘图，结构同流式接口 lineage_graph
\n

错误码

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP 状态码错误码说明
400BadRequestquery 为空或请求参数不合法
400DataAgentResourceNotBound工作空间资源未绑定
404NotFoundAgent 不存在
500InternalServerError服务内部错误或超时
","fields":{"slug":"bmvkoayyv","title":"非流式对话","date":"2026-10-23","extractedHeadings":[]},"headings":[{"value":"接口描述","depth":2},{"value":"请求结构","depth":2},{"value":"路径参数","depth":2},{"value":"请求 Body","depth":2},{"value":"请求示例","depth":2},{"value":"响应","depth":2},{"value":"错误码","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"bmvkoayyv","prev":{"id":"kmvko9bv5","name":"流式对话（SSE）","path":"kmvko9bv5","filePath":"API参考/Data Agent/流式对话（SSE）.md","seo":null,"parentIds":["jm99rjcbz","Smvko40cl"],"parents":[{"id":"jm99rjcbz","documentId":"b03bbd23-302f-4394-b482-b080ad9e0537","name":"API参考","repoName":"DataBuilder","filePath":"API参考","disabled":false,"path":"jm99rjcbz","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Smvko40cl","documentId":"ce8a3c0a-60ee-425f-bdbb-6fa9d739a208","name":"Data Agent","repoName":"DataBuilder","filePath":"API参考/Data Agent","disabled":false,"path":"Smvko40cl","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Fmvkocaj8","name":"查询已发布本体对象类型","path":"Fmvkocaj8","filePath":"API参考/Data Agent/查询已发布本体对象类型.md","seo":null,"parentIds":["jm99rjcbz","Smvko40cl"],"parents":[{"id":"jm99rjcbz","documentId":"b03bbd23-302f-4394-b482-b080ad9e0537","name":"API参考","repoName":"DataBuilder","filePath":"API参考","disabled":false,"path":"jm99rjcbz","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Smvko40cl","documentId":"ce8a3c0a-60ee-425f-bdbb-6fa9d739a208","name":"Data Agent","repoName":"DataBuilder","filePath":"API参考/Data Agent","disabled":false,"path":"Smvko40cl","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"jm99rjcbz","documentId":"b03bbd23-302f-4394-b482-b080ad9e0537","name":"API参考","repoName":"DataBuilder","filePath":"API参考","disabled":false,"path":"jm99rjcbz","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"Smvko40cl","documentId":"ce8a3c0a-60ee-425f-bdbb-6fa9d739a208","name":"Data Agent","repoName":"DataBuilder","filePath":"API参考/Data Agent","disabled":false,"path":"Smvko40cl","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}