ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

在 Kilo Code 中配置 Unbound AI 网关:模型接入、自动发现与安全合规实践

在 Kilo Code 中配置 Unbound AI 网关:模型接入、自动发现与安全合规实践 在 Kilo Code 中配置 Unbound AI 网关模型接入、自动发现与安全合规实践【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocodeUnbound 是一个面向企业的 AI 网关平台专注于以安全、合规的方式统一提供 Anthropic、OpenAI 等多家厂商的大模型访问能力。本文是 Kilo Code 官方文档中 Unbound 接入指南的完整展开涵盖账号创建、模型自动发现、VS Code 端配置、CLI 支持现状并结合当前仓库中ConfigV2.Provider的源码结构说明网关类 provider 在kilo.json中的配置原理。读完本文你将掌握在 Kilo Code 中接入 Unbound 网关的完整流程并理解网关类 provider 的配置模型与自动拉取机制。Unbound 是什么面向企业安全的模型网关Unbound 的核心定位与 OpenRouter、TrustedRouter 等产品同属一类——AI 网关AI Gateway。在 Kilo Code 的官方文档体系中AI 网关被定义为通过统一 API 路由请求并提供附加功能的一类 provider与云厂商直连、本地自托管模型并列见 AI Providers 总览 中的 AI Gateways 分类。Kilo Code 支持通过 Unbound 访问多种大语言模型LLM。Unbound 作为网关允许你使用来自 Anthropic、OpenAI 等提供商的模型而无需为每一家厂商分别管理 API Key 和配置。Unbound 强调面向企业场景的安全与合规特性这一点在其接入指南中被单独列为推荐理由见 unbound.md。前置条件注册账号并创建应用在 Kilo Code 中接入 Unbound 之前需要先在 Unbound 侧完成账号与应用创建。官方指南给出了三个步骤注册/登录前往 Unbound 网关门户创建账号或登录已有账号。创建应用进入 Unbound 的 Connect 页面在应用列表中选择 Kilo Code创建与 Kilo Code 关联的应用。复制 API Key将生成的 API Key 复制到剪贴板后续配置时粘贴到 Kilo Code 中。提示上述操作均在 Unbound 平台完成具体入口以 Unbound 平台页面为准。创建应用时选择 Kilo Code 这一选项是为了让 Unbound 侧生成与 Kilo Code 兼容的凭据。支持的模型由 Unbound 自动下发Unbound 接入的一个关键特性是模型列表自动获取你可以在 Unbound 应用中自行配置受支持的模型清单而 Kilo Code 会从 Unbound API 自动拉取可用模型列表无需在本地手动维护模型清单。这与仓库中其他 OpenAI 兼容/网关类 provider 的行为一致。例如 OpenAI Compatible 接入指南 中明确说明当端点暴露了 OpenAI 兼容的 models 端点时Kilo 会自动拉取可用模型。也就是说网关类 provider 的模型发现是运行时动态完成的配置侧只需保证 API Key 与端点可达即可。自动拉取到的模型在 Kilo Code 中同样遵循provider/model的标识格式。从源码看模型 ID 的解析逻辑位于 packages/core/src/model.tsexport function parse(input: string): { providerID: ProviderV2.ID; modelID: ID } { const [providerID, ...modelID] input.split(/) return { providerID: ProviderV2.ID.make(providerID), modelID: ID.make(modelID.join(/)), } }即形如unbound/anthropic/claude-sonnet-4的完整模型引用会以第一个/为界拆分为 providerIDunbound与 modelIDanthropic/claude-sonnet-4模型 ID 部分本身可以继续包含/。在 Kilo Code 中配置 UnboundVS Code通过设置界面添加在 VS Code 扩展中接入过程非常简单打开Settings齿轮图标。进入Providers提供方选项卡。添加 Unbound并粘贴前面复制的 API Key。扩展会将凭据持久化到你的kilo.json配置文件中。你也可以直接编辑配置文件——文件格式与 CLI 侧通用见下文源码解析。配置文件格式与网关 provider 的通用结构虽然 Unbound 在文档中尚未提供 CLI 侧的专属配置示例但当前仓库中所有 provider 共用同一套kilo.json配置 schema。ConfigV2.Provider的定义位于 packages/core/src/config/provider.tsexport class Info extends Schema.ClassInfo(ConfigV2.Provider)({ name: Schema.String.pipe(Schema.optional), env: Schema.String.pipe(Schema.Array, Schema.optional), api: ProviderV2.Api.pipe(Schema.optional), request: Request.pipe(Schema.optional), models: Schema.Record(Schema.String, Model).pipe(Schema.optional), }) {}各字段含义如下字段类型说明namestring可选provider 的显示名称envstring[]可选用于注入 API Key 的环境变量名列表apiProviderV2.Api可选协议定义可为 AI SDK 协议或 Native 协议request{ headers?, body? }可选附加请求头与请求体modelsRecordstring, Model可选模型清单键为模型 ID其中单个Model的 schema 定义在同文件的 Model 类 中支持family模型族如 claude opus / claude sonnet 分组、name、api、capabilities能力声明、request/variants请求定制与变体、cost成本含 input/output 价格与缓存读写价格、disabled是否禁用以及limitcontext/input/output 上限等字段。参考仓库中同为网关类 provider 的 OpenRouter 接入指南一个典型的网关 provider 配置骨架如下可作为理解kilo.json结构的参照字段值以 Unbound 实际端点为准{ provider: { unbound: { env: [UNBOUND_API_KEY], models: { anthropic/claude-sonnet-4: { name: Claude Sonnet 4, limit: { context: 200000 } } } } } }说明env数组声明了从哪些环境变量读取密钥便于在脚本或 CI 场景注入凭据避免把密钥写死在配置文件中models中的键采用provider/model标识当模型由 Unbound API 自动拉取时此处可只保留需要覆盖/补充的条目上述结构以仓库中ConfigV2.Providerschema 为通用依据具体到 Unbound 是否需要显式声明api与request取决于其端点协议建议以自动拉取结果与 Unbound 平台文档为准。此外如果你在kilo.json中配置了多个 provider可以使用disabled_providers/enabled_providers两个顶层字段控制哪些 provider 参与加载用法见 AI Providers 总览 的 Disabling Built-in Providers 一节例如只保留 Unbound{ $schema: https://app.kilo.ai/config.json, enabled_providers: [unbound] }CLI 支持现状暂不可用需要特别留意的是截至本文档撰写时Unbound 尚未作为 CLI provider 开放。官方文档在 CLI 选项卡中给出了明确的警告提示并建议关注 Kilo Code 的 releases 页面以获取 provider 支持的最新进展。也就是说当前 Unbound 的官方支持范围仅限于 VS Code 扩展端。如果你主要使用 Kilo Code 的 CLI 形态暂时无法通过官方渠道接入 Unbound需要等待后续版本更新上文给出的kilo.json配置结构仅用于说明仓库中网关 provider 的通用配置模型不代表 Unbound 已可在 CLI 生效。使用建议与企业安全考量官方指南在最后给出了使用建议核心要点如下安全优先Unbound 强调面向企业使用的安全特性。如果你的组织对 AI 使用有严格的安全与合规要求例如需要统一审计、集中管控模型访问Unbound 是一个值得考虑的选项。模型按需配置由于模型清单由 Unbound 应用侧配置并由 Kilo Code 自动拉取建议在 Unbound 平台维护一份精简、经过审批的模型清单既便于管控也能减少模型切换的噪声。多 provider 协同Kilo Code 支持同时配置多个 provider详见 AI Providers 总览。可以将 Unbound 作为企业合规场景的主通道同时保留直连 provider 作为备选按任务灵活切换。小结Unbound 接入 Kilo Code 的完整链路可以概括为在 Unbound 平台创建应用并获取 API Key → 在 VS Code 的 Providers 选项卡中添加 Unbound 并粘贴密钥 → Kilo Code 自动拉取你在 Unbound 应用侧配置的模型清单 → 以unbound/...标识使用模型。在等待 CLI 支持开放的同时你也可以通过阅读 ConfigV2.Provider 源码 与 模型解析实现提前掌握网关 provider 的配置模型为后续自定义 provider 配置打下基础。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表