AI Assistant
TeamCity AI Assistant 是您全天候的调试失败工作流程、建议最佳配置并引导使用 TeamCity 功能的助手。
关键要点
TeamCity AI Assistant 能做什么？
AI Assistant 配备了一套用于检索有关当前 TeamCity 安装及其构建的工具。 它提供一般性指导（例如：“如何配置 TeamCity NuGet 源？”或“如何设置拉取请求？”）以及针对特定配置和构建的故障排除帮助（例如：“为何我的 SampleApp 配置中的构建 #17 失败？”）。
是否免费？
此功能在未来版本中可能会成为付费选项，但在抢先体验计划期间将保持免费。 AI Assistant 需要激活的 TeamCity Enterprise 许可证（包括在有效试用期内的许可证）。 对于 Professional 许可证或 维护期已过期的 Enterprise 许可证，不提供此功能。 有关更多信息，请参阅 限制和特别说明 部分。
是否有任何额外要求？
AI Assistant 需要对所选提供商的端点进行出站访问，以获取授权令牌、发送用户提示并接收响应。 对于 JetBrains AI 提供商，这包括 https://auth.grazie.ai、 https://api.jetbrains.ai ，以及发布用法统计信息（如果已启用）等所需的其他资源；其他提供商则需要访问其各自的端点。 如果服务器使用代理或防火墙，请允许对所配置的任何提供商的端点进行出站访问。
AI Assistant 会收集和共享哪些数据？
请参阅 隐私政策 部分。
TeamCity AI Assistant 使用的是哪种模型？
默认情况下，AI Assistant 使用 JetBrains AI。 从版本 2026.2 开始，还可以输入自己的 API 密钥，将 AI Assistant 连接到第三方 AI 提供商。 所使用的具体模型取决于 TeamCity 内部设置，并显示在 Assistant 面板底部。 请参阅 提供商 了解详情。
初始设置
AI Assistant 随所有 TeamCity 安装一起提供，初始处于禁用状态。 为避免您错过 TeamCity 中这一激动人心的新增功能，AI Assistant 即使在禁用时仍会在 TeamCity 页眉中显示其菜单项。
服务器管理员可以在 管理员｜AI Assistant 部分完全隐藏此元素。
允许详细的数据收集 复选框允许 TeamCity 将 AI Assistant 聊天记录私密共享给 JetBrains。 我们绝不会将此数据分享给任何人，并且仅用于改进 Assistant 的响应质量。
提供商
默认情况下，AI Assistant 使用 JetBrains AI，这是一种开箱即用、无需额外配置的提供商，会通过 JetBrains Account 自动管理。
从 TeamCity 2026.2 开始，AI Assistant 还支持 "自带密钥" (BYOK) 概念，可将其改为连接到第三方 AI 提供商。 如果您的组织提供对特定 AI 提供商的集中访问，请在 提供程序 选择器中选择该提供商并输入您的 API 密钥。 具体模型取决于 TeamCity 内部设置，并显示在 Assistant 面板底部。
使用 Anthropic、Google 和 OpenAI 模型只需要 API 密钥。 兼容 OpenAI 选项还需要提供商基础 URL 和模型 ID — 可将其用于兼容 OpenAI 的 API（例如 DeepSeek）以及自托管模型。
此设置适用于整个服务器：TeamCity 服务器管理员会为所有人配置相同的提供商，目前个人用户无法选择自己的提供商。 请告诉我们 ，TeamCity Assistant 是否缺少此功能或任何其他功能。
“Analyze it” 按钮
为了使 AI 查询返回相关结果，您需要提供上下文。 诸如“此构建为何失败？”之类的问题，如果未说明具体构建，可能不够明确。
为避免您输入包含项目和配置详情的长查询，TeamCity 在构建配置页面和失败构建页面右上角添加了 分析它 按钮。 点击该按钮会自动提供必要的上下文，使 AI Assistant 能立即分析失败或表现异常的工作流程。
限制和特别说明
我们持续致力于提升 AI Assistant 的回复质量，并为其底层模型提供最准确的上下文信息。 不过，当前生成式 AI 模型存在固有限制，偶尔可能会出现不准确或虚构的信息。 如果回复看起来不确定或不一致，建议重新表述你的问题或参考可靠信息源。 请将 AI Assistant 视为有用的辅助工具，而非唯一的事实来源，处理关键任务时请核实其建议。
与 AI Assistant 的历史对话不会被保存。 当您开始新的对话（通过聊天窗口右上角的“ + ”按钮）时，将无法访问之前的对话。
AI Assistant 的聊天记录会本地存储在您的浏览器中。 当您从其他浏览器访问 TeamCity 或注销后，对话不会恢复。
在以下情况下，AI Assistant 会被禁用：
您正在运行 TeamCity Professional 服务器（包括那些具有活动附加代理许可证的服务器）。
您的 Enterprise 许可证的 维护期 已过期。
您的服务器运行的 Java 版本低于 Java 17。
您正在使用经典 TeamCity UI，而非 Sakura UI。
您的服务器部署在不允许使用 JetBrains AI 服务的位置。 完整支持位置列表请参见： JetBrains AI Service Territory Limitations。 我们计划在未来版本中为中国大陆服务器启用 AI Assistant。
Assistant 旨在为现有 TeamCity 实体提供指导。 它无法创建新实体、添加依赖项、修改服务器设置、启动或停止构建等。 此外，它无法执行违反 当前用户权限 的操作（例如，分析用户无访问权限项目中的构建）。
隐私政策
TeamCity AI Assistant 会将用户提示和代码段共享给第三方 LLM 提供方，以处理问题并生成有用的回复。
我们也可能收集非匿名的使用数据和系统信息，以帮助我们改进该功能。 此数据仅由 TeamCity 团队使用，不会与任何外部方共享。
数据收集符合 JetBrains 通用隐私声明 和 JetBrains AI 数据收集和使用声明 的要求。