AiHummer
中文▾
登录帐户
v1.6.x▾
{ }Swagger

错误代码

v1.6.x · 已更新 2026-11-15

每个 AiHummer API 错误都带有一个 稳定的机器代码 以……的形式 AIH-<DOMAIN>-<NNNN>导线形状为:

{ "error": { "code": "AIH-AUTH-0001",
             "message": "invalid login or password",
             "message_key": "err.auth.invalid_credentials",
             "details": { } } }

code 是稳定的(从不重复使用或重新编号); message 是一个人类的英语字符串; message_key 是客户用来本地化的 i18n 键; details 是可选的结构化上下文。

计费/计划权限错误(显示 402 “需要升级”)是 不 列在这里 — 见 许可与计费.

常见

每个服务都共有的跨切面错误(请求格式、方法、认证、内部故障)。当有合适的情况时,优先使用特定领域的代码。

代码 HTTP 意义 i18n 键 典型原因
AIH-COMMON-0001 405 方法不被允许 err.common.method_not_allowed 此路由不允许使用该 HTTP 方法。
AIH-COMMON-0002 400 请求体无效 err.common.invalid_body 请求输入格式错误、不完整或无效。
AIH-COMMON-0003 400 必填字段缺失 err.common.missing_field 请求输入格式错误、不完整或无效。
AIH-COMMON-0004 500 内部错误 err.common.internal 意外的内部故障。
AIH-COMMON-0005 404 未找到 err.common.not_found 引用的对象不存在或超出范围。
AIH-COMMON-0006 403 禁止 err.common.forbidden 该资源属于另一个租户/所有者/会话。
AIH-COMMON-0007 501 功能未启用 err.common.not_enabled 该功能/集成已关闭或未配置。
AIH-COMMON-0008 401 未经授权 err.common.unauthorized 缺失或无效的凭证。
AIH-COMMON-0009 400 验证失败 err.common.validation 请求输入格式错误、不完整或无效。
AIH-COMMON-0010 409 冲突 err.common.conflict 与当前状态冲突。
AIH-COMMON-0011 429 超出速率限制 err.common.rate_limited 请求过多 / 超过配置的预算。
AIH-COMMON-0012 502 上游错误 err.common.upstream 上游/提供方调用失败。

认证

管理员本地认证:登录、会话、密码更改、用户管理、双因素认证。

代码 HTTP 意义 i18n 键 典型原因
AIH-AUTH-0001 401 无效的登录名或密码 err.auth.invalid_credentials 缺失或无效的凭证。
AIH-AUTH-0002 429 尝试次数过多,请稍后再试 err.auth.too_many_attempts 请求过多 / 超过配置的预算。
AIH-AUTH-0003 401 未认证 err.auth.not_authenticated 缺失或无效的凭证。
AIH-AUTH-0004 501 未启用本地身份验证 err.auth.local_disabled 该功能/集成已关闭或未配置。
AIH-AUTH-0005 403 当前密码错误 err.auth.wrong_current_password 该资源属于另一个租户/所有者/会话。
AIH-AUTH-0006 409 你无法删除你自己的账户 err.auth.cannot_delete_self 与当前状态冲突。
AIH-AUTH-0007 500 无法创建会话 err.auth.session_failed 意外的内部故障。
AIH-AUTH-0008 501 未启用两步验证 err.auth.twofa_disabled 该功能/集成已关闭或未配置。
AIH-AUTH-0009 401 挑战已过期 — 请重新登录 err.auth.twofa_challenge_expired 缺失或无效的凭证。
AIH-AUTH-0010 401 无效代码 err.auth.twofa_invalid_code 缺失或无效的凭证。
AIH-AUTH-0011 401 无效的恢复码 err.auth.twofa_invalid_recovery 缺失或无效的凭证。
AIH-AUTH-0012 401 二次验证失败 err.auth.twofa_verify_failed 缺失或无效的凭证。
AIH-AUTH-0013 400 未注册匹配的第二因素 err.auth.twofa_not_enrolled 请求输入格式错误、不完整或无效。
AIH-AUTH-0014 400 无效或已过期的重置令牌 err.auth.reset_token_invalid 请求输入格式错误、不完整或无效。
AIH-AUTH-0015 403 请先设置您自己的密码 err.auth.password_change_required —
AIH-AUTH-0016 400 新密码必须与当前密码不同 err.auth.password_unchanged —

代理

AI 员工(代理)CRUD、版本、克隆以及每个代理的系统提示配置文件。

代码 HTTP 意义 i18n 键 典型原因
AIH-AGENT-0001 501 代理未启用 err.agent.not_enabled 该功能/集成已关闭或未配置。
AIH-AGENT-0002 404 未找到代理 err.agent.not_found 引用的对象不存在或超出范围。
AIH-AGENT-0003 403 不是你的代理 err.agent.forbidden 该资源属于另一个租户/所有者/会话。
AIH-AGENT-0004 501 未启用代理配置文件 err.agent.profile_not_enabled 该功能/集成已关闭或未配置。
AIH-AGENT-0005 404 未找到共享部分 err.agent.section_not_found 引用的对象不存在或超出范围。
AIH-AGENT-0006 403 不是你共享的部分 err.agent.section_forbidden 该资源属于另一个租户/所有者/会话。
AIH-AGENT-0007 400 未知的部分类型 err.agent.unknown_section_kind 请求输入格式错误、不完整或无效。
AIH-AGENT-0008 403 该代理不允许使用此工具 err.agent.tool_not_permitted 该资源属于另一个租户/所有者/会话。
AIH-AGENT-0009 403 子代理深度限制已到 err.agent.subagent_depth_exceeded 该资源属于另一个租户/所有者/会话。
AIH-AGENT-0010 403 此处无法交接 err.agent.handoff_unavailable 该资源属于另一个租户/所有者/会话。
AIH-AGENT-0011 500 工具调用失败 err.agent.tool_failed 意外的内部故障。
AIH-AGENT-0012 400 交接需要“代理”和“任务” err.agent.handoff_invalid_args 请求输入格式错误、不完整或无效。
AIH-AGENT-0013 404 没有那个名字的代理 err.agent.handoff_target_not_found 引用的对象不存在或超出范围。
AIH-AGENT-0014 400 未提供任务 err.agent.subagent_no_tasks 请求输入格式错误、不完整或无效。
AIH-AGENT-0015 403 工具在此托管 AiHummer Cloud 实例上不可用 err.agent.tool_cloud_restricted —
AIH-AGENT-0016 409 打开卡片后,此 AI 员工已在其他地方被修改。请重新打开卡片后再次保存。 err.agent.revision_conflict —
AIH-AGENT-0017 400 没有已启用的模型提供方提供此模型。请从列表中选择,或在“模型”页面启用其提供方。 err.agent.model_not_served —
AIH-AGENT-0018 400 访问规则指定了此工作区中不存在的人员或智能体。 err.agent.interaction_unknown_grant —
AIH-AGENT-0019 400 子智能体的禁令指定了此实例上不存在的工具。 err.agent.interaction_unknown_tool —
AIH-AGENT-0020 400 所选提供方已停用、已删除或不提供此模型。请选择其他提供方或“任意提供方”。 err.agent.model_provider_invalid —
AIH-AGENT-0021 400 一个代理最多可有 8 个自己的备用模型。请先移除一个再添加。 err.agent.too_many_spares —

API密钥

用于编程网关访问的 API 密钥:密钥子系统未配置。

代码 HTTP 意义 i18n 键 典型原因
AIH-APIKEY-0001 501 未配置 API 密钥 err.apikey.not_configured 该功能/集成已关闭或未配置。

批准

人工干预审批队列:审批功能已关闭。

代码 HTTP 意义 i18n 键 典型原因
AIH-APPROVAL-0001 501 未启用审批 err.approval.not_enabled 该功能/集成已关闭或未配置。
AIH-APPROVAL-0002 409 请求已过期:没有人及时作出决定,因此该调用已被拒绝。如果仍然需要,代理会再次请求。 err.approval.expired —

人工制品

对话产物(文档 + 可运行代码):代码执行关闭、缺少产物/版本、类型错误或运行器输出错误。

代码 HTTP 意义 i18n 键 典型原因
AIH-ARTIFACT-0001 501 未启用代码执行 err.artifact.exec_disabled 该功能/集成已关闭或未配置。
AIH-ARTIFACT-0002 404 未找到工件 err.artifact.not_found 引用的对象不存在或超出范围。
AIH-ARTIFACT-0003 404 未找到工件版本 err.artifact.version_not_found 引用的对象不存在或超出范围。
AIH-ARTIFACT-0004 400 工件不是代码 err.artifact.not_code 请求输入格式错误、不完整或无效。
AIH-ARTIFACT-0005 500 运行器输出错误 err.artifact.bad_runner_output 意外的内部故障。
AIH-ARTIFACT-0006 400 类型必须是文档或代码 err.artifact.invalid_kind 请求输入格式错误、不完整或无效。

备份

来自管理界面的数据库备份。

代码 HTTP 意义 i18n 键 典型原因
AIH-BACKUP-0001 501 数据库 URL 未为备份配置 err.backup.not_configured 该功能/集成已关闭或未配置。
AIH-BACKUP-0002 500 备份失败 err.backup.failed 意外的内部故障。

批次

批量请求处理。

代码 HTTP 意义 i18n 键 典型原因
AIH-BATCH-0001 501 未启用批处理 err.batch.not_enabled 该功能/集成已关闭或未配置。
AIH-BATCH-0002 404 未找到批次 err.batch.not_found 引用的对象不存在或超出范围。

预算

使用计量和模型支出预算。

代码 HTTP 意义 i18n 键 典型原因
AIH-BUDGET-0001 501 未启用使用量计量 err.budget.usage_not_enabled 该功能/集成已关闭或未配置。
AIH-BUDGET-0002 501 未启用预算 err.budget.not_enabled 该功能/集成已关闭或未配置。

自带密钥

自带密钥:租户提供的模型供应商密钥。

代码 HTTP 意义 i18n 键 典型原因
AIH-BYOK-0001 501 未配置 BYOK err.byok.not_configured 该功能/集成已关闭或未配置。

改变

变更记录和变更审批工作流程。

代码 HTTP 意义 i18n 键 典型原因
AIH-CHANGE-0001 404 未找到更改 err.change.not_found 引用的对象不存在或超出范围。
AIH-CHANGE-0002 403 不允许自我审批:需要不同的审批人 err.change.self_approval_forbidden 该资源属于另一个租户/所有者/会话。

聊天

OpenAI兼容的聊天完成端点。线形保持OpenAI兼容,同时添加了一个稳定的代码。

代码 HTTP 意义 i18n 键 典型原因
AIH-CHAT-0001 501 OpenAI 兼容端点已禁用 err.chat.disabled 该功能/集成已关闭或未配置。
AIH-CHAT-0002 401 无效的 API 密钥 err.chat.invalid_key 缺失或无效的凭证。
AIH-CHAT-0003 400 无效的聊天请求 err.chat.invalid_request 请求输入格式错误、不完整或无效。
AIH-CHAT-0004 429 费率或预算限制已超出 err.chat.rate_limited 请求过多 / 超过配置的预算。
AIH-CHAT-0005 502 聊天轮次失败 err.chat.turn_failed 上游/提供方调用失败。
AIH-CHAT-0006 500 聊天完成失败 err.chat.internal 意外的内部故障。
AIH-CHAT-0007 503 尚未配置 AI 模型提供程序 - 在模型部分添加一个 err.chat.no_llm_provider —

连接

集成 OAuth 连接:连接票据、授权步骤和令牌交换。

代码 HTTP 意义 i18n 键 典型原因
AIH-CONNECTION-0001 400 无效或已过期的连接票 err.connection.ticket_invalid 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0002 400 插件未声明 OAuth 流程 err.connection.no_oauth_flow 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0003 400 此插件未配置 OAuth 客户端 err.connection.oauth_client_not_configured 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0004 400 授权被拒 err.connection.auth_denied 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0005 400 缺少代码或状态 err.connection.missing_code_or_state 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0006 400 无效或已过期的状态 err.connection.state_invalid 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0007 400 插件 OAuth 配置不可用 err.connection.oauth_config_unavailable 请求输入格式错误、不完整或无效。
AIH-CONNECTION-0008 502 令牌交换失败 err.connection.token_exchange_failed 上游/提供方调用失败。
AIH-CONNECTION-0009 500 无法存储令牌 err.connection.store_token_failed 意外的内部故障。

凭证

每用户凭证库操作。

代码 HTTP 意义 i18n 键 典型原因
AIH-CREDENTIAL-0001 501 未启用凭据库 err.credential.vault_not_enabled 该功能/集成已关闭或未配置。
AIH-CREDENTIAL-0002 400 凭证操作失败 err.credential.vault_error 请求输入格式错误、不完整或无效。

设备

该设备桥接到设备上的配套应用程序。

代码 HTTP 意义 i18n 键 典型原因
AIH-DEVICE-0001 503 设备服务不可用 err.device.service_unavailable 一个依赖的服务暂时不可用。

事件

用于管理员 UI 和客户端的服务器事件流 (SSE)。

代码 HTTP 意义 i18n 键 典型原因
AIH-EVENTS-0001 500 不支持流式传输 err.events.streaming_unsupported 意外的内部故障。

事实

关于用户的长期记忆事实。

代码 HTTP 意义 i18n 键 典型原因
AIH-FACT-0001 404 未找到事实 err.fact.not_found 引用的对象不存在或超出范围。
AIH-FACT-0002 403 不是用户事实 err.fact.not_user_fact 该资源属于另一个租户/所有者/会话。
AIH-FACT-0003 409 该事实的状态不允许此操作:只能批准候选事实,只能拒绝候选事实或已批准的事实。请刷新列表。 err.fact.status_conflict —

图表

代理图:声明式多代理编排。

代码 HTTP 意义 i18n 键 典型原因
AIH-GRAPH-0001 501 未启用代理图 err.graph.not_enabled 该功能/集成已关闭或未配置。
AIH-GRAPH-0002 404 未找到图表 err.graph.not_found 引用的对象不存在或超出范围。
AIH-GRAPH-0003 403 不是你的图表 err.graph.forbidden 该资源属于另一个租户/所有者/会话。
AIH-GRAPH-0004 501 在此部署中无法使用图形执行 err.graph.exec_unavailable 该功能/集成已关闭或未配置。

护栏

代理的内容/行为边界规则。

代码 HTTP 意义 i18n 键 典型原因
AIH-GUARDRAIL-0001 501 未配置护栏 err.guardrail.not_configured 该功能/集成已关闭或未配置。

入站

通用入站 webhook/摄取端点:通道→网关消息摄取。

代码 HTTP 意义 i18n 键 典型原因
AIH-INBOUND-0001 401 未经授权 err.inbound.unauthorized 缺失或无效的凭证。
AIH-INBOUND-0002 400 无效的入站负载 err.inbound.invalid_payload 请求输入格式错误、不完整或无效。
AIH-INBOUND-0003 500 入站调度失败 err.inbound.dispatch_failed 意外的内部故障。
AIH-INBOUND-0004 503 服务器繁忙:消息已保存,但尚未处理。请使用相同的消息 ID 重试。 err.inbound.server_busy —

爱枕

管理员访问 IP 允许列表。

代码 HTTP 意义 i18n 键 典型原因
AIH-IPALLOW-0001 501 未配置 IP 白名单 err.ipallow.not_configured 该功能/集成已关闭或未配置。

千字节

知识库连接器:RAG 功能关闭、存储的连接器配置损坏,或上传的归档文件有问题。

代码 HTTP 意义 i18n 键 典型原因
AIH-KB-0001 501 未启用知识库 err.kb.not_enabled 该功能/集成已关闭或未配置。
AIH-KB-0002 500 存储的配置损坏 err.kb.config_corrupt 意外的内部故障。
AIH-KB-0003 400 无效的知识档案 err.kb.invalid_archive 请求输入格式错误、不完整或无效。
AIH-KB-0004 413 附件超出允许的最大值大小 err.session.attachment_too_large —
AIH-KB-0005 413 附件超出允许的最大值大小 err.session.attachment_too_large —

许可证

实例许可:应用已签署的许可证。

代码 HTTP 意义 i18n 键 典型原因
AIH-LICENSE-0001 501 未启用许可 err.license.not_enabled 该功能/集成已关闭或未配置。
AIH-LICENSE-0002 400 无效的许可证 err.license.invalid 请求输入格式错误、不完整或无效。
AIH-LICENSE-0003 409 此许可证需要已签名的安装实例授权。请向供应商索取最新的许可证包。 err.license.grant_required —

大型语言模型

在产品内“连接 Codex(ChatGPT 订阅)”设备授权流程中。

代码 HTTP 意义 i18n 键 典型原因
AIH-LLM-0001 501 Codex 连接不可用:秘密库 (AIHUMMER_MASTER_KEY) 未配置 err.llm.codex_connect_disabled 该功能/集成已关闭或未配置。
AIH-LLM-0002 502 无法启动 Codex 设备授权流程 err.llm.codex_connect_start_failed 上游/提供方调用失败。
AIH-LLM-0003 500 无法清除已存储的 Codex 连接 err.llm.codex_disconnect_failed 意外的内部故障。
AIH-LLM-0004 501 未配置模型提供程序 err.llm.providers_not_configured —
AIH-LLM-0005 404 未找到模型提供程序 err.llm.provider_not_found —
AIH-LLM-0006 400 模型提供程序配置无效 err.llm.provider_invalid —
AIH-LLM-0007 502 提供商测试失败 err.llm.provider_test_failed —
AIH-LLM-0008 501 提供商测试不可用 err.llm.provider_test_unavailable —
AIH-LLM-0009 502 OpenAI 无法从服务器区域使用 - 需要在允许区域中的出站代理。联系支持人员。 err.llm.region_blocked —
AIH-LLM-0010 501 此实例不支持连接 Claude 订阅 err.llm.claude_connect_disabled —
AIH-LLM-0011 502 无法连接 Claude 订阅 err.llm.claude_connect_failed —
AIH-LLM-0012 500 无法清除存储的 Claude 订阅连接 err.llm.claude_disconnect_failed —
AIH-LLM-0013 400 此账户不提供该模型:请从账户的模型列表中选择。 err.llm.provider_model_not_in_catalog —

市场

插件市场安装路径:在异步部署之前,将根据目录验证 slug。

代码 HTTP 意义 i18n 键 典型原因
AIH-MARKETPLACE-0001 404 未知模块:不在目录中 err.marketplace.unknown_module 引用的对象不存在或超出范围。

媒体

媒体 blob 获取/流端点:签名令牌媒体访问。

代码 HTTP 意义 i18n 键 典型原因
AIH-MEDIA-0001 404 未找到媒体 err.media.not_found 引用的对象不存在或超出范围。
AIH-MEDIA-0002 403 无效或已过期的媒体令牌 err.media.token_invalid 该资源属于另一个租户/所有者/会话。
AIH-MEDIA-0003 503 未配置视频理解 err.media.video_not_configured 一个依赖的服务暂时不可用。

记忆

长期记忆(爱因斯坦)管理界面:内存后端未连接。

代码 HTTP 意义 i18n 键 典型原因
AIH-MEMORY-0001 501 内存未配置 err.memory.not_configured 该功能/集成已关闭或未配置。
AIH-MEMORY-0002 404 未找到该矛盾,请刷新列表。 err.memory.contradiction_not_found —
AIH-MEMORY-0003 409 该矛盾已被解决或重新打开,请刷新列表。 err.memory.contradiction_conflict —
AIH-MEMORY-0004 409 记忆检查已在进行中。请等待其完成。 err.memory.quality_busy —
AIH-MEMORY-0005 404 该修复已不存在,请刷新页面。 err.memory.quality_fix_not_found —
AIH-MEMORY-0006 409 无法撤销该修复:它已被撤销,或事实在其后已更改。 err.memory.quality_fix_conflict —

模型访问

模型访问规则(哪些模型对哪些用户/代理可用)。

代码 HTTP 意义 i18n 键 典型原因
AIH-MODELACCESS-0001 501 未配置模型访问 err.modelaccess.not_configured 该功能/集成已关闭或未配置。

模块

插件/模块市场控制界面:功能关闭、缺少来源/安装、所有权问题或加载的侧载文件格式错误。

代码 HTTP 意义 i18n 键 典型原因
AIH-MODULE-0001 501 市场未启用 err.module.not_enabled 该功能/集成已关闭或未配置。
AIH-MODULE-0002 404 未找到源 err.module.source_not_found 引用的对象不存在或超出范围。
AIH-MODULE-0003 404 未找到安装 err.module.installation_not_found 引用的对象不存在或超出范围。
AIH-MODULE-0004 403 不是你的安装 err.module.installation_forbidden 该资源属于另一个租户/所有者/会话。
AIH-MODULE-0005 501 插件上传已禁用(没有 Blob 存储) err.module.upload_disabled 该功能/集成已关闭或未配置。
AIH-MODULE-0006 400 无效的插件上传包 err.module.invalid_bundle 请求输入格式错误、不完整或无效。
AIH-MODULE-0007 403 官方目录源不能是禁用或删除 err.module.source_protected —
AIH-MODULE-0008 403 此模块是产品的内置部分,无法删除或停止 err.module.builtin_protected —
AIH-MODULE-0009 409 此插件请求您在安装之前需要审核和批准的权限 err.module.consent_required —
AIH-MODULE-0010 400 该插件请求访问它未在其功能清单中声明的权限 err.module.capability_violation —
AIH-MODULE-0011 410 此模块已停用:其功能已内置于产品核心,因此无法再安装 err.module.retired —

配对

设备配对(二维码兑换)、设备会话验证、绑定状态。

代码 HTTP 意义 i18n 键 典型原因
AIH-PAIRING-0001 400 需要配对码 err.pairing.code_required 请求输入格式错误、不完整或无效。
AIH-PAIRING-0002 401 无效或已过期的配对码 err.pairing.invalid_code 缺失或无效的凭证。
AIH-PAIRING-0003 401 不良入站秘密 err.pairing.bad_inbound_secret 缺失或无效的凭证。
AIH-PAIRING-0004 400 必填字段缺失 err.pairing.field_required 请求输入格式错误、不完整或无效。
AIH-PAIRING-0005 401 无效或已过期的会话 err.pairing.session_invalid 缺失或无效的凭证。
AIH-PAIRING-0006 400 需要令牌 err.pairing.token_required 请求输入格式错误、不完整或无效。
AIH-PAIRING-0007 401 配对码已过期 - 生成新的二维码并重新扫描。 err.pairing.code_expired —
AIH-PAIRING-0008 401 此配对码已被使用 - 生成新的二维码。 err.pairing.code_used —
AIH-PAIRING-0009 403 此设备绑定已停用 - 在 AiHummer 管理 UI 中重新启用它,然后重试。 err.pairing.binding_inactive —

操场

提示/模型游乐场。

代码 HTTP 意义 i18n 键 典型原因
AIH-PLAYGROUND-0001 501 未启用 Playground err.playground.not_enabled 该功能/集成已关闭或未配置。

提示

提示/模板库。

代码 HTTP 意义 i18n 键 典型原因
AIH-PROMPT-0001 501 未配置提示库 err.prompt.not_configured 该功能/集成已关闭或未配置。
AIH-PROMPT-0002 404 未找到模板 err.prompt.template_not_found 引用的对象不存在或超出范围。

推

通过供应商推送中继的移动推送通知(实例不持有供应商凭证)。

代码 HTTP 意义 i18n 键 典型原因
AIH-PUSH-0001 503 推送中继不可用(供应商推送服务不可用 / 实例未注册) err.push.relay_unavailable 一个依赖的服务暂时不可用。
AIH-PUSH-0002 502 推送中继传递失败 err.push.relay_failed 上游/提供方调用失败。

再生

响应再生(再生)。

代码 HTTP 意义 i18n 键 典型原因
AIH-REGEN-0001 501 未启用再生 err.regen.not_enabled 该功能/集成已关闭或未配置。

安全断言标记语言

SAML 单点登录

代码 HTTP 意义 i18n 键 典型原因
AIH-SAML-0001 501 SAML不可用 err.saml.not_available 该功能/集成已关闭或未配置。
AIH-SAML-0002 400 断言缺少主语 err.saml.assertion_invalid 请求输入格式错误、不完整或无效。

时间表

定时/延迟消息发送。

代码 HTTP 意义 i18n 键 典型原因
AIH-SCHEDULE-0001 404 未找到时间表 err.schedule.not_found 引用的对象不存在或超出范围。
AIH-SCHEDULE-0002 409 计划暂时无法启用:部分条件尚未满足 err.schedule.blocked —
AIH-SCHEDULE-0003 409 阻止需通过“解除阻止”操作移除,而不是编辑数据 err.schedule.unblock_required —
AIH-SCHEDULE-0004 400 请选择接收方:该计划有投递渠道,但未指定聊天 err.schedule.recipient_required —
AIH-SCHEDULE-0006 409 计划任务中的服务器命令已关闭。所有者或管理员可以在「系统和设置 → 计划任务」中开启。 err.schedule.commands_off —
AIH-SCHEDULE-0007 409 这条确切的命令不在允许的命令中。所有者或管理员可以在「系统和设置 → 计划任务」中添加。 err.schedule.command_not_allowed —
AIH-SCHEDULE-0008 400 此聊天无法接收计划消息:网页聊天和 API 会话没有外发投递。请选择即时通讯聊天。 err.schedule.recipient_undeliverable —

系统跨域身份管理

SCIM 用户配置。

代码 HTTP 意义 i18n 键 典型原因
AIH-SCIM-0001 501 未启用 SCIM err.scim.not_enabled 该功能/集成已关闭或未配置。

秘密

每租户秘密库:主密钥不存在,或指定的秘密不存在。

代码 HTTP 意义 i18n 键 典型原因
AIH-SECRET-0001 501 未配置秘密 err.secret.not_configured 该功能/集成已关闭或未配置。
AIH-SECRET-0002 404 未找到秘密 err.secret.not_found 引用的对象不存在或超出范围。

情感

对话分析:情绪和质量。

代码 HTTP 意义 i18n 键 典型原因
AIH-SENTIMENT-0001 501 未启用会话分析 err.sentiment.not_enabled 该功能/集成已关闭或未配置。
AIH-SENTIMENT-0002 404 尚未分析 err.sentiment.not_analyzed 引用的对象不存在或超出范围。
AIH-SENTIMENT-0003 422 无法分析对话 err.sentiment.unprocessable 请求有效,但内容无法处理。

会话

会话/消息管理界面:功能关闭,或会话/消息不是调用者的。

代码 HTTP 意义 i18n 键 典型原因
AIH-SESSION-0001 501 未启用对话 err.session.not_enabled 该功能/集成已关闭或未配置。
AIH-SESSION-0002 403 不是你的谈话 err.session.conversation_forbidden 该资源属于另一个租户/所有者/会话。
AIH-SESSION-0003 403 不是你的消息 err.session.message_forbidden 该资源属于另一个租户/所有者/会话。
AIH-SESSION-0004 413 附件超出允许的最大值大小 err.session.attachment_too_large —
AIH-SESSION-0005 404 找不到附件 err.session.attachment_not_found —
AIH-SESSION-0006 502 消息未送达渠道 err.session.operator_reply_undelivered —
AIH-SESSION-0007 409 此消息不是应用聊天中的智能体回复 err.session.not_app_reply —
AIH-SESSION-0008 503 此实例不支持向应用投递 err.session.app_delivery_unavailable —
AIH-SESSION-0009 503 「AiHummer 应用」模块未运行 — 请在「插件」页面启动它,然后重新投递 err.session.app_module_not_running —

技能

代理技能:图书馆和所有权。

代码 HTTP 意义 i18n 键 典型原因
AIH-SKILL-0001 501 技能未启用 err.skill.not_enabled 该功能/集成已关闭或未配置。
AIH-SKILL-0002 404 未找到技能 err.skill.not_found 引用的对象不存在或超出范围。
AIH-SKILL-0003 403 不是你的技能 err.skill.forbidden 该资源属于另一个租户/所有者/会话。

技能提升

技能优化器:技能提升建议。

代码 HTTP 意义 i18n 键 典型原因
AIH-SKILLOPT-0001 501 未启用技能优化器 err.skillopt.not_enabled 该功能/集成已关闭或未配置。
AIH-SKILLOPT-0002 404 未找到提案 err.skillopt.proposal_not_found 引用的对象不存在或超出范围。
AIH-SKILLOPT-0003 403 不是你的提议 err.skillopt.proposal_forbidden 该资源属于另一个租户/所有者/会话。

系统

主机系统操作:日志和自我更新。

代码 HTTP 意义 i18n 键 典型原因
AIH-SYSTEM-0001 501 此主机上不可用日志 err.system.logs_unavailable 该功能/集成已关闭或未配置。
AIH-SYSTEM-0002 501 未配置自我更新;请运行 sudo aihummer update 在主机上 err.system.update_not_configured 该功能/集成已关闭或未配置。
AIH-SYSTEM-0003 501 此主机不支持安装边车服务,请在主机上使用 --sidecar &lt;名称&gt; 运行已签名的安装程序。 err.system.sidecar_not_configured —
AIH-SYSTEM-0004 501 此服务器无法从面板重启自己。保存的值将在服务器下次重启时生效 — 请让负责这台服务器的人重启,或者在你的主机服务商的控制面板里重启它。 err.system.restart_not_configured —

用户

工作区用户和角色管理。

代码 HTTP 意义 i18n 键 典型原因
AIH-USER-0001 409 你无法更改自己的角色 err.user.cannot_change_own_roles 与当前状态冲突。
AIH-USER-0002 409 无法移除最后一个所有者 err.user.cannot_remove_last_owner 与当前状态冲突。

声音

语音回合端点 (/v1/voice/turn):SIP 桥 → 网关音频转发界面。

代码 HTTP 意义 i18n 键 典型原因
AIH-VOICE-0001 502 无法解析对话 err.voice.resolve_failed 上游/提供方调用失败。
AIH-VOICE-0002 502 语音切换失败 err.voice.turn_failed 上游/提供方调用失败。

WEBCONN

Admin Sessions 后端:浏览器会话和 SSE 聊天。SSE 流中的错误事件不属于此错误格式。

代码 HTTP 含义 i18n 键 常见原因
AIH-WEBCONN-0001 403 对话不属于你的会话 err.webconn.forbidden 该资源属于另一个租户、所有者或会话。
AIH-WEBCONN-0002 500 不支持流式传输 err.webconn.streaming_unsupported 发生了意外故障。
AIH-WEBCONN-0003 409 此 AI 员工的应用设置已损坏。所有者可以在代理资料中修复:「上下文与行为」→「AiHummer 应用」。 err.webconn.app_policy_invalid —
AIH-WEBCONN-0004 404 未找到 err.common.not_found —

网络钩子

实例事件的出站 Webhook。

代码 HTTP 意义 i18n 键 典型原因
AIH-WEBHOOK-0001 501 未启用 Webhook err.webhook.not_enabled 该功能/集成已关闭或未配置。
AIH-WEBHOOK-0002 404 未找到 Webhook err.webhook.not_found 引用的对象不存在或超出范围。

工作区

工作区所有权/范围:代理租户在其不拥有的工作区上操作。

代码 HTTP 意义 i18n 键 典型原因
AIH-WORKSPACE-0001 403 不是你的工作区 err.workspace.forbidden 该资源属于另一个租户/所有者/会话。
AIH-WORKSPACE-0002 404 找不到工作区 err.workspace.not_found —
AIH-WORKSPACE-0003 409 无法删除最后一个工作区 err.workspace.cannot_delete_last —

ZAPIER

Zapier 连接器的入站触发器。

代码 HTTP 意义 i18n 键 典型原因
AIH-ZAPIER-0001 501 未配置入站触发器 err.zapier.not_configured 该功能/集成已关闭或未配置。
AIH-ZAPIER-0002 401 无效的触发器签名或令牌 err.zapier.invalid_signature 缺失或无效的凭证。

ANALYSIS

代码 HTTP 意义 i18n 键 典型原因
AIH-ANALYSIS-0001 503 当前无法访问源。对记录的一般分析或链接并不提供对原始数据的权利。 businessResults.sourceUnavailable —

BINDING

代码 HTTP 意义 i18n 键 典型原因
AIH-BINDING-0001 400 绑定规则无效:选择一个通道、范围和一个目标 - 代理或“不回复”。 err.binding.invalid_rule —
AIH-BINDING-0002 409 此目标的绑定已存在 - 删除或编辑现有绑定。 err.binding.overlap —
AIH-BINDING-0003 404 找不到绑定。 err.binding.not_found —
AIH-BINDING-0004 400 @handle 不是该渠道发送的账号标识,请用渠道的数字 id 添加此人。 err.binding.handle_not_identity —
AIH-BINDING-0005 409 该群组或频道已连接到此服务器上的另一个组织,无法在此绑定到代理。 err.binding.chat_taken —

BROWSER

代码 HTTP 意义 i18n 键 典型原因
AIH-BROWSER-0001 503 浏览器配置文件服务未运行。该服务随浏览器一同启动。 err.browserprofile.service_unavailable —
AIH-BROWSER-0002 409 该智能体已有浏览器配置文件。请先解除该智能体与其的关联。 err.browserprofile.agent_taken —
AIH-BROWSER-0003 409 配置文件当前被占用:有人正在登录。请几分钟后再试。 err.browserprofile.busy —
AIH-BROWSER-0004 409 该配置文件仍在浏览器中打开:某个智能体正在其中完成操作。请一分钟后重试。 err.browserprofile.in_use —

CLAIM

代码 HTTP 意义 i18n 键 典型原因
AIH-CLAIM-0001 409 识别窗口已关闭,请重新打开。 err.claim.window_closed —
AIH-CLAIM-0002 404 该发送者在窗口开启期间没有发送消息。 err.claim.candidate_unknown —

DATA

代码 HTTP 意义 i18n 键 典型原因
AIH-DATA-0001 503 无法检查当前源处理规则。 dataPolicy.errorUnavailable —
AIH-DATA-0002 409 该源不允许选择的处理路径。选择已允许的兼容路由或检查源规则。 dataPolicy.errorIncompatible —
AIH-DATA-0003 503 没有为此操作配置经过验证的兼容路由。指定处理位置和数据存储配置文件。 dataPolicy.errorUnconfigured —
AIH-DATA-0004 409 本次操作期间,数据处理路径发生了变化。发出新的明确请求前,请检查当前路径。 dataPolicy.errorChanged —
AIH-DATA-0005 409 以前的数据没有经过验证的来源分类。处理位置不会自动假定。使用新的上下文或检查源材料的分类。 dataPolicy.errorProvenanceUnknown —
AIH-DATA-0006 409 无法验证此请求的附件源字节。请先打开现有附件,然后重试。 dataPolicy.errorFingerprintUnavailable —
AIH-DATA-0007 409 处理设置已更改。保存前重新读取当前版本。 dataPolicy.errorConfigurationChanged —

DELEGATION

代码 HTTP 意义 i18n 键 典型原因
AIH-DELEGATION-0001 403 该外部连接当前未分配给该用户和代理。 enterpriseConnections.errorDenied —
AIH-DELEGATION-0002 409 外部身份、联系或权限发生了变化。重新启动当前的连接。 enterpriseConnections.errorChanged —
AIH-DELEGATION-0003 503 配置的颁发者、提供商版本或委托配置文件不可用或不兼容。 enterpriseConnections.errorUnavailable —
AIH-DELEGATION-0004 409 此前发行外部代币尚无确认结果。再次尝试之前,请与供应商检查实际输出。 enterpriseConnections.errorReconcile —
AIH-DELEGATION-0005 409 公司连接的配置已更改。请在保存之前下载当前版本。 enterpriseConnections.errorConfigurationChanged —

DEMO

代码 HTTP 意义 i18n 键 典型原因
AIH-DEMO-0001 403 此操作在公开演示站点上已禁用 err.demo.restricted —
AIH-DEMO-0002 403 这是演示站点自身的组成部分,无法删除或停止 err.demo.protected —
AIH-DEMO-0003 403 公开演示站点已关闭邮件通知,无法开启 err.demo.email_disabled —

IMPORT

代码 HTTP 意义 i18n 键 典型原因
AIH-IMPORT-0001 409 该分块不能接续上传;上传将从服务器已收到的位置继续 err.import.upload_offset —
AIH-IMPORT-0002 422 上传的文件与您电脑上的文件不同。请重新上传 err.import.upload_checksum —
AIH-IMPORT-0003 413 导出超出了导入允许的大小 err.import.too_large —
AIH-IMPORT-0004 507 服务器磁盘空间不足,无法存放导出并解压 err.import.no_space —
AIH-IMPORT-0005 422 压缩包包含指向其外部的路径,未解压 err.import.unsafe_archive —
AIH-IMPORT-0006 422 没有导入来源能识别此导出 err.import.not_recognized —
AIH-IMPORT-0007 409 上传尚未完成 err.import.upload_incomplete —
AIH-IMPORT-0008 424 导入前的数据库备份失败,因此未应用任何内容。请检查服务器上是否已安装 pg_dump err.import.backup_failed —

NOTIFY

代码 HTTP 意义 i18n 键 典型原因
AIH-NOTIFY-0001 501 通知未启用 err.notify.not_enabled —
AIH-NOTIFY-0002 400 通知首选项无效 err.notify.invalid_pref —
AIH-NOTIFY-0003 503 Telegram 链接不可用 err.notify.telegram_unavailable —
AIH-NOTIFY-0004 502 检查 Telegram 状态失败 - 请重试 err.notify.telegram_transient —

ONBOARDING

代码 HTTP 意义 i18n 键 典型原因
AIH-ONBOARDING-0001 503 无法连接到 aihummer.ru 服务器。请检查本服务器的网络连接,以便完成实例注册。 err.onboarding.awaiting_fleet —
AIH-ONBOARDING-0002 400 所有者标识必须是 UUID 格式 err.onboarding.invalid_owner —

PLAN

代码 HTTP 意义 i18n 键 典型原因
AIH-PLAN-0001 402 该 AI 员工超出当前套餐的名额。请续订以恢复其工作。 err.plan.agent_over_limit —

ROLE

代码 HTTP 意义 i18n 键 典型原因
AIH-ROLE-0001 400 角色定义无效 err.role.invalid —
AIH-ROLE-0002 409 具有此名称的角色已存在 err.role.exists —
AIH-ROLE-0003 404 找不到角色 err.role.not_found —
AIH-ROLE-0004 400 内置角色是只读的 err.role.builtin_readonly —
AIH-ROLE-0005 409 该角色仍分配给用户 - 首先撤销它 err.role.in_use —

SETTINGS

代码 HTTP 意义 i18n 键 典型原因
AIH-SETTINGS-0001 403 此设置是由 AiHummer Cloud 管理,无法更改 err.settings.cloud_locked —
AIH-SETTINGS-0002 400 代码执行未能设为“仅在沙箱中”:操作系统沙箱(bubblewrap)无法在本服务器上启动,且未设置容器镜像。请安装 bubblewrap,或选择“在本服务器上”。 err.settings.code_exec_sandbox_unavailable —

SUPPORT

代码 HTTP 意义 i18n 键 典型原因
AIH-SUPPORT-0001 503 没有与供应商的连接 - 车队巴士已离线。稍后重试。 err.support.unavailable —
AIH-SUPPORT-0002 400 支持服务拒绝了请求 err.support.rejected —

TURN

代码 HTTP 意义 i18n 键 典型原因
AIH-TURN-0001 502 模型提供者拒绝了其凭证 err.turn.provider_auth —
AIH-TURN-0002 429 请求被提供者或预算政策限制 err.turn.rate_limited —
AIH-TURN-0003 502 所需的服务暂时不可用 err.turn.upstream_unavailable —
AIH-TURN-0004 502 此步骤所需的工具失败了 err.turn.tool_failed —
AIH-TURN-0005 502 任务未能在单轮的步骤上限内完成 err.turn.step_limit —
AIH-TURN-0006 502 对话已超出模型的上下文窗口 err.turn.context_overflow —
AIH-TURN-0007 503 计划任务的本轮因服务器重启而中断 err.turn.interrupted_restart —
AIH-TURN-0008 503 服务器正忙于其他回复,消息未被处理。请重新发送。 err.turn.server_busy —
AIH-TURN-0009 409 任务阶段已停止。请检查任务的当前状态。 err.turn.task_stopped —