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

# 创建自定义代理
<a name="custom-agents-creating-a-custom-agent"></a>

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

在创建自定义代理之前，必须有一个至少包含一个已连接集成的代理空间。有关更多信息，请参阅 [创建代理空间](getting-started-with-aws-devops-agent-creating-an-agent-space.md)。

## 使用表单创建自定义代理
<a name="creating-a-custom-agent-using-the-form"></a>

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

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

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

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

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

1. 填写表格：
   + **姓名**-您的代理的唯一标识符。仅使用小写字母、数字和连字符（最多 64 个字符）。不得以连字符开头或结尾。示例：`weekly-health-report`
   + **系统提示符** — 定义代理的作用及其操作方式的说明，以 Markdown 编写（最少 10 个字符，最多 50,000 个字符）。有关编写有效提示的指导，请参阅[编写系统提示符](#writing-a-system-prompt)。
   + **技能**（可选）-从您的代理空间中选择可为代理提供更多领域知识或能力的技能。使用搜索字段按名称查找技能。

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

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

## 使用 Chat 创建自定义代理
<a name="creating-a-custom-agent-using-chat"></a>

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

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

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

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

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

1. 聊天将引导您完成协作流程：
   + **意图澄清**-确认您的代理人的目的和范围。
   + **重复检查**-验证您的代理空间中不存在类似的代理。
   + **工具和技能选择** — 建议代理需要哪些 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.
```

## 编写系统提示符
<a name="writing-a-system-prompt"></a>

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

**使用以下部分来构造系统提示符：**
+ **目标** — 代理人应在一句话或一段简短的段落中完成的任务。
+ **方法** — 代理应遵循的 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_investigations``use_aws`、`query_cloudwatch_logs`），以便代理知道要调用哪些工具。
+ **定义成功标准**-描述好的输出是什么样子，以便代理知道何时完成。
+ **设定界限**-明确说明代理不应采取哪些措施来防止意外操作。
+ **使用 Markdown 格式** — 标题、列表和代码块使代理更容易解析和遵循提示。

## 配置工具
<a name="configuring-tools"></a>

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.
```

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

## 配置技能
<a name="configuring-skills"></a>

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

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

自定义代理还具有内置功能，可以创建不需要分配技能的构件和推荐。有关更多信息，请参阅 [自定义代理输出](custom-agents-custom-agent-outputs.md)。

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