定義自訂代理程式

本節說明如何在 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。

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

注意：某些自訂代理程式管理操作需要手動檔案編輯，而不是互動式命令。自訂客服人員變更會在您啟動新的聊天工作階段時生效。

當您更新至支援客服人員和登入的 Amazon Q 開發人員 CLI 版本時，如果符合下列條件，系統可能會提示您將舊版設定檔遷移至客服人員：

遷移程序：

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

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

自訂自訂代理程式可讓您：

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

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

概觀

管理自訂代理程式