Overview
このガイドでは、ローカル開発環境で Atlas Agent Engineエージェントを手動でテストする方法を学習できます。 agentengine dev コマンドを使用して環境を起動すると、CLI はアプリとローカルMongoDBインスタンスの URL を出力します。これにより、エージェントを構築してクラウドに配置する前に、リクエストをドライバーで行い、応答を検査して、問題をデバッグすることができます。
前提条件
開始する前に、次のタスクが完了していることを確認してください。
Agent engine CLI をインストールして構成します。
CLI のインストール、認証、プロジェクトの登録方法の詳細については、「 インストールと認証 」を参照してください。
ローカル サービスへのアクセス
ホットリロードまたは 分離モードのいずれかで agentengine dev up を実行すると、CLI はエージェントのDockerイメージを構築し、 フルスタックを起動します。すべてのサービスが準備完了すると、CLI はアプリとローカルMongoDBインスタンスの URL を出力します。
手動テストを実行するには、次の URL を使用します。
アプリエンドポイントURL: ブラウザ、 APIクライアント、または コマンドライン ツールを使用して、エージェントにリクエストを送信します。
MongoDB AtlasローカルURL:
mongoshまたは別のMongoDBクライアントを使用して接続し、テスト データを検査またはシードします。
例、これらの URL を使用して、次のテストを実行できます。
特定のツール呼び出しを実行するチャットまたはHTTPリクエストを送信します。
テスト ドキュメントをローカルデータベースに挿入し、エージェントがそれをどのように使用するかを確認します。
応答の正確性、レイテンシ、およびエラー処理を調べます。
ホットリロード モードでのテスト
ホットリロードモードでは、ソースコードがアプリコンテナにマウントされ、変更を保存するたびにエージェントがプロセスを再読み込みします。次のワークフローを使用して、スタック を再ビルドせずにテストと反復処理を行います。
ホットリロードモードで環境を起動する方法、または実行中のコンテナにVS Codeをアタッチする方法については、 ローカル環境の構築ガイドの「 ホットリロード モード（推奨） 」を参照してください。
分離モードでテストする
サービス境界、コンテナの再起動、またはネットワーク インタラクションに依存する動作を検証する場合は、分離モードを使用します。
分離モードで環境を起動する方法については、 ローカル環境の構築ガイドの「 分離モード 」を参照してください。
ログの調査とトラブルシューティング
テスト中は、必要に応じて agentengine dev コマンドを使用してログを検査し、状態をリセットします。
ログの表示
実行中のすべてのサービスからログをストリーミングするには、次のコマンドを実行します。
agentengine dev logs
この出力を使用して、エラーのデバッグ、ツール呼び出しの検証、およびエージェントによって発行されたトレース メッセージを検査します。
ローカル状態のリセット
ローカルMongoDBレプリカセットまたはデータに関連する永続的なエラーが発生した場合は、次のコマンドを実行中てローカル状態をリセットできます。
agentengine dev clean agentengine dev up
このシーケンスにより、すべてのローカル ボリュームが削除され、新しいスタックが開始されます。
警告
agentengine dev clean を実行すると、MongoDB Atlas Local ボリュームに保存されているすべてのローカルデータが永続的に削除されます。このコマンドを実行する前に、必要なデータをバックアップしてください。
次のステップ
エージェントをローカルで検証した後、それをビルドして Atlas Agent Engineクラウド環境に配置できます。エージェントイメージをパッケージ、ワークスペースに配置する方法については、「 エージェントの配置 」セクションを参照してください。