定义自定义代理

本节介绍如何在 Amazon Q 开发者 CLI 工作流程中创建和使用自定义代理。

创建您的第一个自定义代理

以下是创建第一个自定义代理的 step-by-step演练：

开始 Amazon Q 开发者 CLI 聊天会话：
```
$ q chat
```
列出现有代理以查看可用内容：
```
/agent list
```
创建新代理（my-agent用您的首选名称替换）：
```
/agent create --name my-agent
```
这将创建一个新的代理配置文件并在默认编辑器中将其打开（通过EDITOR环境变量设置）。
根据需要自定义代理配置。为了简单起步，你可能希望：
- 添加描述以解释定制代理的用途
- 指定哪些工具应该可用
- 预先批准您经常使用的工具
保存配置文件并退出编辑器以返回聊天会话。
与您的自定义代理开始新的聊天会话：
```
$ q chat --agent my-agent
```
注意：您无法在现有的聊天会话中切换自定义代理。更改自定义代理需要启动新会话。
通过要求自定义代理使用您配置的工具执行任务来测试您的自定义代理。

有关自定义 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 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

概述

管理自定义代理