Coroot Enterprise AI 模型接入配置完全指南Anthropic、OpenAI 与 OpenAI 兼容 API 的三种集成方式【免费下载链接】corootCoroot is an open-source observability and APM tool with AI-powered Root Cause Analysis. It combines metrics, logs, traces, continuous profiling, and SLO-based alerting with predefined dashboards and inspections.项目地址: https://gitcode.com/GitHub_Trending/co/corootCoroot 的 AI 驱动根因分析AI-powered Root Cause Analysis能够把指标、日志、Trace 和持续剖析continuous profiling等遥测数据归纳为清晰、可执行的故障结论。本指南以 docs/docs/ai/configuration.md 为核心完整讲解 Coroot Enterprise 中接入 AnthropicClaude、OpenAIGPT以及任意 OpenAI 兼容 API如 DeepSeek、Google Gemini的配置步骤、网络与权限要求并结合仓库前端表单与后端配置存储的实现细节帮助你准确完成 AI 模型提供商的接入与排障。功能背景AI 如何参与根因分析在进入配置之前需要先理解该配置服务于什么能力。Coroot 的 AI 根因分析分两层工作详见 docs/docs/ai/overview.md第一层不使用 LLMCoroot 会像工程师一样沿着受影响服务的依赖图用各类机器学习算法比对遥测数据与异常筛选出最可能的根因、相关日志和关键信号形成一份详细的 RCA 报告。第二层使用 LLM当你在界面上点击Explain with AI时Coroot 只把上述分析结论发送给所选模型由 LLM 负责总结与解释而不是让它直接面对原始遥测数据做因果判断——这正是 LLM 最擅长的场景。因此本文要配置的 AI 模型提供商扮演的是解释器与摘要器角色而非分析引擎。支持的模型提供商根据 配置文档Coroot Enterprise 支持三类模型接入提供商类型代表模型说明AnthropicClaude Opus 4.6官方推荐Coroot 测试中效果最佳OpenAIGPT-5.2官方原生支持OpenAI 兼容 APIDeepSeek、Google Gemini 等任何兼容 OpenAI API 协议的提供商均可接入注意文档中给出的模型名称如 Claude Opus 4.6、GPT-5.2为文档撰写时的推荐型号实际可用的模型取决于你所用提供商账户的权限与配额应以提供商侧文档为准。前置条件权限要求AI 集成是全局设置适用于所有项目配置时要求当前登录用户具备settings.edit权限。在 Coroot 的权限模型中该权限决定了用户能否修改项目级与全局设置相关权限定义可参考 rbac/action.go 与 rbac/actions.go。如果你在界面中看不到或无法保存 AI 配置请先确认账号角色是否被授予该权限。网络连通性Coroot Enterprise 实例必须能够主动访问模型提供商的服务端点并且使用标准的 HTTPS 443 端口提供商需要可达的端点Anthropicapi.anthropic.com:443OpenAIapi.openai.com:443OpenAI 兼容 API你指定的 Base URL由提供商决定若实例部署在受限网络如代理、防火墙或 egress 白名单环境中请确保上述域名/端口已在白名单中放行否则 RCA 结果会返回失败状态。配置入口登录 Coroot 后依次进入Project Settings项目设置→AI即可看到模型提供商配置页面。该页面提供四种状态Anthropic、OpenAI、OpenAI-compatible API以及Disabled停用 AI 功能。配置 AnthropicAnthropic 是 Coroot 官方推荐的首选提供商配置方式最简单——只需一个 API Key在 AI 设置页选择Anthropic作为模型提供商填入你的 Anthropic API Key建议从官方 API 控制台获取点击Save保存。从前端实现看该表单对应 front/src/views/IntegrationAI.vue 中form.provider anthropic的分支只有一个必填的api_key字段且以密码框typepassword形式输入并带有notEmpty非空校验。也就是说接入 Anthropic 无需关心模型名、无需自定义端点Coroot 会使用账户默认的 Claude 模型完成解释任务。配置 OpenAIOpenAI 的接入方式与 Anthropic 完全对称选择OpenAI作为模型提供商填入 OpenAI API Key点击Save保存。对应前端代码同样只有api_key一个必填字段见 front/src/views/IntegrationAI.vue 中form.provider openai分支输入框使用密码类型并做非空校验。配置 OpenAI 兼容 API这是自由度最高的接入方式适用于 DeepSeek、Google Gemini 以及任何实现了 OpenAI Chat Completions 协议的自建或第三方网关选择OpenAI-compatible API作为模型提供商填写Base URL提供商 API 服务的根地址例如自建网关、代理或 DeepSeek / Gemini 的 OpenAI 兼容端点该字段带有isUrl格式校验填写API Key访问该服务的密钥填写Model指定要使用的模型名称或 ID该值需与提供商文档中声明的标识完全一致点击Save保存。三个字段在前端实现中均对应 front/src/views/IntegrationAI.vue 的openai_compatible分支base_url、api_key、model其中 Base URL 校验 URL 格式API Key 与模型名执行非空校验。配置完成后请确认实例可以连通你填写的 Base URL。从源码看配置的保存与读取链路前端表单与接口调用AI 设置页面由 front/src/views/IntegrationAI.vue 实现其核心逻辑包括get()页面挂载时调用this.$api.ai(null, cb)拉取当前配置回填表单save()提交{ provider, anthropic, openai, openai_compatible }结构体成功后提示Settings were successfully updated.并重新拉取只读模式若后端返回readonly: true表单会整体禁用并提示 AI settings are defined through the config and cannot be modified via the UI.。可以推断AI 设置也支持通过配置文件定义例如 config/config.go 中的corootCloud段此时界面只读防止与文件配置冲突版本差异disabled标志由this.$coroot.edition ! Enterprise决定即 AI 提供商配置仅对 Enterprise 版本开放与文档中仅限 Coroot Enterprise的说明一致。接口层定义在 front/src/api.jsai(form, cb)在传参时走POST ai不传参时走GET ai与上述读写逻辑对应。后端配置存储在后端云集成/订阅类设置以键值形式持久化cloud/api.go中的Settings结构体包含ApiKey与RCADisableIncidentsAutoInvestigation字段通过db.GetSetting/db.SetSetting设置名cloud_integration_settings读写。而企业版 AI 提供商配置属于全局设置同样遵循全局、跨项目生效的语义。RCA 服务如何检查 AI 可用性cloud/rca.go中的RCAStatus方法揭示了配置与实际调用之间的关系当 API Key 为空时返回AI disabled当DisableIncidentsAutoInvestigation开启且属于自动调查场景时同样返回AI disabled若积分耗尽则返回Out of credits全部通过才返回OK。随后api/rca.go中的RCA/IncidentRCA流程会把聚合后的指标、Kubernetes 事件、违反 SLO 的 ErrorTrace/SlowTrace 等封装成RCARequestmsgpack lz4 压缩发送到分析服务换取 RCA 结果——整个过程中原始遥测数据并不会直接暴露给 LLM。常见问题排查界面显示 AI 已禁用AI disabled检查是否在 AI 设置页选择了Disabled或 API Key 为空若为社区版Community Edition可参考 docs/docs/ai/coroot-cloud.md 通过连接 Coroot Cloud 获得每月 10 次免费调查额度。无法保存配置确认当前账号是否具备settings.edit权限若页面整体只读说明设置已由配置文件定义请通过配置文件修改。RCA 返回失败Failed优先排查实例到api.anthropic.com:443、api.openai.com:443或自定义 Base URL 的网络连通性同时确认账户 API Key 有效、模型配额未耗尽。另外从 api/rca.go 可以看到多集群项目multicluster暂不支持 RCA也会直接返回失败。模型名无效OpenAI 兼容模式下model字段必须与提供商文档中的模型标识完全一致不能使用提供商营销名称。按照上述步骤完成任一提供商的接入后Coroot 便能在检测到 SLI 异常如延迟飙升、错误率上升时为你生成包含异常摘要、问题传播路径、关键证据与修复建议的 AI 解释从而显著缩短故障定位与修复的周期。【免费下载链接】corootCoroot is an open-source observability and APM tool with AI-powered Root Cause Analysis. It combines metrics, logs, traces, continuous profiling, and SLO-based alerting with predefined dashboards and inspections.项目地址: https://gitcode.com/GitHub_Trending/co/coroot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Coroot Enterprise AI 模型接入配置完全指南：Anthropic、OpenAI 与 OpenAI 兼容 API 的三种集成方式
Coroot Enterprise AI 模型接入配置完全指南Anthropic、OpenAI 与 OpenAI 兼容 API 的三种集成方式【免费下载链接】corootCoroot is an open-source observability and APM tool with AI-powered Root Cause Analysis. It combines metrics, logs, traces, continuous profiling, and SLO-based alerting with predefined dashboards and inspections.项目地址: https://gitcode.com/GitHub_Trending/co/corootCoroot 的 AI 驱动根因分析AI-powered Root Cause Analysis能够把指标、日志、Trace 和持续剖析continuous profiling等遥测数据归纳为清晰、可执行的故障结论。本指南以 docs/docs/ai/configuration.md 为核心完整讲解 Coroot Enterprise 中接入 AnthropicClaude、OpenAIGPT以及任意 OpenAI 兼容 API如 DeepSeek、Google Gemini的配置步骤、网络与权限要求并结合仓库前端表单与后端配置存储的实现细节帮助你准确完成 AI 模型提供商的接入与排障。功能背景AI 如何参与根因分析在进入配置之前需要先理解该配置服务于什么能力。Coroot 的 AI 根因分析分两层工作详见 docs/docs/ai/overview.md第一层不使用 LLMCoroot 会像工程师一样沿着受影响服务的依赖图用各类机器学习算法比对遥测数据与异常筛选出最可能的根因、相关日志和关键信号形成一份详细的 RCA 报告。第二层使用 LLM当你在界面上点击Explain with AI时Coroot 只把上述分析结论发送给所选模型由 LLM 负责总结与解释而不是让它直接面对原始遥测数据做因果判断——这正是 LLM 最擅长的场景。因此本文要配置的 AI 模型提供商扮演的是解释器与摘要器角色而非分析引擎。支持的模型提供商根据 配置文档Coroot Enterprise 支持三类模型接入提供商类型代表模型说明AnthropicClaude Opus 4.6官方推荐Coroot 测试中效果最佳OpenAIGPT-5.2官方原生支持OpenAI 兼容 APIDeepSeek、Google Gemini 等任何兼容 OpenAI API 协议的提供商均可接入注意文档中给出的模型名称如 Claude Opus 4.6、GPT-5.2为文档撰写时的推荐型号实际可用的模型取决于你所用提供商账户的权限与配额应以提供商侧文档为准。前置条件权限要求AI 集成是全局设置适用于所有项目配置时要求当前登录用户具备settings.edit权限。在 Coroot 的权限模型中该权限决定了用户能否修改项目级与全局设置相关权限定义可参考 rbac/action.go 与 rbac/actions.go。如果你在界面中看不到或无法保存 AI 配置请先确认账号角色是否被授予该权限。网络连通性Coroot Enterprise 实例必须能够主动访问模型提供商的服务端点并且使用标准的 HTTPS 443 端口提供商需要可达的端点Anthropicapi.anthropic.com:443OpenAIapi.openai.com:443OpenAI 兼容 API你指定的 Base URL由提供商决定若实例部署在受限网络如代理、防火墙或 egress 白名单环境中请确保上述域名/端口已在白名单中放行否则 RCA 结果会返回失败状态。配置入口登录 Coroot 后依次进入Project Settings项目设置→AI即可看到模型提供商配置页面。该页面提供四种状态Anthropic、OpenAI、OpenAI-compatible API以及Disabled停用 AI 功能。配置 AnthropicAnthropic 是 Coroot 官方推荐的首选提供商配置方式最简单——只需一个 API Key在 AI 设置页选择Anthropic作为模型提供商填入你的 Anthropic API Key建议从官方 API 控制台获取点击Save保存。从前端实现看该表单对应 front/src/views/IntegrationAI.vue 中form.provider anthropic的分支只有一个必填的api_key字段且以密码框typepassword形式输入并带有notEmpty非空校验。也就是说接入 Anthropic 无需关心模型名、无需自定义端点Coroot 会使用账户默认的 Claude 模型完成解释任务。配置 OpenAIOpenAI 的接入方式与 Anthropic 完全对称选择OpenAI作为模型提供商填入 OpenAI API Key点击Save保存。对应前端代码同样只有api_key一个必填字段见 front/src/views/IntegrationAI.vue 中form.provider openai分支输入框使用密码类型并做非空校验。配置 OpenAI 兼容 API这是自由度最高的接入方式适用于 DeepSeek、Google Gemini 以及任何实现了 OpenAI Chat Completions 协议的自建或第三方网关选择OpenAI-compatible API作为模型提供商填写Base URL提供商 API 服务的根地址例如自建网关、代理或 DeepSeek / Gemini 的 OpenAI 兼容端点该字段带有isUrl格式校验填写API Key访问该服务的密钥填写Model指定要使用的模型名称或 ID该值需与提供商文档中声明的标识完全一致点击Save保存。三个字段在前端实现中均对应 front/src/views/IntegrationAI.vue 的openai_compatible分支base_url、api_key、model其中 Base URL 校验 URL 格式API Key 与模型名执行非空校验。配置完成后请确认实例可以连通你填写的 Base URL。从源码看配置的保存与读取链路前端表单与接口调用AI 设置页面由 front/src/views/IntegrationAI.vue 实现其核心逻辑包括get()页面挂载时调用this.$api.ai(null, cb)拉取当前配置回填表单save()提交{ provider, anthropic, openai, openai_compatible }结构体成功后提示Settings were successfully updated.并重新拉取只读模式若后端返回readonly: true表单会整体禁用并提示 AI settings are defined through the config and cannot be modified via the UI.。可以推断AI 设置也支持通过配置文件定义例如 config/config.go 中的corootCloud段此时界面只读防止与文件配置冲突版本差异disabled标志由this.$coroot.edition ! Enterprise决定即 AI 提供商配置仅对 Enterprise 版本开放与文档中仅限 Coroot Enterprise的说明一致。接口层定义在 front/src/api.jsai(form, cb)在传参时走POST ai不传参时走GET ai与上述读写逻辑对应。后端配置存储在后端云集成/订阅类设置以键值形式持久化cloud/api.go中的Settings结构体包含ApiKey与RCADisableIncidentsAutoInvestigation字段通过db.GetSetting/db.SetSetting设置名cloud_integration_settings读写。而企业版 AI 提供商配置属于全局设置同样遵循全局、跨项目生效的语义。RCA 服务如何检查 AI 可用性cloud/rca.go中的RCAStatus方法揭示了配置与实际调用之间的关系当 API Key 为空时返回AI disabled当DisableIncidentsAutoInvestigation开启且属于自动调查场景时同样返回AI disabled若积分耗尽则返回Out of credits全部通过才返回OK。随后api/rca.go中的RCA/IncidentRCA流程会把聚合后的指标、Kubernetes 事件、违反 SLO 的 ErrorTrace/SlowTrace 等封装成RCARequestmsgpack lz4 压缩发送到分析服务换取 RCA 结果——整个过程中原始遥测数据并不会直接暴露给 LLM。常见问题排查界面显示 AI 已禁用AI disabled检查是否在 AI 设置页选择了Disabled或 API Key 为空若为社区版Community Edition可参考 docs/docs/ai/coroot-cloud.md 通过连接 Coroot Cloud 获得每月 10 次免费调查额度。无法保存配置确认当前账号是否具备settings.edit权限若页面整体只读说明设置已由配置文件定义请通过配置文件修改。RCA 返回失败Failed优先排查实例到api.anthropic.com:443、api.openai.com:443或自定义 Base URL 的网络连通性同时确认账户 API Key 有效、模型配额未耗尽。另外从 api/rca.go 可以看到多集群项目multicluster暂不支持 RCA也会直接返回失败。模型名无效OpenAI 兼容模式下model字段必须与提供商文档中的模型标识完全一致不能使用提供商营销名称。按照上述步骤完成任一提供商的接入后Coroot 便能在检测到 SLI 异常如延迟飙升、错误率上升时为你生成包含异常摘要、问题传播路径、关键证据与修复建议的 AI 解释从而显著缩短故障定位与修复的周期。【免费下载链接】corootCoroot is an open-source observability and APM tool with AI-powered Root Cause Analysis. It combines metrics, logs, traces, continuous profiling, and SLO-based alerting with predefined dashboards and inspections.项目地址: https://gitcode.com/GitHub_Trending/co/coroot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
原理与实战应用详解)
