定义自定义代理

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

创建第一个自定义代理

以下是创建第一个自定义代理的分步演练：

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

有关自定义代理配置选项的详细信息，请参阅配置参考。

Amazon Q 开发者版 CLI 提供了多个用于管理自定义代理的命令。这些命令在聊天会话中可用，开头为 /agent。

自定义代理命令
命令	描述	可用性
`/agent list`	显示环境中所有可用的自定义代理	聊天会话
`/agent schema`	显示用于创建自定义代理配置文件的 JSON 架构	聊天会话
`/agent create --name [name]`	创建新的自定义代理配置文件并在默认编辑器中将其打开	聊天会话

注意：某些自定义代理管理操作需要手动编辑文件，而不是交互式命令。自定义代理更改将在您开始新的聊天会话时生效。

当您更新到支持代理的 Amazon Q 开发者版 CLI 版本并登录时，在以下情况下，系统可能会提示您将旧版配置文件迁移到代理：

迁移过程：

迁移是可选的，可以拒绝。如果您选择不迁移，则可以继续使用默认代理或手动创建新代理。要控制迁移行为，请使用 --no-interactive 标志来完全跳过迁移提示。

Amazon Q 开发者版 CLI 包含一个内置的默认代理，可让用户以最低的预先批准权限访问所有工具。这个默认代理：

自定义代理支持您：

Javascript 在您的浏览器中被禁用或不可用。

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

概述

管理自定义代理