免费开始 →

参考

错误代码

API 返回和控制台显示的每个错误都带有一个稳定的 code;API 的回答还带有 doc_url,即指向下文对应条目的链接。每个条目说明该代码的含义,并链接到其所属类别页面上的完整说明:最常见的原因、应如何处理以及由谁处理。

错误回答包含的内容

  • error:面向人员的一句话,使用英文。其内容可能变化:切勿在代码中检测它。
  • code:稳定的标识符。请检测这一字段。
  • doc_url:指向本页该代码章节的链接,使用您部署自身的地址。
  • field:对于 validation_failed,指出请求中被拒绝的字段,以点分路径表示。
  • refusal:针对网关拒绝的调用,在开启自带说明的拒绝时提供:阻止了什么、原因、哪条规则及其负责人、合规的选项,并使用调用方的语言。

此处未列出的代码只属于某个页面或某个路由,其消息会说明应如何处理。

访问与登录

查看此类别的全部完整条目

  • session_required — 请求未携带有效会话:它在未登录的情况下访问了仪表板路由。
  • session_expired — 该会话已超过此部署允许的最长会话时长,因此即使仍在刷新也会被拒绝。
  • mfa_challenge_required — 您的账户已启用双因素认证,而此会话尚未完成该认证。
  • workspace_required — 请求未指明其所针对的工作区。
  • forbidden — 您的账户已登录,但无权访问该请求所指的内容。
  • not_a_member — 您已登录,但不是此请求所指工作区的成员。
  • admin_required — 此操作仅限工作区的所有者和管理员。
  • owner_required — 此操作仅限工作区的所有者。
  • mfa_required_by_workspace — 该工作区要求每位成员使用双重身份验证登录。
  • mfa_enrolment_required — 该工作区要求其所有者和管理员在更改角色、保留期限、API 密钥、治理模式或规则之前启用双重身份验证。
  • membership_lookup_failed — Azoth 无法核实您的成员身份,因此选择拒绝,而不是猜测。
  • csrf_origin_mismatch — 该请求来自应用无法识别的网址,为保护您免受跨站请求攻击而被拒绝。
  • second_admin_required — 此操作需要第二个人批准,而该工作区只有一位所有者或管理员。
  • reviewer_must_differ_from_declarant — 授权须由申报人以外的人员审核。
  • email_not_verified — 您的电子邮件地址尚未确认。
  • captcha_failed — 表单的人机验证未通过。
  • invalid_credentials — 该邮箱地址和密码无法打开任何账户。
  • email_domain_not_accepted — 使用一次性邮箱服务地址的注册会被拒绝。
  • professional_use_required — Azoth OS 仅向企业和专业人士提供:只有在声明用于企业或专业活动后才会开立账户。
  • weak_password — 注册因密码过弱而被拒绝。
  • support_access_required — 未经所有者批准,Azoth 的工作人员无法开启对此工作区数据的访问。
  • permission_denied — 您在此工作区中的角色不具备此操作所需的权限。
  • invitee_already_member — 邀请用于将某人加入工作区;它绝不会更改已是成员者的角色。此地址属于一名成员,因此未创建邀请。
  • invite_role_not_allowed — 邀请在被接受时授予其角色,依据的是发送者的权限:可为工作区中除所有者以外的任何角色。所请求的角色不在其中,因此未创建邀请。
  • already_a_member — 您打开了一个您已是成员的工作区的邀请。该邀请已被使用且未做任何更改:您的角色保持不变。
  • org_invitee_already_member — 邀请用于将某人加入组织,绝不会更改已是成员者的角色。此地址属于一名成员,因此未创建邀请。
  • already_an_org_member — 您打开了一个您已是成员的组织的邀请。该邀请已被使用且未做任何更改:您的角色保持不变。
  • feature_disabled — 此路由所属的模块未在本部署中启用。
  • assistant_disabled — 该工作区已关闭其助手:无论在应用内、聊天应用中还是通过 API,都不再有任何内容回答其问题。
  • origin_not_allowed — 浏览器从另一个网站的页面发送了此请求。MCP 端点只响应 MCP 客户端或本部署的页面——绝不响应其他网站的页面,否则这类页面可能借由打开它的人的浏览器访问这些端点。
  • capability_off — 此功能在本部署中运行,工作区的套餐也包含它,但工作区自行将其关闭。
  • cannot_remove_self — 在此处任何人都不能将自己移出工作区:由所有者或管理员移除其他成员。
  • last_owner — 工作区始终至少保留一位所有者:最后一位所有者既不能被移除,也不能更改角色。
  • org_admin_required — 只有组织的管理员才能向其中添加工作区。
  • owner_mfa_first — 要求工作区成员使用双重身份验证,需要您自己的账户先启用它。
  • invite_daily_limit — 今天发送的邀请邮件过多(发往此地址、由您发送或来自此工作区),因此本封未发送。
  • sso_required — 此地址所属组织通过单点登录让成员登录:使用密码的登录、注册或重置均被拒绝。
  • member_not_found — 此工作区中没有使用此 ID 的成员。
  • invite_already_accepted — 此邀请已被接受:一份邀请只能使用一次。
  • invite_expired — 此邀请已过期,无法再接受。
  • invite_email_mismatch — 此邀请发往的电子邮件地址与当前登录账户的不同:只有受邀地址可以接受它。
  • invite_no_longer_valid — 此邀请已失效:发送者已无法再授予邀请中提供的角色。
  • invite_already_pending — 已有一份邀请在等待此地址,因此未创建第二份。
  • account_email_missing — 当前登录的账户没有电子邮件地址,而此操作需要一个:邀请通过其地址接受,测试邮件也发往该地址。
  • org_role_protected — 在组织中,任何人都不能更改自己的角色,所有者的角色也不会被更改或移除。
  • signup_failed — 账户无法创建,注册未说明原因。
  • only_workspace — 这是您账户唯一的工作区,因此不会被单独删除。

API 密钥与调用所代表的人员

查看此类别的全部完整条目

  • api_key_invalid — 随调用发送的 Azoth API 密钥与任何有效密钥都不匹配。
  • api_key_missing — 该调用未携带 Azoth API 密钥。
  • api_key_scope_denied — 该密钥有效,但受到限制——限于某些权限范围(它可调用的 API 部分)、某些连接器或某些环境——而此调用超出了这些限制。在上报时,响应中的 dimension 字段说明是哪项限制拒绝了它:connector 或 environment。
  • api_key_name_taken — 工作区中已有一个有效密钥使用了所请求的名称:同一工作区的两个有效密钥不会同名。
  • api_key_role_denied — 该密钥有效,但其角色(读取、写入或管理)低于此路由的要求:读取密钥不能调用会写入的路由,导出工作区设置需要管理密钥。
  • ip_not_allowed — 该密钥有效,但调用来自工作区 IP 允许列表之外的地址:工作区只接受来自其所列地址的 API 密钥调用。
  • on_behalf_of_not_allowed — 此调用已被阻止:其 API 密钥不能指明调用所代表的人员。
  • human_identity_required — 此调用已被阻止:它没有指明所代表的人员。
  • identity_unavailable — 此调用已被阻止:无法核实其所代表的人员。
  • invalid_on_behalf_of — X-Azoth-On-Behalf-Of 标头不是 Azoth 能读取的人员标识。
  • key_not_bound_to_agent — MCP 网关只响应绑定到某个智能体的 API 密钥——由该智能体的授权决定密钥可以调用什么——而此密钥未绑定任何智能体。
  • invalid_key_identity — 个人密钥始终代表其所有者:它不能再代表其他人。

模型提供商与试用密钥

查看此类别的全部完整条目

网关处的检查

查看此类别的全部完整条目

  • policy_blocked — 此调用被您工作区的一条规则拦截。
  • sovereignty_blocked — 此调用被数据驻留策略拦截。
  • jurisdiction_blocked — 此调用因适用的法律而被阻止。
  • kill_switch_active — 此调用被阻止:紧急停止已开启。
  • kill_switch_unavailable — 此调用被阻止:无法执行紧急停止检查。
  • data_exfiltration_blocked — 此调用被拦截:消息包含机密内容。
  • prompt_injection_blocked — 此调用被阻止:该消息看起来是在试图绕过模型的指令。
  • redaction_failed — 此调用被拦截:无法遮盖其中的个人数据。
  • governance_error — 此调用被阻止:无法执行治理检查。
  • loop_detected — 此调用被阻止:同一调用在循环中重复。
  • tenant_concurrency_limit — 此调用被阻止:同时运行的调用过多。
  • human_review_required — 此调用正在等待人工批准。
  • human_review_not_resumable — 此调用被阻止:它需要人工批准,但无法挂起等待。
  • approval_expired — 此调用未执行:其批准已过期。
  • ungrounded_answer — 此回答未返回:其来源对回答的支持不足。
  • grounding_review_required — 此回答正在等待人工核查。
  • grounding_requires_complete_answer — 此调用被阻止:其回答必须在发送前经过核查。
  • pending — 此请求所等待的审批尚未作出决定:被暂扣的调用尚未运行,被暂扣的回答也不会交付。
  • rejected — 审核人拒绝了此请求所等待的审批:被暂扣的调用永远不会运行,被暂扣的回答永远不会交付。
  • already_executed — 此审批对应的被暂扣调用已经运行过:一次审批只运行其调用一次。
  • already_released — 此审批对应的被暂扣回答已经交付:它只交付一次,随后即被删除。
  • not_requester — 只有发送被暂扣调用的 API 密钥,才能在其获批后运行它。
  • idempotency_key_invalid — Idempotency-Key 请求头为空、过长,或包含不允许的字符。
  • idempotency_key_reused — 一小时内已有调用以另一个正文使用了此 Idempotency-Key:一个密钥只对应一个调用。
  • idempotency_key_in_progress — 使用此 Idempotency-Key 的首次调用尚未应答:在此期间绝不会第二次运行。
  • idempotency_replay_unavailable — 使用此 Idempotency-Key 的首次调用已得到应答,但应答未被保留:重试既得不到该应答,也不会再次调用模型。
  • approval_pending — 此智能体执行所暂停的步骤仍在等待决定:未运行任何内容。
  • approval_rejected — 审核人拒绝了此智能体执行所暂停的步骤:该步骤不会运行,此执行也无法恢复。
  • approval_not_found — 此智能体执行已没有可用于恢复的审批请求。
  • already_resumed — 此执行中已获批的步骤已经运行过:一次审批只运行其步骤一次。
  • execution_not_found — 在此工作区中没有具有此 ID 的智能体执行。
  • not_awaiting_approval — 此智能体执行并未因等待审批而暂停:没有可恢复的内容。
  • agent_plan_invalid — 代理的规划器制定的计划未通过检查,因此没有运行任何内容。响应的 details 列出了未通过的项。

授权:系统与智能体

查看此类别的全部完整条目

预算、套餐限额与公开系统

查看此类别的全部完整条目

适用法律与保留期

查看此类别的全部完整条目

豁免与拒绝所提供的选项

查看此类别的全部完整条目

证明:保全、档案与时间戳

查看此类别的全部完整条目

事件模式

查看此类别的全部完整条目

模型变更与价值风险组合

查看此类别的全部完整条目

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

查看此类别的全部完整条目

  • validation_failed — 请求的正文或参数与该路由接受的内容不符,因此没有执行任何操作。响应中的 error 描述问题;如涉及具体字段,field 会指出该字段。
  • internal_error — 请求在 Azoth 一侧失败,原因未在响应中给出:请求本身没有问题。该故障已记录,供 Azoth 团队处理。
  • not_found — 请求所指的对象在此工作区中不存在——或者存在,但此调用方无权读取。
  • service_unavailable — Azoth 无法连接其数据库,因此没有执行任何操作,也没有记录任何内容。
  • unknown_tool — 没有任何助手工具使用此名称。响应中的 tools 列出了现有的名称。
  • not_configured — 此部署缺少该请求所需的一项设置(某个密钥,或某个供应商的账户或密钥),因此未执行任何操作。在设置之前,重试不会改变结果。
  • migration_missing — 此功能需要一项尚未应用的数据库更新,因此未执行任何操作。
  • replay_unavailable — 请求无法重放:Azoth 只保存每个提示的哈希值,从不保存提示本身。
  • action_not_offered — 此队列项不提供该操作。
  • item_not_waiting — 此项已不在队列中等待。
  • not_allowed — 您不能对此队列项采取行动。
  • delegate_to_self — 不能将事项委派给自己。
  • delegate_not_allowed — 所选成员不能处理此事项,因此无法委派给他。
  • worker_secret_invalid — 部署的某个计划任务或内部路由在未携带其密钥的情况下被调用,因此没有运行任何内容。
  • already_exists — 请求要添加的内容已存在:所给的名称、地址或值已被占用,因此未添加任何内容。
  • operation_in_progress — 同一操作已在为此工作区运行,因此本次请求未做任何事。
  • method_not_allowed — 该路由不接受此 HTTP 方法;响应的 Allow 头给出它接受的方法。
  • integration_not_connected — 此操作所需的集成——GitHub、Slack、Microsoft Teams、单点登录或模型端点——尚未为此工作区设置。
  • integration_failed — 某个集成的服务——GitHub、Slack、Microsoft Teams——拒绝或未能处理 Azoth 发出的请求,因此未执行任何操作。响应给出其 HTTP 状态(vendorStatus)和其自身的错误代码(vendorCode),从不包含其文本。

支持:工单与访问

查看此类别的全部完整条目

单点登录、聊天应用与连接器

查看此类别的全部完整条目

  • sso_oidc_unavailable — 无法连接此地址的身份提供商,因此单点登录无法开始或完成。
  • sso_domain_unverified — 对于工作区尚未证明拥有的域,无法要求单点登录。
  • sso_provider_required — 在工作区未启用任何身份提供商时,无法要求单点登录。
  • sso_type_change — 此工作区已有 SAML 身份提供商:无法在其旁边再保存 OIDC 提供商。
  • oidc_client_secret_required — OIDC 身份提供商需要连同其客户端密钥一起保存。
  • oidc_issuer_invalid — 该签发者不是身份提供商可用的公共 https 地址,因此未保存该提供商。
  • oidc_issuer_multi_tenant — 此签发者服务于众多组织,因此不能用于一个工作区成员的登录。
  • oidc_discovery_failed — 无法读取身份提供商的发现文档,因此未保存该提供商。
  • oidc_discovery_mismatch — 身份提供商的发现文档指明了另一个签发者,或缺少某个端点,因此未保存该提供商。
  • sso_too_many_attempts — 一分钟内来自此网络地址的单点登录返回次数过多,因此本次登录未完成。
  • sso_attempt_expired — 从身份提供商返回的登录并非此浏览器发起的,或耗时过长,因此未打开任何会话。
  • sso_idp_refused — 身份提供商返回时未让此人登录,因此未打开任何会话。
  • sso_provider_unavailable — 工作区的单点登录已不可用,因此登录无法完成。
  • sso_provider_misconfigured — 工作区身份提供商的设置无法用于登录,因此未打开任何会话。
  • sso_token_exchange_failed — 身份提供商拒绝为 Azoth 完成登录,因此未打开任何会话。
  • sso_id_token_invalid — 无法验证提供商发送的身份,因此未打开任何会话。
  • sso_email_domain_mismatch — 身份提供商使用工作区已验证域名之外的邮箱地址(或没有邮箱地址)为此人登录,因此未打开任何会话。
  • sso_email_unverified — 身份提供商未确认已验证该邮箱地址,因此未打开任何会话。
  • dns_lookup_failed — 无法读取该域的 DNS,因此无法检查其所有权。
  • record_not_found — 在该域的 DNS 中未找到证明该域的 TXT 记录。
  • domain_already_verified — 另一个 Azoth 工作区已证明此域:一个域只能登录到一个工作区。
  • domain_changed — 单点登录的域在验证过程中发生了变化,因此未记录任何内容。
  • sso_provider_update_failed — 该域已证明,但向登录服务注册该域失败。
  • sso_provider_delete_failed — 登录服务未移除该工作区的 SAML 身份提供商,因此 Azoth 也未移除任何内容:单点登录保持原样。
  • not_installed — 此 Slack 工作区或 Teams 机器人未连接到 Azoth。
  • chat_identity_mismatch — 此聊天账户不属于您:其平台为它保存的邮箱不是您 Azoth 账户的邮箱,因此未关联任何内容。
  • chat_identity_unverified — 聊天平台未提供此账户的邮箱,因此 Azoth 无法判断其归属:未关联任何内容。
  • chat_identity_unavailable — 聊天平台无法说明此账户属于谁,因此未关联任何内容。
  • teams_secret_required — Teams 机器人需要连同其客户端密钥一起保存。
  • teams_credentials_invalid — Microsoft 拒绝了这些凭据,因此未保存该机器人。
  • teams_app_taken — 此 Teams 机器人已连接到另一个 Azoth 工作区。
  • connector_not_available — 此工作区的套餐不包含连接助手(Claude、ChatGPT)。
  • connectors_disabled — 工作区的所有者或管理员已关闭已连接的助手。
  • missing_token — 调用连接器端点时没有提供访问令牌。
  • invalid_token — 调用连接器端点时使用的访问令牌不被接受:已过期、已撤销、格式错误或为其他地址签发。
  • insufficient_scope — 该访问令牌不具备连接器所需的读取权限。
  • missing_client — 连接请求未指明任何客户端,因此无法连接该助手。
  • unknown_client — 连接请求指明了一个 Azoth 不认识的助手。
  • invalid_redirect_uri — 连接请求的返回地址不是该助手声明过的地址,因此 Azoth 不会向那里发送任何内容。
  • connector_not_installed — 此工作区和环境未安装 Inventory Object 连接器,因此未保存任何内容。
  • connector_revoked — 此连接器已被卸载,因此无法批准:卸载永远不会被撤销。
  • connector_governance_failed — 测试导入期间连接器的治理检查失败,因此未保存测试行。
  • repository_not_found — 此工作区的 GitHub 连接中没有使用此 ID 的代码仓库。

Azoth 团队工具

查看此类别的全部完整条目