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

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

设置存储库的自动化级别

注意

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

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

在 GitHub 上，导航到存储库的主页面。
在仓库名称下，单击 “Settings”****。如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
在边栏的“规划”部分中，单击 代理建议以解决问题。
在“自动化级别”下，选择适合存储库的级别：
- 完全控制：每次更改都会进行评审。不会自动应用任何内容。
- 谨慎（默认）：仅自动应用置信度高的更改。其他所有内容都是为了你的评论而保留的。
- 平衡：自动应用常规且明确的更改。任何存在歧义的内容都会被保留待审核。
- 完全自动化：自动应用每个更改。代理仅在某项更改被标记为不确定时，才会暂缓该更改。
单击“ 保存”。

使用 Copilot云代理

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

使用 GitHub代理工作流

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

通过运行 gh aw upgrade 将 GitHub代理工作流扩展更新到最新版本。
添加一个工作流，将问题分类处理到你的仓库的 .github/workflows 目录中。您可以从问题分流示例开始，也可以自行编写。 GitHub代理工作流请参阅文档。
通过在工作流的 frontmatter 中将这些输出列在 safe-outputs 下，为工作流提供你希望它更改的属性对应的输出。例如， add-labels 若要应用标签、 set-issue-type 设置问题类型、 set-issue-field 编辑字段 assign-to-user 或 assign-to-agent 分配问题以及 close-issue 关闭它们。添加这些输出就足以让工作流对相应问题做出更改，并附带相应的理由和置信度。
（可选）通过在其上设置 issue-intent，控制安全输出是否需要问题意图元数据：
```
safe-outputs:
  add-labels:
    issue-intent: true
```
- 省略 issue-intent或将其保留为不设置，以使其保持可选：鼓励代理提供合理性和置信度，但输出仍可正常运行，而无需它们。
- 将 issue-intent: true 设置为要求针对该输出提供理由说明和置信度。如果代理省略这些内容，工作流就会失败。
- 将 issue-intent: false 设为完全禁用：输出将始终不包含推理依据或置信度元数据。
在工作流提示符中，描述会审任务。若要保留特定更改以供审阅，无论置信度如何，请让代理建议这些更改，而不是应用这些更改。
通过运行 gh aw compile编译工作流，然后提交工作流文件及其生成的锁定文件。
工作流运行时，其更改具有理由和置信度（除非你选择退出）。低于你的仓库自动化级别的更改，以及智能体建议的任何更改，都会在该议题的审批面板中等待批准。

使用 REST 或 GraphQL API

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

查找待处理建议中的问题

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

在审批面板中审阅建议

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

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

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

谁可以使用此功能？

在本文中