AI Assistant

鍵となるポイント

TeamCity AI Assistant で何ができますか？
AI Assistant には、現在の TeamCity インストールとそのビルドに関する情報を取得するためのツール設定が備わっています。 一般的なガイダンス (例: "TeamCity NuGet フィードを設定するにはどうすればよいですか？"、または "プルリクエストをセットアップするにはどうすればよいですか？") と、特定の構成やビルドに関するトラブルシューティング支援 (例: "SampleApp 構成のビルド #17 が失敗したのはなぜですか？") を提供します。

無料ですか？
この機能は今後のリリースで有料オプションとなる可能性がありますが、早期アクセスプログラム期間中は無料です。 AI Assistant を使用するには、有効な TeamCity Enterprise ライセンス (有効な試用期間中のものを含む) が必要です。 プロフェッショナルライセンス、または メンテナンス期間が終了したエンタープライズライセンスではご利用いただけません。 詳細については、 制限事項と特記事項 セクションを参照してください。

追加要件はありますか？
AI Assistant は、認証トークンを取得し、ユーザープロンプトを送信し、応答を受信するために、選択したプロバイダーのエンドポイントへのアウトバウンドアクセスを必要とします。 JetBrains AI プロバイダーの場合、これには https://auth.grazie.ai、 https://api.jetbrains.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 は、サードパーティ AI プロバイダーに接続できる "独自のキーを持ち込む" (BYOK) コンセプトもサポートします。 組織が特定の AI プロバイダーへの一元的なアクセスを提供している場合は、 プロバイダー セレクターでそのプロバイダーを選択し、API キーを入力してください。 正確なモデルは TeamCity の内部設定によって決まり、Assistant パネルの下部に表示されます。

Anthropic、Google、OpenAI モデルの使用に必要なのは API キーのみです。 OpenAI 互換 オプションでは、さらにプロバイダーのベース URL とモデル ID が必要です。OpenAI 互換 API (例: DeepSeek) やセルフホストモデルにも使用してください。

この設定はサーバー全体に適用されます。TeamCity サーバー管理者が全員に同じプロバイダーを構成し、現在、個々のユーザーが独自のプロバイダーを選択する方法はありません。 この機能やその他の機能が TeamCity Assistant に不足している場合は、 お知らせください。

'分析する' ボタン

AI クエリが適切な結果を返すには、コンテキストを提供する必要があります。 「なぜこのビルドは失敗したのですか？ 」のような質問は、どのビルドを指しているかを明示しないと、理解しにくい可能性があります。

プロジェクトや構成の詳細を含む長いクエリを入力する手間を省くため、TeamCity はビルド構成ページと失敗したビルドページの右上隅に 分析 ボタンを追加します。 このボタンをクリックすると必要なコンテキストが自動的に提供され、AI Assistant が失敗または動作不良のワークフローを即座に分析できるようになります。

制限事項と特記事項

• AI Assistant の応答品質の向上と、その基盤となるモデルに最も正確なコンテキストを提供するために、継続的に取り組んでいます。 しかしながら、現在の生成 AI モデルには固有の限界があり、不正確な情報や錯覚的な情報が含まれる場合があります。 回答が不明確または矛盾していると思われる場合は、質問を言い換えるか、信頼できる情報源と照合することを検討してください。 AI Assistant は唯一の情報源ではなく、役立つ補助ツールとして扱い、ミッションクリティカルなタスクを処理する際には、その提案を検証してください。

• AI Assistant との過去の会話は保存されません。 新しいチャットを開始すると（チャットウィンドウの右上にある「プラス 」ボタンを使用）、以前の会話にアクセスできなくなります。

• AI Assistant のチャット履歴はブラウザーにローカルに保存されます。 別のブラウザーから TeamCity にアクセスした場合やログアウトした後は、会話は復元されません。

• 次の場合には AI Assistant は無効になります。

  • TeamCity Professional サーバー (アクティブな追加エージェントライセンスを持つサーバーを含む) を実行しています。

  • エンタープライズライセンスの メンテナンス期間が終了しました。

  • サーバーは Java 17 より古いバージョンの Java で実行されています。

  • Sakura UI の代わりに、クラシック TeamCity UI を使用しています。

  • サーバーは、JetBrains AI サービスの利用が許可されていない地域に設置されています。 サポートされている地域の一覧は、 JetBrains AI サービス地域の制限(英語)を参照してください。 今後のリリースでは、中国拠点のサーバーでも AI Assistant を有効化する予定です。

• AI Assistant は現在、キューに入れられたビルドと仮想ビルド (並列テスト および マトリックスビルド 機能によって生成されたビルド) に関する質問を誤って処理します。

• アシスタントは、既存の TeamCity エンティティに関するガイダンスを提供するように設計されています。 新しいエンティティの作成、依存関係の追加、サーバー設定の変更、ビルドの開始と停止などは実行できません。 また、 現在のユーザー権限に違反するアクション（たとえば、ユーザーがアクセス権限を持たないプロジェクトに属するビルドの分析など）も実行できません。

プライバシーポリシー

TeamCity AI Assistant は、質問を処理して役立つ応答を生成するために、ユーザー確認とコードスニペットを 3rd-party の LLM プロバイダーと共有します。

機能の改善のため、非匿名の使用状況データとシステム情報を収集する場合があります。 このデータは TeamCity チームのみが使用し、外部の第三者とは共有されません。

データ収集は、 一般的な JetBrains プライバシー通知(英語)および JetBrains AI データ収集および使用に関する通知(英語)に準拠します。