View a markdown version of this page

创建自定义代理 - AWS DevOps 代理人
使用表单创建自定义代理使用 Chat 创建自定义代理从存储库导入自定义代理社区定制代理编写系统提示符配置工具版本管理器工具配置技能

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

创建自定义代理

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

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

使用表单创建自定义代理

该表单允许您通过指定名称、系统提示和可选技能来快速创建自定义代理。要为代理分配 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.

从存储库导入自定义代理

您可以直接从 GitHub 存储库中的 Markdown 文件导入自定义代理的系统提示。文件内容成为代理的系统提示符。您可以在版本控制中管理代理提示，并通过单个操作将其导入。

先决条件：

  • 与您的代理空间关联的 GitHub 帐户。要关联 GitHub 账户，请参阅正在连接 GitHub。任何 GitHub 帐户连接都允许从公共存储库导入。对于私有仓库，关联的账户必须具有对仓库的读取权限。 GitHub 还支持具有数据驻留连接的 GitHub 企业服务器和企业云。

  • GitHub 存储库中包含系统提示符的 Markdown 文件 (.md)。

要从存储库导入自定义代理，请执行以下操作：

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

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

  3. 在对话框中，选择 “导入” 。对话框更改为 “从 GitHub视图导入”。

  4. 填写表格：

    • 名称 — 代理的唯一标识符。仅使用小写字母、数字和连字符（最多 64 个字符）。不得以连字符开头或结尾。

    • 存储库 URL — 指向包含代理系统提示符的单个 Markdown (.md) 文件的链接。例如：https://github.com/my-org/my-repo/blob/main/my-agent.md。对于具有数据驻留权的 GitHub GitHub 企业服务器或企业云，请改用您的实例 URL。例如：https://github.example.com/my-org/my-repo/blob/main/my-agent.md。如果 URL 不以结尾.md，则会显示警告。如果文件不是 Markdown，则导入失败。

    • 技能（可选）-从代理空间中选择技能，为代理提供额外的领域知识或能力。

  5. 选择导入代理。

存储库文件仅提供系统提示。名字和技能来自表格。

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

查看导入的代理：

导入的代理在代理详细信息页面的名称旁边显示 “已同步来源” GitHub 标记，以及上次同步的时间戳和指向该源文件的链接。 GitHub在自定义代理列表中，导入的代理包含指向其源文件的链接。

如果您编辑导入的代理，系统提示符会显示一个带有链接到源文件的提示的Read-only标签。名称和技能保持可编辑状态。

同步导入的代理：

当您更新存储库中的 Markdown 文件时，打开导入代理的详细信息页面，然后选择 Sync 以提取最新的系统提示。

约束：

  • URL 格式 — 仅接受 GitHub URL，包括具有数据驻留权的 GitHub GitHub 企业服务器和企业云。连接的 GitHub 账户必须与 URL 主机相匹配。例如，github.example.com连接只能从 URL 导入，不能从 github.example.com github.com URL 导入。

  • 需要 Markdown 文件 — URL 必须指向单个.md文件。

  • 最大文件大小 -文件不得超过 1 MB（GitHub API 限制）。

  • GitHub 需要帐户 -您的代理空间必须有关联的 GitHub 帐户才能导入代理。对于私有仓库，该账户必须具有读取权限。

社区定制代理

AWS DevOps Agent Tools 存储库包括预先构建的自定义代理配置，用于执行定期操作任务，例如运行状况报告、操作审查和服务配额监控。存储库由 AWS DevOps 代理服务团队维护，所有贡献在添加之前都要经过相同的安全审查栏。要浏览可用的内容，请参阅 GitHub 网站上的自定义代理目录。

要使用社区自定义代理，请使用 “代理” 页面上的 “从存储库导入” 流程将其从存储库中导入。复制代理的 Markdown 文件的 URL 并将其粘贴为存储库 URL。有关详细信息，请参阅从存储库导入自定义代理。

编写系统提示符

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

使用以下部分构造您的系统提示：

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

  • 方法 — 代理应遵循的 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.

选择工具时，遵循最小权限原则，仅分配代理完成任务所需的工具。这降低了意外行为的风险，并使代理保持专注。

版本管理器工具

自定义代理可以访问版本管理器工具。这些工具允许您的代理创建、列出、获取和取消版本管理器任务。您的代理人还可以分析发布准备情况审查报告，以显示调查结果和建议的行动。

要使用发布管理器工具，请通过聊天将其分配给您的自定义代理。例如：

Add the release manager tools to my release-pipeline-agent.

有关版本管理功能的更多信息，请参阅发布管理。

配置技能

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

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

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

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