Gestión de la justificación, el nivel de confianza y las aprobaciones de las incidencias

La lógica y la confianza no necesitan ninguna configuración adicional. Cuando el agente de un automatización cambia un atributo de incidencia compatible, adjunta automáticamente una justificación y un nivel de confianza. Tanto si ese cambio se aplica directamente como si espera la revisión depende del nivel de automatización del repositorio o de una solicitud explícita para sugerir en lugar de aplicar el cambio.

Establecimiento del nivel de automatización del repositorio

El nivel de automatización del repositorio establece el umbral de confianza usado para enrutar todos los cambios admitidos. Los cambios valorados por debajo del umbral se conservan como sugerencias; los cambios iguales o superiores al umbral se aplican automáticamente. El nivel predeterminado es Cauteloso, por lo que solo se aplican cambios de confianza alta automáticamente hasta que lo cambie.

1. En GitHub, navegue hasta la página principal del repositorio.

2. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la sección "Planeación" de la barra lateral, haga clic en Sugerencias del agente para detectar problemas.

4. En "Nivel de automatización", seleccione el nivel que se ajuste al repositorio:

   • Control total: cada cambio se mantiene para su revisión. No se aplica nada automáticamente.
   • Precaución (valor predeterminado): solo se aplican automáticamente los cambios de confianza alta. Todo lo demás se mantiene para su revisión.
   • Equilibrado: los cambios rutinarios y de corte claro se aplican automáticamente. Cualquier cosa con ambigüedad se mantiene para su revisión.
   • Automatización completa: cada cambio se aplica automáticamente. El agente solo retiene un cambio si está marcado como incierto.

5. Haz clic en Guardar.

Con agente en la nube de Copilot

1. Cree un automatización que clasifique las incidencias, siguiendo Creación de automatizaciones con Copilot agente en la nube. Utilice el desencadenante Cuando se crea una incidencia o ejecute el automatización según una programación.
2. Otorgue a automatización permisos sobre incidencias para cambiar los atributos que quiera, como actualizar etiquetas, establecer el tipo, editar campos, asignar usuarios o cerrar incidencias.
3. En el prompt, describa la tarea de triaje, por ejemplo: Triage this issue by setting a type, labels, and priority, and explain your reasoning for each. No es necesario mencionar explícitamente la justificación, la confianza ni las sugerencias. Si desea reservar ciertos cambios para su revisión, independientemente del nivel de confianza, pida al agente que sugiera dichos cambios en lugar de aplicarlos.
4. Guarde el automatización. Cuando se ejecuta, sus cambios incluyen una justificación y un nivel de confianza. Los cambios por debajo del nivel de automatización de tu repositorio y cualquier cambio que le hayas pedido al agente que proponga esperan en el panel de aprobaciones de la incidencia.

Con Flujos de trabajo basados en agentes de GitHub

Las intenciones de incidencia, así como los metadatos de justificación y de confianza adjuntos a los cambios de incidencia de un flujo de trabajo, son opcionales y están habilitados de forma predeterminada. Los flujos de trabajo existentes siguen funcionando sin cambios.

1. Actualice a la versión más reciente de la Flujos de trabajo basados en agentes de GitHub extensión ejecutando gh aw upgrade.

2. Agregue un flujo de trabajo que clasifique las incidencias en el directorio .github/workflows de su repositorio. Puede empezar desde un ejemplo de evaluación de prioridades de problemas o crear el suyo propio. Consulte la Flujos de trabajo basados en agentes de GitHub documentación.

3. Proporcione al flujo de trabajo los valores de salida de los atributos que quiere cambiar enumerándolos en safe-outputs en el frontmatter del flujo de trabajo. Por ejemplo, add-labels para aplicar etiquetas, set-issue-type establecer el tipo de problema, set-issue-field editar campos assign-to-user o assign-to-agent asignar problemas y close-issue cerrarlos. Agregar estas salidas es suficiente para que el flujo de trabajo realice los cambios de problema correspondientes con un nivel de justificación y confianza.

4. Opcionalmente, controle si una salida segura requiere metadatos de intención de problema estableciendo issue-intent en él:

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

   • Omita issue-intent o déjelo sin definir para que siga siendo opcional: se recomienda al agente proporcionar una justificación y un nivel de confianza, pero la salida sigue funcionando sin ellos.
   • Configure issue-intent: true para que requiera una justificación y un nivel de confianza para esa salida. Se produce un error en el flujo de trabajo si el agente los omite.
   • Configure issue-intent: false para excluirse por completo: la salida no incluye nunca metadatos de justificación ni de confianza.

5. En la instrucción del flujo de trabajo, describa la tarea de triaje. Para reservar cambios específicos para su revisión, independientemente del nivel de confianza, pida al agente que sugiera esos cambios en lugar de aplicarlos.

6. Compile el flujo de trabajo ejecutando gh aw compiley confirme el archivo de flujo de trabajo y su archivo de bloqueo generado.

7. Cuando se ejecuta el flujo de trabajo, sus cambios incluyen una justificación y un nivel de confianza, a menos que hayas optado por no incluirlos. Los cambios por debajo del nivel de automatización de tu repositorio, así como cualquier cambio que haya sugerido el agente, esperan en el panel de aprobaciones de la incidencia.

Con la API REST o GraphQL

Si crea su propia integración en lugar de usar un/a automatización, puede usar las mismas API REST y GraphQL de escritura de incidencias para incluir una justificación y un nivel de confianza con un cambio, o marcar un cambio como sugerencia para dejarlo pendiente de revisión. El cambio se tramita de la misma manera que un cambio procedente de un flujo de trabajo de automatización o de Flujos de trabajo basados en agentes de GitHub: según el nivel de automatización de tu repositorio, o queda pendiente de revisión si lo has marcado como sugerencia.

Búsqueda de problemas con sugerencias pendientes

Para encontrar problemas que tengan sugerencias esperando revisión, busque mediante el has:suggestions calificador, por ejemplo is:issue is:open has:suggestions.

Revisión de sugerencias en el panel de aprobaciones

Cuando se mantiene un cambio para su revisión, espera en un panel de aprobaciones sobre el problema en lugar de surtir efecto. Use el panel para inspeccionar cada sugerencia y decidir qué aplicar.

1. Abra el problema. Los cambios sugeridos aparecen en el panel de aprobaciones.
2. Inspeccione cada sugerencia. Muestra el cambio propuesto, como una etiqueta, un tipo, un campo, la persona asignada o el cierre, junto con la justificación y el nivel de confianza.
3. Actuar sobre las sugerencias:
   • Seleccione Aceptar para aplicar una sugerencia o Rechazar para descartarla.
   • Seleccione Aceptar todo o Rechazar todo para actuar en cada sugerencia pendiente a la vez.

Los cambios aceptados surten efecto en el problema inmediatamente. Las sugerencias rechazadas se descartan sin cambiar el problema.

¿Listo para poner esto en práctica? Consulte Creación de automatizaciones con Copilot agente en la nube para crear un automatización que clasifique y priorice las incidencias por usted.