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

# 代理说明
<a name="about-aws-devops-agent-agent-instructions"></a>

使用代理说明提供始终在线的指导，该 AWS DevOps 指导适用于每个会话。会话是与代理人的单次对话或调查。在 Agent Space Operator Web 应用程序的**代理**页面上，您可以设置适用于所有代理的**全局**指令，或者为特定的托管代理设置指令，例如聊天或事件分类。这些指令以 AGENTS.md 文件形式存储。与代理将技能描述与当前任务匹配时按需加载不同[DevOps 特工技能](about-aws-devops-agent-devops-agent-skills.md)，无论代理正在处理什么，代理指令始终从每个会话一开始就会出现。

## 什么是代理说明
<a name="what-are-agent-instructions"></a>

代理说明为您的代理提供无条件、始终在线的指导。在每个会话开始时，代理服务都会检索为您的 Agent Space 配置的指令，并将其内容直接注入代理系统提示符中。代理不决定是否加载它们；它们始终在场。

每个代理会话都会收到来自全局指令和相关代理特定指令（例如 Chat）的指令。

代理指令以 AGENTS.md 文件形式存储，[DevOps 特工技能](about-aws-devops-agent-devops-agent-skills.md)在几个重要方面有所不同：


| 方面 | 技能 | 代理说明 (AGENTS.md) | 
| --- | --- | --- | 
| 名称和描述 | 必需 | 不适用 | 
| 内容格式 | 降价或 ZIP 捆绑包 | 仅限降价 | 
| 资源文件 | 支持 | 不支持 | 
| 上下文注入 | 按需（代理通过技能描述匹配决定） | 始终（无条件，每次会话） | 
| 独特性 | 每个代理空间有多个 | 每个代理一个（一个用于全局指令，每个托管代理一个） | 

代理说明没有名称或描述字段。底层 AGENTS.md 文件仅包含 markdown，没有 frontmatter，不支持 ZIP 包，也没有资源文件。

## 为什么要使用代理说明
<a name="why-use-agent-instructions"></a>

代理说明为您提供了一种可靠的方法，可以确保某些指导始终符合上下文，而不必依赖于代理的技能负荷决策。

**主要好处：**
+ **可预测性：**无论代理正在执行什么任务，指令始终存在。无需匹配描述，代理也无法跳过内容。
+ **有保障的覆盖范围：**与代理根据任务相关性可能加载也可能不加载技能不同，代理指令总是在每个会话开始时注入。
+ **常设政策：**使用代理说明来制定常设运营政策、安全指南、编码标准或任何必须毫无例外地适用于每个会话的指南。
+ **目标范围：**您可以使用全局指令一次将指令应用于所有代理类型，或者当指导仅与该代理的工作相关时，将指令限制在特定的代理类型上。

## 代理指令的工作原理
<a name="how-agent-instructions-work"></a>

会话启动时，代理服务会检索为代理空间配置的指令，并在会话开始之前将其内容注入代理系统提示符中。每次会话都会自动发生这种情况。代理不评估是否加载它们；它总是注入内容。

每个新会话都会在启动时重新加载指令。如果您更新了说明，则更改会立即对保存后开始的会话生效。已在进行的会话将继续使用启动时加载的内容。

范围界定决定会话接收哪些指令。全局指令适用于您的代理空间中的所有代理类型，因此每个会话都会收到这些指令。 Agent-specific 说明仅适用于该特定代理类型的会话。会话接收来自全局指令和相关代理特定指令的指令。

## 代理类型范围界定
<a name="agent-type-scoping"></a>

作用域控制哪些代理会话会收到一组给定的指令。有两个范围界定选项：
+ **全局指令：**适用于您的代理空间中的所有代理类型。每个代理会话都会收到此内容。
+ **Agent-specific：**仅适用于所选代理类型的会话。

可用于代理特定指令的托管代理有：
+ **聊天-聊天**会话期间 Ad-hoc 的问题和请求。
+ **事件分类**-警报筛选、严重性分类和初始范围界定。
+ **事件 RCA**-通过证据收集和验证进行根本原因分析。
+ **事故缓解**- Short-term 补救措施和长期修复建议。
+ **评估**-代理绩效评分和策略合规性检查。

## 内容大小指南
<a name="content-size-guidance"></a>

每次你开始对话或调查时，代理都会先阅读你的全部说明，然后再做其他任何事情。代理在每个会话中都有固定数量的工作内存，您的指令会使用其中的一部分。文件越大，用于提问、调查、代理阅读的日志和自己的推理的空间就越小。更简短、更有针对性的说明使代理有更大的能力来解决您的问题。
+ **硬限制：**25 KB
+ **推荐尺寸：**120 行（建议用于大多数配置）

将指示重点放在每节课中都必须提供的指导上。对于仅适用于特定任务的专门调查程序，请考虑[DevOps 特工技能](about-aws-devops-agent-devops-agent-skills.md)改用。

## 示例
<a name="example"></a>

以下示例显示了格式良好的代理指令，其中包含适用于每个代理会话的调查指导、响应格式标准和安全要求。

```
# Agent Instructions

## Investigation approach
- Always check CloudWatch alarms and recent deployments before proposing a root cause.

## Response format
- Lead with a one-sentence summary of findings before listing details.
- Include the AWS region and resource identifier for any resource you reference.
- Use bullet points for lists of findings or recommendations.

## Security
- Never log, display, or suggest storing credentials or secrets in plaintext.
- When recommending IAM changes, follow least-privilege principles.
```

## 设置代理说明
<a name="setting-agent-instructions"></a>

在设置代理指令之前，必须有一个代理空间。有关更多信息，请参阅 [创建代理空间](getting-started-with-aws-devops-agent-creating-an-agent-space.md)。

每个代理只有一组指令。当您保存新内容时，它会覆盖该代理的现有内容。

**要设置全局指令（适用于所有代理），请执行以下操作：**

1. 在 Agent Space Operator Web 应用程序中导航到**代理**页面。

1. 选择 “**全球指令**” 旁边的 “**查看**”。

1. 在编辑器中输入降价说明。

1. 选择**保存**。

**要为特定代理设置指令，请执行以下操作：**

1. 在 Agent Space Operator Web 应用程序中导航到**代理**页面。

1. **在**托管代理**下，选择要配置的代理旁边的**查看**：**聊天**、**事件分类**、**事件 RCA**、**事件缓解**或评估。**

1. 在编辑器中输入降价说明。

1. 选择**保存**。

## 管理代理指令
<a name="managing-agent-instructions"></a>

AWS DevOps 代理通过操作员 Web 应用程序为代理指令提供管理功能。

**查看说明：**导航到 “**代理**” 页面，然后选择 “**全局指令**” 或特定托管代理旁边的 “**查**看”。编辑器显示当前内容。使用 “**预览**” 选项卡查看渲染的降价，或者使用 “**代码**” 选项卡查看原始降价。

**编辑说明：**如上所述打开代理，在编辑器中修改内容，然后选择**保存**。

**从文件上传说明：**打开代理，然后在编辑器中选择**上传**按钮，从您的计算机上传 markdown 文件。

**下载说明：**打开代理，然后在编辑器中选择 “**下载**” 按钮，将当前内容下载为文件。

**删除指令：**打开代理，在编辑器中选择 “**删除**” 按钮，然后确认删除。并且无法撤消。如果您再次需要这些内容，可以考虑先下载内容。