カスタムエージェントの定義

このセクションでは、Amazon Q Developer CLI ワークフローでカスタムエージェントを作成して使用する方法について説明します。

最初のカスタムエージェントの作成

最初のカスタムエージェントを作成するためのstep-by-stepのチュートリアルを次に示します。

Amazon Q Developer CLI チャットセッションを開始します。
```
$ q chat
```
既存のエージェントを一覧表示して、利用可能なものを確認します。
```
/agent list
```
新しいエージェントを作成します (my-agent を任意の名前に置き換えます）。
```
/agent create --name my-agent
```
これにより、新しいエージェント設定ファイルが作成され、デフォルトのエディタで開きます (EDITOR環境変数を介して設定）。
必要に応じてカスタムエージェント設定をカスタマイズします。簡単に開始するには、次の操作を行います。
- カスタムエージェントの目的を説明する説明を追加する
- どのツールを使用できるかを指定する
- 頻繁に使用するツールを事前承認する
設定ファイルを保存し、エディタを終了してチャットセッションに戻ります。
カスタムエージェントで新しいチャットセッションを開始します。
```
$ q chat --agent my-agent
```
注：既存のチャットセッション内でカスタムエージェントを切り替えることはできません。カスタムエージェントの変更では、新しいセッションを開始する必要があります。
設定したツールを使用してタスクを実行するように依頼して、カスタムエージェントをテストします。

カスタムエージェント設定オプションの詳細については、「設定リファレンス」を参照してください。

Amazon Q Developer CLI には、カスタムエージェントを管理するためのコマンドがいくつか用意されています。これらのコマンドはチャットセッション中に使用でき、で開始します/agent。

カスタムエージェントコマンド
コマンド	説明	可用性
`/agent list`	環境で使用可能なすべてのカスタムエージェントを表示します。	チャットセッション
`/agent schema`	カスタムエージェント設定ファイルを作成するための JSON スキーマを表示します	チャットセッション
`/agent create --name [name]`	新しいカスタムエージェント設定ファイルを作成し、デフォルトのエディタで開きます	チャットセッション

注：一部のカスタムエージェント管理オペレーションでは、インタラクティブコマンドではなく手動ファイル編集が必要です。カスタムエージェントの変更は、新しいチャットセッションを開始すると有効になります。

エージェントをサポートする Amazon Q Developer CLI のバージョンに更新してサインインすると、次の場合にレガシープロファイルをエージェントに移行するように求められる場合があります。

移行プロセス：

移行はオプションであり、拒否できます。移行しないことを選択した場合は、引き続きデフォルトのエージェントを使用するか、新しいエージェントを手動で作成できます。移行動作を制御するには、 --no-interactiveフラグを使用して移行プロンプトを完全にスキップします。

Amazon Q Developer CLI には、事前承認された最小限のアクセス許可ですべてのツールへのアクセスを提供する組み込みのデフォルトエージェントが含まれています。このデフォルトのエージェント：

カスタムカスタムエージェントを使用すると、次のことができます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

概要

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