What is code context?

コード コンテキストを使用すると、チームがすでに使用しているアトラシアン ツール内で直接、接続されたソース コード リポジトリ全体をインテリジェントに検索できます。馴染みのないコードベースを操作している場合でも、バグを調査している場合でも、Rovo エージェントにタスクのサポートを依頼している場合でも、コード コンテキストによって適切なコードをより迅速に見つけることができます。

コード コンテキストの機能

コード コンテキストは 2 つの補完的な検索モードを組み合わせて、より柔軟で強力なコード検索を実現します。

Rovo チャット と TWG CLI では、基盤となるエージェントがクエリに基づいて最適な検索モードを自動的に選択します。場合によっては、語彙検索とセマンティック検索を組み合わせることもあります。

コード コンテキストの仕組み

コード コンテキストは既定でオフになっています。組織管理者が明示的に有効にした場合、アトラシアンはリポジトリに接続し、検索可能なインデックス化を行います。次のようなことが起こります。

1. アトラシアンは、Jira GitHub Connector または Bitbucket 統合を介してリポジトリに接続します。

2. ファイルはチャンク化され、ベクトル埋め込みに変換されます。

3. コードチャンクとそのエンベディングは、アトラシアンが管理するセキュアで分離された環境に保存されます。

4. リポジトリのイベント (プッシュおよびブランチの更新) は、変更されたファイルの増分再インデックス化をトリガーし、インデックス化を最新の状態に保ちます。

コード コンテキストはいつでも無効にできます。組織管理者がコード コンテキストを無効にすると、インデックス作成は直ちに停止します。保存されたすべての埋め込み、インデックス、コードチャンクが削除されます。

サイトでコード コンテキストを有効にする方法の詳細をご確認ください。

何がインデックス化されますか?

For GitHub repositories, code is mirrored into Atlassian infrastructure before indexing. For Bitbucket repositories, code is indexed directly.

The following data is stored in a secure, isolated environment in the United States.

Permissions and access

コード コンテキストは、後付けではなく基本原則として権限を適用するように構築されており、特にソース コード管理 (SCM) の権限を遵守するように設計されています。コード コンテキストは、SCM 権限で許可されている範囲を超えてユーザーにアクセス権を付与することはありません。

Users will see results only for repositories and branches they already have access to in the source SCM. Atlassian validates permissions at query time against the repository's permission endpoint.

組織管理者がリポジトリのコード コンテキストを有効にした場合、個々のコントリビューターはインデックス作成から自分のコードを除外できません。これは、既存の Bitbucket の字句検索の現在の動作と一致します。

データの取り扱い

お客様のコードは、アトラシアンの AI モデルのトレーニングには使用されません。

コードのベクトル表現を生成するために、アトラシアンはコードに最適化された埋め込みモデルを使用します。Rovo チャットでコードコンテキストを使用する場合、応答を生成するために、関連するコードスニペットがコンテキストとして大規模言語モデル (LLM) に渡される場合があります。

これは、アトラシアンにおける AI エクスペリエンスのより広範な作業の仕組みと一致しています。

Rovo チャット のユースケースとデータの使用に関する詳細を読む

その他の注意事項

検索結果は、検索を実行するユーザーがご利用の SCM で既にアクセスできる範囲に絞り込まれます。コードのコンテキストがその境界を正確に反映できるように、Bitbucket または GitHub のリポジトリ権限が正しく設定されていることを確認してください。

コードコンテキストとともに Rovo チャット および Teamwork Graph CLI を使用する場合、AI の応答は確率的になります。特にインシデント対応やセキュリティに関する意思決定などのクリティカルな状況では、AI が生成した回答に基づいて行動する前に、必ず内容を確認してください。

セマンティック検索はディスカバリーツールです。

セマンティック検索はコードの探索や理解に役立ちますが、専用のセキュリティやコンプライアンス スキャン ツールの代わりになるものではありません。監査および脆弱性検出ルールには、専用ツールを使用することをお勧めします。

セマンティック検索は、コードのコメントやドキュメンテーション文字列の影響を受ける点にご留意ください。正確なコメントは結果の関連性を向上させるため、適切なコード レビューのプラクティスは検索エクスペリエンスにも役立ちます。

既知の制限事項

チームでのコード コンテキストの使い心地について、ご意見をお聞かせください。フィードバックの共有や問題のレポートは、直接 Rovo チャット から行うか、TWG CLI をご利用の場合はこちらのフォームから行ってください。