# 管理问题的依据、置信度和审批

为由 自动化 处理的问题设置和管理处理依据、置信度和批准。

理由和置信度不需要额外的配置。
自动化当代理更改受支持的问题属性时，它会自动附加理由和置信度。 该更改是直接应用还是等待审核，取决于存储库的自动化程度，或者是否有明确要求仅提出建议而不直接应用该更改。

## 设置存储库的自动化级别

> \[!NOTE]
> 自动化级别配置功能正在逐步推出，您的仓库可能尚未提供该功能。

存储库的自动化级别设置用于路由每个受支持的更改的置信度阈值。 低于阈值的更改将作为建议保留；达到或高于该阈值的更改将自动应用。 默认级别为 **“谨慎**”，因此只有高置信度更改才会自动应用，直到更改它。

1. 在 GitHub 上，导航到存储库的主页面。
2. 在仓库名称下，单击 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg>“Settings”\*\*\*\*。 如果看不到“设置”选项卡，请选择“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="kebab horizontal icon" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>”下拉菜单，然后单击“设置”。

   ![存储库标头的屏幕截图，其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。](/assets/images/help/repository/repo-actions-settings.png)
3. 在边栏的“规划”部分中，单击 **代理建议以解决问题**。
4. 在“自动化级别”下，选择适合存储库的级别：
   * **完全控制**：每次更改都会进行评审。 不会自动应用任何内容。
   * **谨慎**（默认）：仅自动应用置信度高的更改。 其他所有内容都是为了你的评论而保留的。
   * **平衡**：自动应用常规且明确的更改。 任何存在歧义的内容都会被保留待审核。
   * **完全自动化**：自动应用每个更改。 代理仅在某项更改被标记为不确定时，才会暂缓该更改。
5. 单击“ **保存**”。

## 使用 Copilot云代理

1. 创建一个用于分流问题的 自动化，并遵循 [使用 Copilot 云代理创建自动化](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations)。 使用**创建问题时**触发器，或按计划运行自动化。
2. 自动化为要更改的属性授予问题工具，例如更新标签、设置类型、编辑字段、分配用户或关闭问题。
3. 在提示符中，描述会审任务，例如： `Triage this issue by setting a type, labels, and priority, and explain your reasoning for each.` 无需明确提及理由、置信度或建议。 若要保留特定更改以供审阅，无论置信度如何，请让代理建议这些更改，而不是应用这些更改。
4. 保存自动化。 在运行时，它所做的更改会附带相应的依据和置信度。 低于你的仓库自动化级别的更改，以及你要求代理提出的任何更改建议，都会在该议题的审批面板中等待批准。

## 使用 GitHub代理工作流

问题意向、附加到工作流问题更改的理由和置信度元数据是可选的，默认情况下处于启用状态。 现有工作流在未更改的情况下保持工作。

1. 通过运行 `gh aw upgrade` 将 GitHub代理工作流 扩展更新到最新版本。
2. 添加一个工作流，将问题分类处理到你的仓库的 `.github/workflows` 目录中。 您可以从问题分流示例开始，也可以自行编写。
   [
   GitHub代理工作流
   ](https://gh.io/gh-aw)请参阅文档。
3. 通过在工作流的 frontmatter 中将这些输出列在 `safe-outputs` 下，为工作流提供你希望它更改的属性对应的输出。 例如， `add-labels` 若要应用标签、 `set-issue-type` 设置问题类型、 `set-issue-field` 编辑字段 `assign-to-user` 或 `assign-to-agent` 分配问题以及 `close-issue` 关闭它们。 添加这些输出就足以让工作流对相应问题做出更改，并附带相应的理由和置信度。
4. （可选）通过在其上设置 `issue-intent`，控制安全输出是否需要问题意图元数据：

   ```yaml
   safe-outputs:
     add-labels:
       issue-intent: true
   ```

   * 省略 `issue-intent`或将其保留为不设置，以使其保持可选：鼓励代理提供合理性和置信度，但输出仍可正常运行，而无需它们。
   * 将 `issue-intent: true` 设置为要求针对该输出提供理由说明和置信度。 如果代理省略这些内容，工作流就会失败。
   * 将 `issue-intent: false` 设为完全禁用：输出将始终不包含推理依据或置信度元数据。
5. 在工作流提示符中，描述会审任务。 若要保留特定更改以供审阅，无论置信度如何，请让代理建议这些更改，而不是应用这些更改。
6. 通过运行 `gh aw compile`编译工作流，然后提交工作流文件及其生成的锁定文件。
7. 工作流运行时，其更改具有理由和置信度（除非你选择退出）。 低于你的仓库自动化级别的更改，以及智能体建议的任何更改，都会在该议题的审批面板中等待批准。

## 使用 REST 或 GraphQL API

如果您构建的是自己的集成，而不是使用 自动化，则可以使用相同的用于写入 issue 的 REST 和 GraphQL API，在更改中加入理由和置信度级别，或者将更改标记为建议，以便保留供审核。 该更改会以与来自 自动化 或 GitHub代理工作流 工作流的更改相同的方式进行路由：具体取决于你的仓库的自动化级别；如果你将其标记为建议，则会保留供审核。

## 查找待处理建议中的问题

若要查找具有等待评审的建议的问题，请使用 `has:suggestions` 限定符进行搜索，例如 `is:issue is:open has:suggestions`。

## 在审批面板中审阅建议

当某项更改被搁置以供审核时，它不会立即生效，而是会在该议题的审批面板中等待。 使用面板检查每个建议并决定要应用的内容。

1. 打开问题。 建议的更改显示在审批面板中。
2. 检查每个建议。 它显示建议的更改，例如标签、类型、字段、被分配者或关闭，以及理由和置信度。
3. 根据建议进行操作：
   * 选择 **“接受** ”以应用建议，或 **拒绝** 将其消除。
   * 选择**全部接受**或**全部拒绝**，即可一次性处理所有待处理建议。

接受的更改会立即对问题生效。 拒绝的建议在未更改问题的情况下被驳回。

准备好实践这一点了吗？ 请参阅[使用 Copilot 云代理创建自动化](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations)，以创建一个可为你分类处理问题的自动化。