定義自訂代理程式

本節說明如何在 Amazon Q Developer CLI 工作流程中建立和使用自訂代理程式。

建立您的第一個自訂代理程式

以下是建立第一個自訂代理程式逐步解說：

啟動 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。

自訂代理程式命令
Command	描述	可用性
`/agent list`	顯示您環境中所有可用的自訂代理程式	聊天工作階段
`/agent schema`	顯示用於建立自訂代理程式組態檔案的 JSON 結構描述	聊天工作階段
`/agent create --name [name]`	建立新的自訂代理程式組態檔案，並在您的預設編輯器中將其開啟	聊天工作階段

注意：有些自訂代理程式管理操作需要手動編輯檔案，而無法使用互動式命令。自訂代理程式變更會在您啟動新的聊天工作階段時生效。

當您更新為支援代理程式的 Amazon Q Developer CLI 版本並登入時，如果出現下列情況，系統可能會提示您將舊版設定檔移轉至代理程式：

移轉程序：

移轉為選擇性，您可以拒絕。如果您選擇不移轉，您可以繼續使用預設代理程式或手動建立新的代理程式。若要控制移轉行為，請使用 --no-interactive 旗標完全略過移轉提示。

Amazon Q Developer CLI 包含內建的預設代理程式，可讓您使用最少的預先核准許可存取所有工具。此預設代理程式：

自訂代理程式可讓您：

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

概觀

管理自訂代理程式