Proporcione el contexto del proyecto de su agente

En cada sesión, tu agente de codificación se inicia de nuevo. Sin una fuente permanente de convenciones del proyecto, las mismas instrucciones se repiten y el agente se desvía cuando se olvida una. Un archivo de contexto resuelve esto: un archivo que el agente lee automáticamente al inicio de una sesión, manteniendo las reglas y convenciones que debe seguir en todo momento.

Por qué un archivo de contexto

Volver a escribir tus convenciones en cada solicitud es lento y es fácil equivocarse. Un archivo de contexto hace que esas instrucciones sean persistentes y coherentes, por lo que el agente sigue tu estilo de forma predeterminada en lugar de adivinar.

AGENTS.md, la convención común

AGENTS.md una convención emergente entre herramientas: un archivo Markdown en la raíz de tu proyecto que los agentes de codificación leen para obtener instrucciones del proyecto. Algunos agentes buscan su propio nombre de archivo, pero la idea es la misma independientemente del nombre exacto. La propia documentación del agente enumera el nombre de archivo y la ubicación que espera.

Ámbito global y del proyecto

La mayoría de los agentes admiten dos niveles de contexto:

• Global mantiene tus preferencias personales, aplicadas en todos los proyectos, como tu organización y tenant predeterminados de UiPath, o tu estilo preferido.
• El proyecto mantiene las convenciones específicas de un proyecto, guardadas en el archivo de contexto del proyecto para que viajen con el repositorio y todo el equipo se beneficie.

Las reglas para toda la organización pertenecen al contexto global; las reglas específicas del proyecto pertenecen al archivo del proyecto.

Qué poner en él

Un archivo de contexto útil es corto y concreto. Para el trabajo de UiPath, los contenidos útiles incluyen:

• Las habilidades de UiPath para este proyecto, para que el agente busque la correcta (por ejemplo, uipath-rpa para el trabajo de automatización de procesos robóticos (RPA), o uipath-maestro-flow para la orquestación de procesos).
• Una regla de calidad permanente, como "ejecutar siempre el Analizador de flujo de trabajo y resolver todos los problemas antes de declarar el trabajo realizado".
• Paquetes preferidos y anclados, y las actividades a favorecer o evitar (por ejemplo, actividades nativas sobre Invocar código).
• Convenciones del proyecto: nombres, estructura y los patrones que sigue tu equipo.
• Restricciones explícitas que el agente debe respetar, como no sobrescribir los flujos de trabajo de IU grabados o los archivos de configuración existentes.

Un AGENTS.md corto para un proyecto de UiPath podría tener este aspecto:

# Project conventions

- Use the `uipath-rpa` skill for automation work in this project.
- Always run the Workflow Analyzer (Analyze Project) and resolve every problem before calling work done.
- Prefer native activities over Invoke Code; keep UI activities inside a Use Application/Browser scope.
- Pin package versions in project.json; do not upgrade packages without asking.

Para las convenciones específicas de RPA que vale la pena capturar aquí, consulta Flujos de trabajo de RPA.

Mantenerlo actualizado

Un archivo de contexto es tan bueno como su contenido. Un archivo que se vuelve obsoleto engaña silenciosamente al agente de la misma manera que un comentario incorrecto engaña a un desarrollador, por lo que vale la pena podarlo a medida que cambian las convenciones.