创建评估器。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/evaluators/{agentSpace} HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| agentSpace |
string |
是 |
AgentSpace 名称。 |
prod-agentspace |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体。 |
{"name":"trace_task_completion","displayName":"链路任务完成度","type":"AGENT","metricName":"agent_task_completion","version":"1.0.0"} |
| name |
string |
是 |
评估器名称，不能以系统保留前缀开头，最长 128 字符。 |
trace_task_completion |
| displayName |
string |
否 |
显示名称，最长 128 字符。 |
链路任务完成度 |
| type |
string |
是 |
评估器类型。 枚举值：
|
AGENT |
| description |
string |
否 |
评估器描述，最长 256 字符。 |
判断 Agent 是否完成用户任务 |
| metricName |
string |
是 |
评估指标名称。 |
agent_task_completion |
| version |
string |
是 |
初始版本号。 |
1.0.0 |
| versionDescription |
string |
否 |
版本描述。 |
初始版本 |
| config |
object |
否 |
评估器配置。LLM/AGENT 常包含 prompt、variables、outputSchema；CODE 常包含 codeType、faasConfig、variables、parameters。 |
{"prompt":"请评估任务完成度","variables":[{"name":"input"}]} |
| annotations |
array |
否 |
注解标记列表。 |
["__en"] |
|
string |
否 |
单个注解标记。 |
__en |
|
| properties |
object |
否 |
评估器属性。 |
{"agentEvaluatorMode":"raw_prompt"} |
| clientToken |
string |
否 |
幂等 Token。CloudSpec 声明了该查询参数，当前后端未做幂等比对。 |
a1b2c3d4-1234-5678-90ab-cdef12345678 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求 ID。 |
3FE4CD1E-FF41-56BE-B590-7A021D9C1524 |
| name |
string |
评估器名称。 |
trace_task_completion |
| version |
string |
创建的版本号。 |
1.0.0 |
示例
正常返回示例
JSON格式
{
"requestId": "3FE4CD1E-FF41-56BE-B590-7A021D9C1524",
"name": "trace_task_completion",
"version": "1.0.0"
}