在 TeamCity 中运行 AI 智能体

在 TeamCity 中运行 AI 智能体

💡 原文英文,约1200词,阅读约需5分钟。
📝

内容提要

TeamCity推出实验性AI Agents插件,可在CI/CD构建中直接运行Codex和Claude Code,用于代码审查、排查构建失败、更新文档等任务。插件支持OpenAI、Anthropic、OpenRouter、LiteLLM和JetBrains Air等模型提供商,构建时自动安装客户端并临时提供凭证,构建后清除以保障安全。插件还统计提示、补全、缓存及总token用量,并记录HTML和JSON格式的智能体轨迹,便于调试和批量分析,从而优化提示词与工作流。

🔎

延伸解读

凭证临时化降低共享代理风险

TeamCity 构建代理常被多个构建复用,长期存放模型提供商凭证存在泄露风险。该插件通过 TeamCity 连接管理凭证,仅在构建期间提供给代理,构建结束后移除。这意味着凭证不会持久化在代理上,减少了因代理复用导致的安全隐患。但需注意,构建产物可能包含提示、源码和模型输出,仍需按敏感数据管理并限制访问。

令牌统计与轨迹分析形成优化闭环

插件将提示、补全、缓存及总令牌数发布为 TeamCity 统计值,便于跟踪 AI 使用趋势并发现消耗异常。同时记录 HTML 和 JSON 格式的智能体轨迹,HTML 便于人工查看消息与工具调用,JSON 支持批量程序化分析。结合本地编码代理和 TeamCity CLI,可跨构建检索轨迹,分析多次运行后调整提示词,形成“运行-收集-分析-改进”的反馈循环。

实验性插件的适用边界

该插件目前为实验性,功能可能随开发调整。它支持 Codex 和 Claude Code,并可通过 OpenRouter、LiteLLM 等网关接入更广泛的模型。使用时需在构建配置中添加 AI Agent 构建功能并选择提供商连接,再通过命令行步骤调用 codex 或 claude。由于是实验阶段,建议在非关键流程中先行试用,并关注后续变化。

❓

Q&A

TeamCity 的 AI Agents 插件能做什么?

该插件允许在 TeamCity 构建中直接运行 Codex 和 Claude Code 等 AI 编码智能体,用于代码审查、排查构建失败、更新文档等任务。它自动安装客户端、安全提供凭证、统计 token 用量并记录智能体轨迹。

AI Agents 插件支持哪些 LLM 提供商?

插件支持 JetBrains Air、OpenAI、Anthropic、LiteLLM 和 OpenRouter。通过 OpenRouter 和 LiteLLM 等网关,还可以访问更广泛的模型。

如何保证构建代理上的凭证安全?

插件将提供商凭证存储为 TeamCity 连接,仅在构建期间临时提供给构建代理,构建结束后立即移除,避免凭证长期留在可能被复用的代理上。

插件如何帮助优化 AI 使用成本?

插件收集提示、补全、缓存和总 token 用量,并发布为 TeamCity 统计值,可用于跟踪 AI 使用趋势、创建图表,并发现 token 消耗的异常变化,从而调查成本异常。

如何查看 AI 智能体在构建中的执行轨迹?

插件将轨迹文件发布为隐藏的构建产物(位于 .teamcity/ai-agents/),并提供 HTML 报告展示消息、工具调用和 token 用量。您可以在项目设置中创建报告标签页,以 .teamcity/ai-agents/trajectory.html 为起始页来查看。

在 TeamCity 中设置 AI 智能体的步骤是什么?

首先从 JetBrains Marketplace 安装插件并添加到 TeamCity 服务器。然后创建连接(选择提供商并输入凭证),在构建配置中添加 AI Agent 构建功能并选择 Codex 或 Claude Code 及连接,最后添加命令行构建步骤调用 codex 或 claude 并提供提示词。

🏷️

标签

➡️

继续阅读