ExecuteQuery - 执行语句-Agent 观测与优化 AgentLoop(AgentLoop)-阿里云帮助中心

执行查询语句。

接口说明

调用 CreateEvaluationTask 在指定 AgentSpace 下创建评估任务。服务端会校验 AgentSpace 权限、初始化评估结果存储、检查任务名称唯一性，并根据 taskMode 与 runStrategies 异步创建和执行 EvaluationRun。

该接口适用于对 Trace、Dataset 或 SLS Log 数据运行内置或自定义评估器，支持历史回填和持续评估两类执行策略。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentloop:ExecuteQuery

update

*Dataset

acs:agentloop:{#regionId}:{#accountId}:agentspace/{#AgentSpaceName}/dataset/{#DatasetName}

无

请求语法

POST /agentspace/{agentSpace}/dataset/{datasetName}/query HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
agentSpace	string	是	智能体空间名称	sop-agent
datasetName	string	是	数据集名称	product_faq_dataset

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
type	string	是	语句类型（当前仅支持传 SQL）	SQL
query	string	是	用户输入的 query	select count(*) from product_faq_dataset
maxOutputLength	integer	否	最大输出长度	100
from	integer	否	查询开始时间点	1760925728
to	integer	否	查询结束时间点	1760925788
offset	integer	否	分页偏移	0
length	integer	否	分页大小	100
version	string	否	数据集版本	1.0.0
annotationFilter	object	否	标注过滤
conditions	array<object>	否	标注过滤条件
	object	否
key	string	否	标注 key	answer_quality
operator	string	否	运算符	eq
value	any	否	标注值	GOOD

返回参数

名称	类型	描述	示例值
	object	Schema of Response
requestId	string	请求 ID	EB27D183-8F6C-5C5A-A6A3-E0508AF54F78
meta	object	返回数据 meta 信息
affectedRows	integer	扫描/处理的日志行数	100
elapsedMillisecond	integer	本次执行消耗的毫秒时间	15
progress	string	查询的结果是否完整	Complete
count	integer	本次查询请求返回的日志行数。	1
truncation	object	结果截断详情
truncated	boolean	结果是否被截断
truncatedColumnIndexes	array	结果行截断情况
	array	单行截断情况
	integer	是否被截断	0
columns	array	结果列信息
	string	结果列	column1
columnTypes	array	结果列类型
	string	列类型	double
rows	array	结果行
	array	结果行
	any	结果行中某一列	1.2

示例

正常返回示例

JSON格式

{
  "requestId": "EB27D183-8F6C-5C5A-A6A3-E0508AF54F78",
  "meta": {
    "affectedRows": 100,
    "elapsedMillisecond": 15,
    "progress": "Complete",
    "count": 1,
    "truncation": {
      "truncated": true,
      "truncatedColumnIndexes": [
        [
          0
        ]
      ]
    }
  },
  "columns": [
    "column1"
  ],
  "columnTypes": [
    "double"
  ],
  "rows": [
    [
      "1.2"
    ]
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。