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