本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
概述
定制代理提供了一种通过为不同用例定义特定配置来自定义 Amazon Q Developer CLI 行为的方式。每个自定义代理都由一个 JSON 配置文件定义，该文件指定代理可以访问哪些工具、拥有哪些权限以及应包含哪些上下文。
重要：自定义代理管理主要涉及创建和编辑配置文件。虽然有些命令在聊天会话中可用（如/agent list和/agent create），但在自定义代理之间切换需要与开始新的聊天会话q chat --agent [name]。
自定义代理与默认体验有何不同
默认情况下，Amazon Q Developer CLI 提供对所有可用工具的访问权限，但大多数操作都需要用户确认。这种方法优先考虑安全性，但可能会因为频繁的权限提示而中断您的工作流程。
定制代理通过允许您执行以下操作来解决这个问题：
-
预先批准特定工具-定义哪些工具可以在不提示的情况下运行
-
限制工具访问权限-限制可用的工具以降低复杂性
-
包括相关上下文-自动加载项目文件、文档或系统信息
-
配置工具行为-为工具的操作方式设置具体参数
使用自定义代理的好处
- 工作流优化
-
创建针对特定任务（例如 AWS 基础设施管理、代码审查或调试会话）量身定制的自定义代理。
- 减少中断
-
预先批准可信工具，以消除重点工作会话期间的权限提示。
- 增强的上下文
-
自动包括相关的项目文档、配置文件或系统信息。
- 团队协作
-
与团队成员共享自定义代理配置，以确保一致的开发环境。
- 安全控制
-
将工具访问权限限制为仅限于特定工作流程所需的内容，从而降低潜在的安全风险。
与 MCP 和内置工具的关系
定制代理可使用内置的 Amazon Q Developer CLI 工具和通过模型上下文协议 (MCP) 提供的外部工具。这使您可以灵活地执行以下操作：
-
使用内置工具-文件操作、命令执行、AWS CLI 集成和其他核心功能
-
集成 MCP 服务器-通过 MCP 服务器配置添加自定义工具和服务
-
控制工具访问权限-准确指定每个来源的哪些工具可用
-
管理工具冲突-使用别名来处理不同工具来源之间的命名冲突
有关 MCP 集成的更多信息，请参阅在 Amazon Q 开发者中使用 MCP。
