自带 AI 提供商

Archyl 包含用于架构发现、ADR 解析、聊天、洞察和托管代理的 AI 功能。默认情况下,所有这些都在 Archyl 管理的模型上运行。出于合规、合同或数据驻留原因已与 AI 提供商建立关系的组织,可以使用自己的凭据通过自己的提供商路由每个 AI 请求。

启用 BYO Provider 时:

• 每个 AI 功能都通过您配置的提供商路由
• Archyl 配额限制(聊天查询、AI 发现、代理运行)被跳过 — 您的提供商直接向您计费 token 使用
• 按功能选择模型让您混合模型(例如,Claude Sonnet 用于聊天,Claude Opus 用于发现)

这是组织级别的设置;只有组织管理员可以配置。

支持的提供商

OpenAI 兼容适配器是涵盖一长串供应商的单一配置。您提供基础 URL 和 API 密钥,Archyl 会像与 OpenAI 通信一样与端点通信。

配置

步骤 1 — 打开 AI 选项卡

转到组织设置 → AI。该选项卡仅对管理员可见。

步骤 2 — 选择提供商

选择五个提供商卡片之一。每张卡片都有自己的凭据要求:

• OpenAI / Anthropic / Google — 仅 API 密钥
• OpenAI 兼容 — API 密钥 + 基础 URL(例如 https://api.openrouter.ai/api/v1、https://api.mistral.ai/v1、https://models.github.ai/inference)
• AWS Bedrock — <access_key_id>:<secret_access_key> 格式的凭据(STS 凭据可选 :<session_token> 后缀),加上 AWS 区域(例如 us-east-1)

步骤 3 — 配置每个功能的模型(可选)

每个 AI 功能都可以使用不同的模型。任何字段留空以回退到提供商的默认值。

使用提供商发布的精确模型标识符(claude-opus-4-5、gpt-4o、mistral-large-latest、anthropic.claude-sonnet-4-20250514-v1:0 等)。Archyl 直接传递。

步骤 4 — 测试连接

点击测试连接。Archyl 使用您的凭据对配置的提供商发出最小 completion。绿色对勾确认凭据有效;错误显示提供商的响应,以便您在保存之前修正配置。

步骤 5 — 启用并保存

勾选为此组织启用 BYO 提供商,然后点击保存设置。组织内任何人发出的下一个 AI 请求 — 聊天、发现、代理运行、ADR 导入 — 都将通过您的提供商路由。

配额行为

当 BYO Provider 禁用(默认)时,AI 使用计入您订阅的月度配额:

• AI 发现操作
• 聊天查询
• 托管代理运行

当 BYO Provider 启用时,组织的所有三个配额都被绕过。您直接向提供商支付使用的 token;Archyl 不再对这些功能进行速率限制。您的基于席位的订阅仍适用于其他所有内容(协作功能、团队限制等)。

绕过在您启用切换时立即生效,在禁用时立即恢复。

安全

API 密钥使用平台加密密钥以 AES-256-GCM 静态加密。它们从不在 API 响应中返回 — 一旦存储,UI 显示 •••••••• 以及"密钥已存储"指示器,密钥仅在需要发出 AI 请求时进程内解密。

要替换现有密钥,输入新值并保存。要完全清除它,点击删除配置,这会删除该条目并将组织还原为平台管理的 AI。

只有组织管理员可以读取或修改这些设置。成员将看到 AI 功能透明地继续工作 — 路由对他们不可见。

托管代理

启用 BYO Provider 后,托管代理运行完全在您自己的提供商上、使用您自己的凭据执行。Archyl 自有的模型绝不会被用作后备。

如果提供商无法运行代理,或者没有为 OpenAI 兼容端点设置模型,启动运行会直接失败并给出明确提示,而不会在您未选择的模型上运行。

故障排除

"测试连接"失败,出现 401 / 403。 重新检查密钥是否正确粘贴,周围没有空格。对于 Bedrock,确保格式为 <access_key_id>:<secret_access_key>(冒号分隔),区域与您 AWS 账户中已启用模型的区域匹配。

"baseUrl is required for openai_compatible provider"。 基础 URL 字段对 OpenAI 兼容适配器是必需的。它应该指向 API 的根,例如 https://api.openrouter.ai/api/v1 — 末尾不带 /chat/completions。

发现返回无效 JSON。 Archyl 的 prompts 针对 OpenAI 的严格 JSON 模式调优。某些提供商/模型在 markdown 代码围栏内返回 JSON 或添加注释。专门为发现、结构分析和关系优化功能切换到具有强 JSON 模式可靠性的模型(例如 gpt-4o、claude-sonnet-4-6、gemini-2.0-flash) — 聊天和其他功能更宽容。

聊天有效但发现在 Bedrock 上失败。 某些 Bedrock 模型 ID 需要 Provisioned Throughput 或特定的跨区域推理配置文件。检查模型是否在 Bedrock 控制台中为您的账户启用,并且您选择的区域与模型的可用性匹配。

相关功能

• AI 驱动的发现 — 启用 BYO 时使用您配置的提供商
• 托管代理运行 — 在您的 Anthropic、Bedrock、OpenAI 或 OpenAI 兼容提供商上运行