チュートリアル

/initとAGENTS.mdでプロジェクトを開始する

/initを使用してBobに永続的なプロジェクトコンテキストを提供します。これにより、AGENTS.mdファイルが自動的に生成されます。

/initコマンドはプロジェクトをスキャンし、Bobがすべての会話で永続的なコンテキストとして使用するAGENTS.mdという構造化された要約ファイルを生成します。/initコマンドは、Bobが各インタラクションの開始時にすべてのファイルを再読み込みする必要なく、プロジェクトの構造、規則、コードベースに関する知識をBobに与える方法です。

大規模言語モデルはステートレスです。新しい会話はすべて、以前のインタラクションの記憶なしで始まります。明示的なプロジェクトコンテキストがない場合、Bobは新しいインタラクションごとにコードベースを発見する必要があり、これは非効率的で、規模が大きくなると実用的ではなくなります。

このチュートリアルでは、デモアプリケーションのルートディレクトリでBobを初期化し、Bobがアプリケーションについて取得するコンテキストを探索し、モード固有のコンテキストのためのBobの構造について学習します。

前提条件

このチュートリアルを完了するには、次のものが必要です:

  • まだお持ちでない場合は、Galaxium Travelsデモコードをクローンします。クローンコマンドは、チュートリアルで使用するコードを含むbob-learning-path-branchもチェックアウトします。
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • Galaxium TravelsデモコードがオープンされたBob IDE
  • 必須ではありませんが、Bobのインターフェースと機能に慣れるためにクイックスタートチュートリアルを実行することを検討してください。

/initを実行する

プロジェクトコンテキストを初期化するには、Bob IDEのこんにちは、Bobですチャットインターフェースに移動します。サイドバーの下部にあるAgentモードに切り替えます。

Agentモードに切り替える

チャットインターフェースで/initコマンドを入力します。自動承認を無効にしている場合、Bobはファイルを読み取り、AGENTS.mdファイルを書き込む許可を求めます。

 /init

Bob IDEで/initコマンドを実行する

Bobはプロジェクト内の関連ファイルを読み取ります。次に、BobはGalaxium TravelsルートディレクトリにメインAGENTS.mdファイルを生成します。Bobは、各モードのAGENTS.mdを含む.bobフォルダーも作成します。

AGENTS.mdファイルを探索する

AGENTS.mdファイルは、Bobのオンボーディングドキュメントのように機能します。AGENTS.mdは、Bobがプロジェクトの構造と規則を理解するために必要なすべてを提供する、簡潔で実行可能な要約です。

メインAGENTS.mdファイルは、左側のBobファイルエクスプローラーの下部にあります。ファイルを開いて内容を読みます。

BobファイルエクスプローラーのAGENTS.mdファイル

AGENTS.mdファイルには通常、次のコンポーネントが含まれています:

  • プロジェクトの概要と目的
  • ディレクトリ構造と主要なファイルの場所
  • テクノロジースタックと依存関係
  • アーキテクチャパターンと規則
  • 開発ワークフロー

BobはAGENTS.mdを新しい会話に自動的に適用し、プロジェクトコンテキストを学習します。

モード固有のAGENTS.mdファイル

Galaxium TravelsルートディレクトリのメインAGENTS.mdに加えて、/initは各組み込みモードの.bobフォルダーにモード固有のコンテキストファイルを生成します。各モード固有のAGENTS.mdは、そのモードの目的に関連するコンテキストでメインAGENTS.mdを拡張します。次の表にモード固有のAGENTS.mdファイルを示します:

ファイルモード
.bob/rules-code/AGENTS-code.mdAgentモード
.bob/rules-plan/AGENTS-plan.mdPlanモード
.bob/rules-ask/AGENTS-ask.mdAskモード

Planモードコンテキストはアーキテクチャ規則を強調し、Codeモードコンテキストはファイル構造と命名パターンを強調します。

AGENTS.mdファイルを維持する

次のプロジェクト調整を行った後、/initを再実行します:

  • 新しいモジュールまたはサービスの追加
  • ディレクトリ構造の変更
  • 新しいテクノロジーまたはフレームワークの採用
  • Bobを使用する新しいチームメンバーのオンボーディング

また、AGENTS.mdを手動で編集して、Bobの自動スキャンがキャプチャしない可能性のあるコンテキスト(ビジネスルール、デプロイメント規則、チーム固有のプラクティスなど)を追加することもできます。

次のステップ

このチュートリアルでは、次のことを学びました:

  • 大規模言語モデルはステートレスです。/initコマンドを実行することで、Bobがすべての会話の開始時に読み取る永続的なコンテキストファイルであるAGENTS.mdを生成することでこの問題を解決します。
  • モード固有のAGENTS.mdファイルは、Agent、Plan、Askモードに対してターゲットを絞ったコンテキストを提供します。
  • 主要なプロジェクト変更後に/initを再実行して、コンテキストを最新の状態に保ちます。
このトピックはいかがですか?