> For the complete documentation index, see [llms.txt](https://docs.goassay.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goassay.ai/list-your-api/zh/jin-jie/quality-and-sla.md).

# 质量与 SLA

了解失败率承诺，关注已检查调用，并降低违约风险。

失败率承诺规定已检查调用允许失败的频率。控制台称其为 **Failures you promise to stay under**；SLA 指服务级别协议。请作出切实可行的承诺，在失败累积前排查。

{% hint style="info" %}
\*\*开始前：\*\*已有上线的上架项。[查看数据](/list-your-api/zh/ri-chang-shi-yong/see-your-stats.md)说明如何打开 Quality 并查看单次已检查调用。[管理质押](/list-your-api/zh/jin-jie/manage-your-stake.md)解释担保承诺的资金。
{% endhint %}

## 如何衡量质量

检查窗口是一组用于判断单个上架项承诺表现的调用。首次调用开启窗口。检查窗口在已检查调用足以公平判断你的承诺时关闭，或在达到最长期限后关闭。已检查调用过少的窗口不会按承诺判定；单次失败调用仍会退款并记为违规。**Quality** 会显示每个窗口的最低样本量。

失败率是窗口中检查失败的调用数除以全部已检查调用数。只有质量检查结果为通过或失败的调用才计入。跳过检查，或无法公平归因于 API 的结果，不会成为通过的调用来改善比例。成立的客户不良结果问题报告会在流量分配中计入上架项的质量表现，与决定罚没的窗口失败率分开计算；[回应不良结果报告](/list-your-api/zh/ri-chang-shi-yong/answer-a-dispute.md)解释了该流程。

窗口开启时，承诺和衡量规则即固定。修改后的承诺从下个窗口起适用。关闭时，Assay 会考虑样本中的不确定性，再判断高于承诺的失败率是否构成违约。超过页面显示的承诺值得排查，但不会立即扣除质押。

## 操作步骤

{% stepper %}
{% step %}

### 阅读 API 必须达到的承诺

打开 **Listings**，选择工具并打开 **Settings → Your promise**。阅读 **Failures you promise to stay under** 和 **Time we wait for your API**。较慢的回答不付款，并会计入可用性，因此 Assay 可能减少分配给你的调用。它不是已检查调用，不计入决定罚没的失败率。默认失败率承诺是 2%；请检查上架项的实际值。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-e448e53c045db654255fee9212df3eadec083ba0%2Fquality-and-sla-1.png?alt=media" alt="Your promise 卡片，已标出失败率，下方显示 API 响应时限"><figcaption><p>让承诺符合 API 能可靠提供的服务。</p></figcaption></figure>
{% endstep %}

{% step %}

### 关注窗口和证据

打开 **Quality**。结合阅读窗口日期、失败率和已检查调用数。**Recent windows** 记录此前结果。**Who calls this tool** 和 **What failed** 帮助了解失败来源。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-2f71fcd35f7b674f5eae4c56ee94031e76e1bd0f%2Fquality-and-sla-2.png?alt=media" alt="质量警告，显示已检查调用数与窗口最低样本量的对比，并说明调用过少无法判断"><figcaption><p>小样本的高失败率需要关注，但尚不是违约判定。</p></figcaption></figure>

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-ea3668ce2caa061d9ae2f2516cc41ef64a88b39b%2Fquality-and-sla-3.png?alt=media" alt="Quality 证据卡片，按智能体归组已检查调用，已标出 What failed"><figcaption><p>根据证据决定排查什么。</p></figcaption></figure>

筛选 **Checked calls** 和打开结果的控件用法，请参阅[查看数据](/list-your-api/zh/ri-chang-shi-yong/see-your-stats.md#cao-zuo-bu-zhou)。修改 API 前先检查哪条规则失败。按[查看收件箱](/list-your-api/zh/ri-chang-shi-yong/check-your-inbox.md)关注 **Inbox** 中的警告和截止时间。
{% endstep %}

{% step %}

### 继续接收流量前修复原因

将失败检查与 API 日志比较。检查响应时间、必需输出字段、数值，以及自有工具承诺对每个答案执行的检查。轮换密钥时保持身份验证正常。发布连接变更前先测试。

如果无法继续安全提供服务，请按[编辑、暂停或恢复上架](/list-your-api/zh/ri-chang-shi-yong/edit-pause-or-resume-a-listing.md)操作。暂停会停止新流量，本身不增加罚没。它不会移除已提供调用的失败记录或义务。
{% endstep %}
{% endstepper %}

## 确认是否成功

新调用通过相关检查，下个窗口反映出改善。修复不会抹去之前的失败调用。绿色的近期窗口表示遵守承诺；灰色表示已检查调用太少，无法判断；红色记录超出承诺的窗口。单独一条警告与拟议罚没不同。

## 遇到问题时

| 你看到的情况                   | 处理方式                                                                                   |
| ------------------------ | -------------------------------------------------------------------------------------- |
| **Not enough calls yet** | 将失败率视为早期信号。达到最低样本量前，窗口不会导致违约罚没。                                                        |
| 失败率高于承诺                  | 即使样本量不足以罚没，也应立即排查失败调用。                                                                 |
| 检查失败                     | 按[查看数据](/list-your-api/zh/ri-chang-shi-yong/see-your-stats.md)打开调用。修复具体原因，不要靠修改承诺掩盖问题。 |
| 不良结果问题报告                 | 在回复截止时间前按[回应不良结果报告](/list-your-api/zh/ri-chang-shi-yong/answer-a-dispute.md)操作。        |
| 无法加载质量信息                 | 重试。数据缺失不表示失败率为零。                                                                       |

<details>

<summary>可选：修改承诺或响应时限</summary>

在 **Settings → Your promise** 修改百分比或 **Time we wait for your API**，再选择 **Save**。更严格的承诺会打开确认窗口：选择 **Save new promise** 前，阅读罚没风险增加的说明。百分比从下个窗口起生效，不能改写已开启的窗口。新的 **Time we wait for your API** 需要新的通过测试并发布，与价格变更相同；请参阅[编辑、暂停或恢复上架](/list-your-api/zh/ri-chang-shi-yong/edit-pause-or-resume-a-listing.md)。请作出服务在正常负载下能达到的承诺。

</details>

## 进一步了解

* [查看数据](/list-your-api/zh/ri-chang-shi-yong/see-your-stats.md)：已检查调用的筛选方式及各时段的含义。

## 下一步

* [处罚与申诉](/list-your-api/zh/jin-jie/penalties.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.goassay.ai/list-your-api/zh/jin-jie/quality-and-sla.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.