> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.agnes-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agnes Sys1 1.0

> 已正式上线的 Agnes Sys1 1.0 决策模型，包含结构化决策接口、输入输出示例、计费规则和内部自测估算成绩。

> [!NOTE]
>
> Agnes Sys1 1.0 已正式上线，可通过 Agnes AI API 接入。模型访问权限和速率限制以账户及 API Key 权限为准；以下响应为格式示例。

## 概述

Agnes Sys1 1.0 是 Agnes AI 的决策模型。通过 `state` 描述当前状态，在 `questions` 中定义需要判断的问题，接口在 `answers` 中按对应名称返回结构化结果，而不是生成聊天回复。

本页示例同时完成客服请求分流与紧急程度判断。可用于工作流路由、意图分类和业务规则辅助判断等接入场景。

| 项目 | 说明 |
| - | - |
| 模型名称 | `agnes-sys1-1.0` |
| 上线状态 | 已正式上线 |
| 请求方式 | `POST` |
| 对外接口 | `https://apihub.agnes-ai.com/v1/systemone` |
| 输入 | 状态文本与命名问题对象 |
| 输出 | `answers` 中的结构化决策结果 |
| 计费方式 | 输入 Token 收费，输出免费 |

## 内部自测估算成绩

> [!NOTE]
>
> 以下数据来自团队提供的内部评估汇总，原始表格中该模型各项结果均标注为“预估”。这些数值不是独立验证的实测结果，不代表 Artificial Analysis 官方测评或公开榜单排名。评测版本、样本量及详细方法尚未公开，实际使用表现可能有所不同。

| Benchmark | 内部自测估算 | 综合分权重 |
| - | -: | -: |
| HLE-MultiChoice | 39.0% | 25% |
| When2Call | 95.2% | 25% |
| WildGuardTest | 93.6% | 25% |
| Omniscience 准确率 | 38.8% | 12.5% |
| Omniscience 非幻觉率 | 73.7% | 12.5% |
| 内部综合折算分 | 71.0 / 100 | 100% |

综合分由以上估算值按表中权重折算，并保留一位小数；不是 AA 官方指数成绩。

## 请求头

使用 Agnes API Key，不要将密钥写入前端代码或公开仓库。

```text theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## 输入参数

下表说明本页示例使用的字段。字段必填性、默认值、数量与长度限制，以当前服务说明为准。

| 字段 | JSON 类型 | 说明 |
| - | - | - |
| `model` | string | 模型标识，使用 `agnes-sys1-1.0`。 |
| `state` | string | 需要判断的当前状态或输入文本。 |
| `questions` | object | 按名称组织的问题定义。示例中一次判断 `route` 和 `urgent` 两个问题。 |
| `questions.<name>.type` | string | 问题类型。本页示例包含 `choice` 和 `noul`。 |
| `questions.<name>.instructions` | string | 当前问题的判断指令。 |
| `questions.<name>.criteria` | object | `choice` 示例中的候选项映射，键为候选项标识，值为候选项说明。 |

### 选择型问题：`choice`

使用 `type: "choice"`，并在 `criteria` 中列出候选项。本例候选项为 `billing`、`technical` 和 `sales`，选择结果通过 `answers.route.choice` 返回。

### 数值型问题：`noul`

本页示例使用 `type: "noul"` 判断用户是否要求尽快处理，在 `answers.urgent.noul` 中返回数值。类型名称须保留为 `noul`，不要自行改写。

> [!NOTE]
>
> 请保留服务返回的 `noul` 原始数值，不要仅凭单条示例推定其取值范围、将其视为已校准概率，或设定固定的业务阈值。业务判断规则应结合正式服务说明进行验证。

## 发起决策请求

使用以下请求体调用专用决策接口 `POST /v1/systemone`，而非 Chat Completions 接口。

```bash theme={null}
curl --request POST 'https://apihub.agnes-ai.com/v1/systemone' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "agnes-sys1-1.0",
  "state": "用户反馈：套餐升级后发票金额不正确，请尽快帮忙核查。",
  "questions": {
    "route": {
      "type": "choice",
      "instructions": "这个请求应该交给哪个团队处理？",
      "criteria": {
        "billing": "账单与费用支持",
        "technical": "技术支持",
        "sales": "销售咨询"
      }
    },
    "urgent": {
      "type": "noul",
      "instructions": "用户是否要求尽快处理？"
    }
  }
}'
```

## 响应示例

以下为响应格式示例。决策结果位于 `answers`，不是 Chat Completions 的 `choices` 对象。

```json theme={null}
{
  "model": "agnes-sys1-1.0",
  "answers": {
    "route": {
      "type": "choice",
      "choice": "billing",
      "probabilities": {
        "billing": 0.9981447473373126,
        "technical": 0.000863275841253645,
        "sales": 0.0009919768214337178
      },
      "confidence": 0.9972171210059689
    },
    "urgent": {
      "type": "noul",
      "noul": 0.9988554807973075
    }
  },
  "usage": {
    "input_tokens": 164,
    "output_tokens": 0
  }
}
```

## 输出字段

| 字段 | JSON 类型 | 说明 |
| - | - | - |
| `model` | string | 服务返回的模型标识。 |
| `answers` | object | 按请求中的问题名称组织的结果对象。 |
| `answers.route.type` | string | 本例为 `choice`。 |
| `answers.route.choice` | string | 被选中的候选项标识，本例为 `billing`。 |
| `answers.route.probabilities` | object | 服务返回的各候选项概率值。 |
| `answers.route.confidence` | number | 服务返回的选择结果置信度分值，客户端应保留原始数值。 |
| `answers.urgent.type` | string | 本例为 `noul`。 |
| `answers.urgent.noul` | number | 当前问题返回的数值结果。 |
| `usage.input_tokens` | integer | 服务报告的输入 Token 用量，本例为 `164`。 |
| `usage.output_tokens` | integer | 服务报告的输出 Token 用量，本例为 `0`。 |

按问题名称读取结果：`answers.route.choice` 用于获取选中的处理团队，`answers.urgent.noul` 用于获取数值结果。不要解析自然语言正文或 `message.content`。

本例选中 `billing`，对应“账单与费用支持”。`confidence` 为独立返回字段，不要直接用候选项中的最大概率替代。

## 定价

以下为国际站美元刊例价。`M` 表示一百万 Token。

| 计费项 | 刊例价 |
| - | -: |
| 输入 Token | `$0.03 / 百万 Token` |
| 输出 | 免费 |

输入费用 = 服务报告的输入 Token 数 ÷ 1,000,000 × `$0.03`

结构化决策结果不收取输出费用。示例中的输出 Token 用量为 `0`，不代表没有决策结果；实际结果仍通过 `answers` 读取。

> [!NOTE]
>
> 输入 Token 的统计范围、账户可用性和最终计费细则，以正式服务说明及账户账单为准。

## 接入检查清单

* `model` 使用 `agnes-sys1-1.0`。
* 使用 `state` 和 `questions`，不改成聊天模型的 `messages` 等字段。
* 请求问题名称与 `answers` 中的结果键保持对应。
* 保留 `choice`、`noul` 原始类型名称。
* 记录请求用量时保留 `usage`。
* 确认账户访问权限，并结合当前服务说明验证数值判断规则。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.