在 AI 帮助下创建代理（/代理生成） - Amazon Q 开发者版
先决条件使用量工作方式存储位置工作流示例编辑器配置错误处理相关命令最佳实践

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 AI 帮助下创建代理（/代理生成）

该/agent generate命令使用 AI 智能地创建自定义代理配置。这是创建新代理的推荐方法，因为它可以利用 Amazon Q Developer 对您的要求的了解来生成适当的配置。

先决条件

  • 安装并配置了 Amazon Q 开发者 CLI

  • 已配置默认文本编辑器（设置EDITOR环境变量或确保可vi用）

  • 写入工作区目录（适用于本地代理）或主目录（适用于全局代理）的权限

使用量

/agent generate

工作方式

  1. 交互式提示：运行命令后，Q Developer 会提示您输入代理名称、描述、范围（本地/全局）和 MCP 服务器选择

  2. AI 生成：Q Developer 会分析您的需求并生成相应的 JSON 配置

  3. 编辑器打开：生成的配置将在默认编辑器中打开以供查看和完善

  4. 验证：Q Developer 会在您保存并关闭编辑器时验证 JSON 架构

  5. 创建代理：已保存经过验证的代理并可供使用

存储位置

本地代理（默认）

.amazonq/cli-agents/agent-name.json

全局代理（通过提示选择）

~/.aws/amazonq/cli-agents/agent-name.json

工作流示例

# Start agent generation
/agent generate

# Q Developer prompts for agent name
Enter agent name: my-dev-agent

# Q Developer prompts for description
Enter agent description: I need an agent that helps with Python development, includes linting tools, and can access my project documentation

# Q Developer prompts for scope selection
Agent scope
> Local (current workspace)
  Global (all workspaces)

# Q Developer generates configuration and opens editor
Generating agent configuration...
Opening editor for review...

# After saving and closing editor
Agent 'my-dev-agent' created successfully at .amazonq/cli-agents/my-dev-agent.json

编辑器配置

该命令使用系统的默认编辑器：

  • 如果已设置，则使用EDITOR环境变量

  • vi如果未配置编辑器，则回退到

错误处理

JSON 无效

配置被拒绝并显示明确的错误消息

编辑器失败

通过信息丰富的错误消息进行优雅的处理

文件系统错误

明确报告权限或路径问题

  • /agent create-手动创建代理的方法

  • /agent list-查看可用的代理

  • /agent schema-查看代理配置架构

最佳实践

  • 在描述您的代理需求时，请提供详细的具体要求

  • 保存前请查看和自定义生成的配置

  • 在复杂的工作流程之前，使用简单的任务测试您的新代理

  • 使用能反映其目的的描述性代理名称