AI 支援によるエージェントの作成 (/agent generate)

/agent generate コマンドは AI を使用して、カスタムエージェント設定をインテリジェントに作成します。これは、Amazon Q Developer が要件を理解していることを活用して適切な設定を生成するため、新しいエージェントを作成するための推奨アプローチです。

前提条件

• Amazon Q Developer CLI のインストールと設定

• デフォルトのテキストエディタが設定されています (EDITOR環境変数を設定するか、 vi が使用可能であることを確認します)

• ワークスペースディレクトリ (ローカルエージェント用) またはホームディレクトリ (グローバルエージェント用) への書き込みアクセス許可

使用方法

/agent generate

仕組み

1. インタラクティブプロンプト: コマンドの実行後、Q Developer はエージェント名、説明、スコープ (ローカル/グローバル）、および MCP サーバーの選択をプロンプトします。

2. AI 生成: Q Developer は要件を分析し、適切な JSON 設定を生成します。

3. エディタが開きます: 生成された設定がデフォルトのエディタで開き、レビューと絞り込みが行われます。

4. 検証: Q Developer はエディタを保存して閉じるときに JSON スキーマを検証します

5. エージェントの作成: 検証されたエージェントが保存され、使用できるようになります。

ストレージの場所

ローカルエージェント (デフォルト)

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

グローバルエージェント (プロンプトで選択)

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

ワークフローの例

# Start agent generation
/agent generate

# Q Developer prompts for agent name
Enter agent name: my-dev-agent

# Q Developer prompts for description
Enter agent description: I need an agent that helps with Python development, includes linting tools, and can access my project documentation

# Q Developer prompts for scope selection
Agent scope
> Local (current workspace)
  Global (all workspaces)

# Q Developer generates configuration and opens editor
Generating agent configuration...
Opening editor for review...

# After saving and closing editor
Agent 'my-dev-agent' created successfully at .amazonq/cli-agents/my-dev-agent.json

エディタ設定

コマンドはシステムのデフォルトエディタを使用します。

• 設定されている場合はEDITOR環境変数を使用します

• エディタが設定されviていない場合は、 に戻ります。

エラー処理

JSON が無効です

設定が拒否され、明確なエラーメッセージが表示される

エディタの失敗

有益なエラーメッセージによる適切な処理

ファイルシステムエラー

アクセス許可またはパスの問題のクリアレポート

関連コマンド

• /agent create - 手動エージェント作成アプローチ

• /agent list - 使用可能なエージェントを表示する

• /agent schema - エージェント設定スキーマを表示する

ベストプラクティス

• エージェントのニーズを説明する際に、詳細で具体的な要件を提供する

• 保存する前に生成された設定を確認してカスタマイズする

• 複雑なワークフローの前に、シンプルなタスクで新しいエージェントをテストする

• 目的を反映したわかりやすいエージェント名を使用する