本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
代理说明
使用代理说明提供始终在线的指导，该 AWS DevOps 指导适用于每个会话。会话是与代理人的单次对话或调查。在 Agent Space Operator Web 应用程序的代理页面上，您可以设置适用于所有代理的全局指令，或者为特定的托管代理设置指令，例如聊天或事件分类。这些指令以 AGENTS.md 文件形式存储。与代理将技能描述与当前任务匹配时按需加载不同DevOps 特工技能，无论代理正在处理什么，代理指令始终从每个会话一开始就会出现。
什么是代理说明
代理说明为您的代理提供无条件、始终在线的指导。在每个会话开始时，代理服务都会检索为您的 Agent Space 配置的指令，并将其内容直接注入代理系统提示符中。代理不决定是否加载它们；它们始终在场。
每个代理会话都会收到来自全局指令和相关代理特定指令（例如 Chat）的指令。
代理指令以 AGENTS.md 文件形式存储，DevOps 特工技能在几个重要方面有所不同：
| 方面 | 技能 | 代理说明 (AGENTS.md) |
|---|---|---|
| 名称和描述 | 必需 | 不适用 |
| 内容格式 | 降价或 ZIP 捆绑包 | 仅限降价 |
| 资源文件 | 支持 | 不支持 |
| 上下文注入 | 按需（代理通过技能描述匹配决定） | 始终（无条件，每次会话） |
| 独特性 | 每个代理空间有多个 | 每个代理一个（一个用于全局指令，每个托管代理一个） |
代理说明没有名称或描述字段。底层 AGENTS.md 文件仅包含 markdown，没有 frontmatter，不支持 ZIP 包，也没有资源文件。
为什么要使用代理说明
代理说明为您提供了一种可靠的方法，可以确保某些指导始终符合上下文，而不必依赖于代理的技能负荷决策。
主要好处：
可预测性：无论代理正在执行什么任务，指令始终存在。无需匹配描述，代理也无法跳过内容。
有保障的覆盖范围：与代理根据任务相关性可能加载也可能不加载技能不同，代理指令总是在每个会话开始时注入。
常设政策：使用代理说明来制定常设运营政策、安全指南、编码标准或任何必须毫无例外地适用于每个会话的指南。
目标范围：您可以使用全局指令一次将指令应用于所有代理类型，或者当指导仅与该代理的工作相关时，将指令限制在特定的代理类型上。
代理指令的工作原理
会话启动时，代理服务会检索为代理空间配置的指令，并在会话开始之前将其内容注入代理系统提示符中。每次会话都会自动发生这种情况。代理不评估是否加载它们；它总是注入内容。
每个新会话都会在启动时重新加载指令。如果您更新了说明，则更改会立即对保存后开始的会话生效。已在进行的会话将继续使用启动时加载的内容。
范围界定决定会话接收哪些指令。全局指令适用于您的代理空间中的所有代理类型，因此每个会话都会收到这些指令。 Agent-specific 说明仅适用于该特定代理类型的会话。会话接收来自全局指令和相关代理特定指令的指令。
代理类型范围界定
作用域控制哪些代理会话会收到一组给定的指令。有两个范围界定选项：
全局指令：适用于您的代理空间中的所有代理类型。每个代理会话都会收到此内容。
Agent-specific：仅适用于所选代理类型的会话。
可用于代理特定指令的托管代理有：
聊天-聊天会话期间 Ad-hoc 的问题和请求。
事件分类-警报筛选、严重性分类和初始范围界定。
事件 RCA-通过证据收集和验证进行根本原因分析。
事故缓解- Short-term 补救措施和长期修复建议。
评估-代理绩效评分和策略合规性检查。
内容大小指南
每次你开始对话或调查时，代理都会先阅读你的全部说明，然后再做其他任何事情。代理在每个会话中都有固定数量的工作内存，您的指令会使用其中的一部分。文件越大，用于提问、调查、代理阅读的日志和自己的推理的空间就越小。更简短、更有针对性的说明使代理有更大的能力来解决您的问题。
硬限制：25 KB
推荐尺寸：120 行（建议用于大多数配置）
将指示重点放在每节课中都必须提供的指导上。对于仅适用于特定任务的专门调查程序，请考虑DevOps 特工技能改用。
示例
以下示例显示了格式良好的代理指令，其中包含适用于每个代理会话的调查指导、响应格式标准和安全要求。
# 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.
设置代理说明
在设置代理指令之前，必须有一个代理空间。有关更多信息，请参阅 创建代理空间。
每个代理只有一组指令。当您保存新内容时，它会覆盖该代理的现有内容。
要设置全局指令（适用于所有代理），请执行以下操作：
在 Agent Space Operator Web 应用程序中导航到代理页面。
选择 “全球指令” 旁边的 “查看”。
在编辑器中输入降价说明。
选择保存。
要为特定代理设置指令，请执行以下操作：
在 Agent Space Operator Web 应用程序中导航到代理页面。
在托管代理下，选择要配置的代理旁边的查看：聊天、事件分类、事件 RCA、事件缓解或评估。
在编辑器中输入降价说明。
选择保存。
管理代理指令
AWS DevOps 代理通过操作员 Web 应用程序为代理指令提供管理功能。
查看说明：导航到 “代理” 页面，然后选择 “全局指令” 或特定托管代理旁边的 “查看”。编辑器显示当前内容。使用 “预览” 选项卡查看渲染的降价，或者使用 “代码” 选项卡查看原始降价。
编辑说明：如上所述打开代理，在编辑器中修改内容，然后选择保存。
从文件上传说明：打开代理，然后在编辑器中选择上传按钮，从您的计算机上传 markdown 文件。
下载说明：打开代理，然后在编辑器中选择 “下载” 按钮，将当前内容下载为文件。
删除指令：打开代理，在编辑器中选择 “删除” 按钮，然后确认删除。并且无法撤消。如果您再次需要这些内容，可以考虑先下载内容。
