View a markdown version of this page

创建自定义代理 - AWS DevOps 代理人
使用表单创建自定义代理使用 Chat 创建自定义代理编写系统提示符配置工具配置技能

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

创建自定义代理

您可以通过两种方式创建自定义代理：使用代 DevOps 理 Web 应用程序中的表单，或者通过聊天中的引导式对话来创建自定义代理。这两种方法都会生成存储在代理空间中的相同自定义代理配置。

在创建自定义代理之前，必须有一个至少包含一个已连接集成的代理空间。有关更多信息，请参阅 创建代理空间。

使用表单创建自定义代理

该表单允许您通过指定名称、系统提示和可选技能来快速创建自定义代理。要为代理分配 MCP 工具，请在创建代理后使用 Chat。

要使用表单创建自定义代理，请执行以下操作：

  1. 在您的代理 Web 应用程序中导航到 DevOps 代理页面。

  2. 在 “自定义代理” 部分，选择 “创建代理”。

  3. 在对话框中，选择 “表单”。

  4. 填写表格：

    • 姓名-您的代理的唯一标识符。仅使用小写字母、数字和连字符（最多 64 个字符）。不得以连字符开头或结尾。示例：weekly-health-report

    • 系统提示符 — 定义代理的作用及其操作方式的说明，以 Markdown 编写（最少 10 个字符，最多 50,000 个字符）。有关编写有效提示的指导，请参阅编写系统提示符。

    • 技能（可选）-从您的代理空间中选择可为代理提供更多领域知识或能力的技能。使用搜索字段按名称查找技能。

  5. 选择 Create agent (创建代理)。

创建后，您将被重定向到代理的详细信息页面，您可以在其中查看配置、运行代理或设置触发器。

使用 Chat 创建自定义代理

聊天为创建自定义代理提供了引导式对话体验。当您要将 MCP 工具分配给代理或需要帮助编写系统提示时，建议使用此方法。

要使用 Chat 创建自定义代理，请执行以下操作：

  1. 在您的代理 Web 应用程序中导航到 DevOps 代理页面。

  2. 在 “自定义代理” 部分，选择 “创建代理”。

  3. 在对话框中，选择聊天。对话框关闭，并在 “聊天” 面板中打开一个带有预先撰写的消息的新对话。

  4. 聊天将引导您完成协作流程：

    • 意图澄清-确认您的代理人的目的和范围。

    • 重复检查-验证您的代理空间中不存在类似的代理。

    • 工具和技能选择 — 建议代理需要哪些 MCP 工具和技能，并要求您进行确认。

    • 输出类型-确定代理是否应生成文本响应、构件或建议。

    • 系统提示草稿 — 编写系统提示并提交给您审阅。你可以迭代直到你满意为止。

    • 确认-建议名称并确认所有设置，然后再创建代理。

您也可以随时通过直接询问 Chat 来创建自定义代理。例如：

Create an agent that generates a weekly report of all investigations from the past week.
Create a custom agent for checking certificate expiration across all accounts.
Make me an agent that audits DynamoDB table configurations daily.

编写系统提示符

系统提示符是您的自定义代理中最重要的部分。它定义了代理的目的、方法、限制和预期输出。写得好的提示会产生一致、可靠的结果。

使用以下部分来构造系统提示符：

  • 目标 — 代理人应在一句话或一段简短的段落中完成的任务。

  • 方法 — 代理应遵循的 Step-by-step 程序，引用它应该调用的特定工具名称以及按什么顺序调用。

  • 限制 — 代理应该做什么和不应该做什么的界限。例如，只读访问权限、要考虑的时间范围或要排除的服务。

  • 输出-代理应生成什么内容以及以何种格式。指定它应该生成文本、创建构件还是创建推荐。

系统提示示例：

You are a DevOps reporting agent specializing in summarizing investigation activity.

## Goal
Generate a concise weekly report of all investigations from the past 7 days.

## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.

## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.

## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.

有关有效系统提示的提示：

  • 具体说明工具-直接引用工具名称（例如、list_investigationsuse_aws、query_cloudwatch_logs），以便代理知道要调用哪些工具。

  • 定义成功标准-描述好的输出是什么样子，以便代理知道何时完成。

  • 设定界限-明确说明代理不应采取哪些措施来防止意外操作。

  • 使用 Markdown 格式 — 标题、列表和代码块使代理更容易解析和遵循提示。

配置工具

MCP 工具决定您的自定义代理在调用期间可以执行哪些操作。您可以从 Agent Space 中可用的全套工具中选择工具，包括来自关联 AWS 账户、可观测性平台、 CI/CD 管道、票务系统和自定义 MCP 服务器的工具。

只能通过 “聊天” 配置工具。要在创建代理时分配工具，请使用聊天创建方法。要在现有代理上添加或更改工具，请让 Chat 更新代理。例如：

Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
Update certificate-checker to also use the list_resources tool.
Remove the use_kubectl tool from cluster-audit-agent.

选择工具时，请遵循最低权限原则，即仅分配代理完成任务所需的工具。这样可以降低意外操作的风险，并使代理保持专注。

配置技能

技能可为您的定制代理提供额外的领域知识、调查程序或专业能力。当自定义代理运行时，它会加载其分配的技能，并且可以在调用期间参考其指令。

您可以在创建过程中分配技能（使用表单或聊天），也可以稍后通过编辑代理来添加技能。分配给定制代理的技能必须已经存在于您的特工空间中。有关创建技能的更多信息，请参阅DevOps 特工技能。

自定义代理还具有内置功能，可以创建不需要分配技能的构件和推荐。有关更多信息，请参阅 自定义代理输出。

每个自定义代理最多可以分配 200 个技能。选择与代理目的相关的技能，以减少情境消耗并提高代理的注意力。