カスタムエージェントの管理 - Amazon Q Developer
カスタムエージェントファイルの場所カスタムエージェントを整理するためのベストプラクティスチームとのカスタムエージェントの共有

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

カスタムエージェントの管理

このセクションでは、開発ワークフローでカスタムエージェントを効果的に整理、管理、操作する方法について説明します。

カスタムエージェントファイルの場所

カスタムエージェント設定ファイルは、特定のディレクトリに JSON ファイルとして保存されます。

グローバルカスタムエージェント

~/.aws/amazonq/cli-agents/{agent-name}.json

システム上のすべてのプロジェクトとディレクトリで使用できます。

プロジェクトレベルのカスタムエージェント

.amazonq/cli-agents/{agent-name}.json

特定のプロジェクトディレクトリとそのサブディレクトリ内でのみ使用できます。

重要： ファイル名{agent-name}の は参考用です。実際のエージェント名は、JSON 設定ファイル自体内の nameフィールドによって決まります。これは必須です。

カスタムエージェントの優先順位と競合の解決

Amazon Q Developer CLI がカスタムエージェントを検索する場合、特定の優先順位に従います。

  1. ローカルカスタムエージェントを最初に - 現在の作業ディレクトリ内のカスタムエージェントをチェックします

  2. グローバルカスタムエージェント秒 - ホームディレクトリのカスタムエージェントにフォールバックします

  3. 組み込みデフォルト - カスタムエージェントが見つからない場合はデフォルトエージェントを使用します

ローカルディレクトリとグローバルディレクトリの両方に同じ名前のカスタムエージェントが含まれている場合、ローカルカスタムエージェントが優先されます。Amazon Q Developer CLI では、これが発生すると警告メッセージが表示されます。

WARNING: Agent conflict for my-agent. Using workspace version.

この優先順位システムにより、次のことが可能になります。

  • グローバルカスタムエージェントをプロジェクト固有のバージョンで上書きする

  • カスタムエージェントの変更をグローバルにする前にローカルでテストする

  • プロジェクトごとに異なるカスタムエージェント設定を維持する

カスタムエージェントを整理するためのベストプラクティス

グローバルカスタムエージェントを使用するタイミング

グローバルカスタムエージェントを以下に使用します。

  • 汎用ワークフロー - 複数のプロジェクトで使用されるカスタムエージェント

  • 個人の生産性 - 個々のワークスタイルに合わせたカスタムエージェント

  • 一般的な開発タスク - コードレビュー、デバッグ、ドキュメント生成

  • ツール固有のワークフロー - AWS 管理、Git オペレーション、Docker ワークフロー

ローカルカスタムエージェントを使用するタイミング

ローカルカスタムエージェントを以下に使用します。

  • プロジェクト固有の設定 - 特定のプロジェクトファイルにアクセスする必要があるカスタムエージェント

  • チームコラボレーション - バージョン管理を通じて共有されるカスタムエージェント

  • 開発環境 - 特定のプロジェクトに固有の要件を持つカスタムエージェント

  • テストと実験 - グローバル設定に影響を与えない一時的なカスタムエージェントの変更

カスタムエージェントの命名規則

カスタムエージェント組織を改善するには、次の命名規則を検討してください。

  • 目的ベースの名前 - aws-specialist.json、code-reviewer.json、 documentation-writer.json

  • テクノロジー固有の名前 - python-dev.json、react-frontend.json、 terraform-ops.json

  • プロジェクト固有の名前 - project-alpha.json、mobile-app.json、 api-backend.json

  • 環境固有の名前 - development.json、staging.json、 production.json

チームとのカスタムエージェントの共有

ローカルカスタムエージェントは、バージョン管理システムを通じてチームメンバーと共有できます。このアプローチにより、チームは次のことが可能になります。

  • 開発環境の標準化 - すべてのチームメンバーが同じツールと設定にアクセスできることを確認します

  • プロジェクト固有のコンテキストを共有する - プロジェクトドキュメント、コーディング標準、カスタムスクリプトを含める

  • 一貫性を維持する - チーム全体で同じツールのアクセス許可と設定を使用する

  • 改善に協力する - プルリクエストを使用してカスタムエージェント設定を確認および改善する

バージョン管理のベストプラクティス

バージョン管理を通じてカスタムエージェントを共有する場合：

  • カスタムエージェントディレクトリを含める - リポジトリ.aws/amazonq/agents/に追加する

  • カスタムエージェントの目的を文書化する - カスタムエージェント設定ファイルで明確な説明を使用する

  • カスタムエージェントの変更を確認する - カスタムエージェント設定の変更をコード変更のように処理する

  • カスタムエージェント設定をテストする - 共有カスタムエージェントがすべてのチームメンバーに対して正しく動作することを確認する

  • 機密情報の回避 - API キー、パスワード、または個人情報を共有カスタムエージェントに含めないでください