# 任何请求：校验与服务器故障

此类别中的每个代码：其含义、最常见的原因、应如何处理以及由谁处理。

[全部错误代码](https://www.azothos.ai/zh/docs/errors)

### `validation_failed`

- **含义**: 请求的正文或参数与该路由接受的内容不符，因此没有执行任何操作。响应中的 `error` 描述问题；如涉及具体字段，`field` 会指出该字段。
- **最常见的原因**: 缺少必填字段、值的类型错误或超出范围，或使用了未知选项——通常是按旧版 API 编写的客户端。
- **如何处理**: 发送的某个值不被接受。请更正所指出的字段，然后重新发送。
- **由谁处理**: 调用方代码的开发者

### `internal_error`

- **含义**: 请求在 Azoth 一侧失败，原因未在响应中给出：请求本身没有问题。该故障已记录，供 Azoth 团队处理。
- **最常见的原因**: 短暂的数据库或网络问题，或程序缺陷。
- **如何处理**: Azoth 一侧出现了故障。请稍后重试；如果仍然失败，请联系支持团队。
- **由谁处理**: Azoth，或此部署的运营方

### `not_found`

- **含义**: 请求所指的对象在此工作区中不存在——或者存在，但此调用方无权读取。
- **最常见的原因**: 手动输入或取自另一工作区的 ID、此后已删除的项目，或由另一个 API 密钥发出的请求。
- **如何处理**: 在此工作区中未找到具有此 ID 的内容：它可能已被删除，或属于另一个工作区。请重新加载，或检查该 ID。
- **由谁处理**: 工作区的任何成员

### `service_unavailable`

- **含义**: Azoth 无法连接其数据库，因此没有执行任何操作，也没有记录任何内容。
- **最常见的原因**: 在 Azoth 的服务上，是短暂的中断；在您自己的部署上，是其数据库连接尚未配置。
- **如何处理**: 服务当前不可用，未执行任何操作。请稍后重试；如果仍然失败，请联系支持团队或本部署的运维方。
- **由谁处理**: Azoth，或此部署的运营方

### `unknown_tool`

- **含义**: 没有任何助手工具使用此名称。响应中的 `tools` 列出了现有的名称。
- **最常见的原因**: 名称拼写错误，或某个旧名称的过渡期已结束。
- **如何处理**: 没有使用此名称的工具：请使用响应中 tools 下列出的名称之一。
- **由谁处理**: 调用方代码的开发者

### `not_configured`

- **含义**: 此部署缺少该请求所需的一项设置（某个密钥，或某个供应商的账户或密钥），因此未执行任何操作。在设置之前，重试不会改变结果。
- **最常见的原因**: 在 Azoth 的服务上，是 Azoth 团队会修复的配置错误；在您自己的部署上，是其运维方尚未设置的一项设置，服务器日志中会写明其名称。
- **如何处理**: 此功能在本部署上尚未配置，未执行任何操作。请联系支持团队或本部署的运维方：缺少它所需的一项设置。
- **由谁处理**: Azoth，或此部署的运营方

### `migration_missing`

- **含义**: 此功能需要一项尚未应用的数据库更新，因此未执行任何操作。
- **最常见的原因**: 在 Azoth 的服务上，有一项更新尚未应用；在您自己的部署上，其运营方尚未应用最新的数据库更新。
- **如何处理**: 此功能需要一项尚未应用的数据库更新，未执行任何操作。请联系支持团队或本部署的运维方。
- **由谁处理**: Azoth，或此部署的运营方

### `replay_unavailable`

- **含义**: 请求无法重放：Azoth 只保存每个提示的哈希值，从不保存提示本身。
- **最常见的原因**: 针对已保存的追踪请求了重放。
- **如何处理**: 请从您自己的代码中重新发送请求；如需比较模型，请使用参考集。
- **由谁处理**: 调用方代码的开发者

### `action_not_offered`

- **含义**: 此队列项不提供该操作。
- **最常见的原因**: 屏幕显示的是该项较早的状态。
- **如何处理**: 请重新加载队列，然后选择其提供的操作之一。
- **由谁处理**: 工作区的任何成员 · [打开相关页面](https://www.azothos.ai/dashboard/accueil)

### `item_not_waiting`

- **含义**: 此项已不在队列中等待。
- **最常见的原因**: 有人已对其采取行动，或其等待的事项已解决。
- **如何处理**: 请重新加载队列以查看最新状态。
- **由谁处理**: 工作区的任何成员 · [打开相关页面](https://www.azothos.ai/dashboard/accueil)

### `not_allowed`

- **含义**: 您不能对此队列项采取行动。
- **最常见的原因**: 该项在等待另一个人，或是您自己提出的请求（四眼原则）。
- **如何处理**: 请交由其等待的人，或由所有者或管理员处理。
- **由谁处理**: 工作区的任何成员 · [打开相关页面](https://www.azothos.ai/dashboard/accueil)

### `delegate_to_self`

- **含义**: 不能将事项委派给自己。
- **最常见的原因**: 在列表中选择了您自己的名字。
- **如何处理**: 请选择另一位成员。
- **由谁处理**: 工作区的任何成员 · [打开相关页面](https://www.azothos.ai/dashboard/accueil)

### `delegate_not_allowed`

- **含义**: 所选成员不能处理此事项，因此无法委派给他。
- **最常见的原因**: 该成员没有所需角色，或正是提出请求的人。
- **如何处理**: 请选择所有者、管理员，或该事项指明的成员。
- **由谁处理**: 工作区的任何成员 · [打开相关页面](https://www.azothos.ai/dashboard/accueil)

### `worker_secret_invalid`

- **含义**: 部署的某个计划任务或内部路由在未携带其密钥的情况下被调用，因此没有运行任何内容。
- **最常见的原因**: 调用并非来自部署的调度器或其自有工具，或调度器配置的密钥与服务器的不同。
- **如何处理**: 此路由只由部署的调度器携带其密钥调用。如果您运营此部署，请为调度器配置与服务器相同的密钥。
- **由谁处理**: Azoth，或此部署的运营方

### `already_exists`

- **含义**: 请求要添加的内容已存在：所给的名称、地址或值已被占用，因此未添加任何内容。
- **最常见的原因**: 同一表单提交了两次，或该名称或值已被工作区中的其他项使用。
- **如何处理**: 已存在同名或同值的项，因此未添加任何内容。请另选一个，或使用已存在的那个。
- **由谁处理**: 工作区的任何成员

### `operation_in_progress`

- **含义**: 同一操作已在为此工作区运行，因此本次请求未做任何事。
- **最常见的原因**: 双击，或两个人或进程同时启动了它。
- **如何处理**: 此工作区已在执行该操作。请稍等一分钟并重新加载，如仍需要再重试。
- **由谁处理**: 工作区的任何成员

### `method_not_allowed`

- **含义**: 该路由不接受此 HTTP 方法；响应的 `Allow` 头给出它接受的方法。
- **最常见的原因**: 链接或脚本向需要 POST 的路由发送了 GET——例如，退出登录从不通过链接完成。
- **如何处理**: 此操作不能通过链接完成。请使用应用中的对应按钮，或发送该路由接受的方法。
- **由谁处理**: 调用方代码的开发者

### `integration_not_connected`

- **含义**: 此操作所需的集成——GitHub、Slack、Microsoft Teams、单点登录或模型端点——尚未为此工作区设置。
- **最常见的原因**: 它从未连接，或之后已被移除。
- **如何处理**: 此集成尚未为此工作区设置。请由所有者或管理员在“设置”中设置，然后重试。
- **由谁处理**: 工作区的所有者或管理员

### `integration_failed`

- **含义**: 某个集成的服务——GitHub、Slack、Microsoft Teams——拒绝或未能处理 Azoth 发出的请求，因此未执行任何操作。响应给出其 HTTP 状态（`vendorStatus`）和其自身的错误代码（`vendorCode`），从不包含其文本。
- **最常见的原因**: 其应用已被卸载或失去某项权限，所请求的项已不存在，或该服务出现故障。
- **如何处理**: 该集成的服务拒绝了此请求。请确认其应用仍已安装并保有所需权限，然后稍后重试。
- **由谁处理**: 工作区的所有者或管理员
