Donnez à votre agent un contexte de projet

Chaque session de votre agent de codage démarre à zéro. En l’absence de sources permanentes de conventions de projet, les mêmes instructions sont répétées et l’agent dérive lorsque l’une d’entre elles est oubliée. Un fichier de contexte résout ce problème: un fichier que l'agent lit automatiquement au début d'une session, qui contient les règles et les conventions qu'il doit suivre à chaque fois.

Pourquoi un fichier de contexte

Il est lent et facile de se tromper sur le fait de saisir à nouveau vos conventions à chaque invite. Un fichier de contexte rend ces instructions persistantes et cohérentes, de sorte que l'agent suit votre style personnel par défaut au lieu de deviner.

Agents.md, la convention commune

AGENTS.md est une convention inter-outils émergente: un fichier Markdown à la racine de votre projet que les agents de codage lisent pour obtenir des instructions de projet. Certains agents recherchent leur propre nom de fichier à la place, mais l’idée est la même quel que soit le nom exact. La documentation de l'agent répertorie le nom de fichier et l'emplacement attendus.

Étendue globale et du projet

La plupart des agents prennent en charge deux niveaux de contexte:

• Global contient vos préférences personnelles, appliquées à chaque projet, telles que votre organisation et votre locataire UiPath par défaut, ou votre style préféré.
• Le projet détient des conventions spécifiques à un projet, conservées dans le fichier de contexte du projet afin qu'elles se déplacent avec le référentiel et les avantages de l'ensemble de l'équipe.

Les règles à l’échelle de l’organisation appartiennent au contexte global; les règles spécifiques au projet appartiennent au fichier de projet.

Que faut-il y mettre

Un fichier de contexte utile est court et concret. Pour le travail UiPath, les contenus utiles incluent:

• Les compétences UiPath pour ce projet, afin que l’agent choisisse la bonne (par exemple, uipath-rpa pour le travail d’automatisation des processus robotisés ou uipath-maestro-flow pour l’orchestration de processus).
• Une règle de qualité permanente, telle que « Exécutez toujours l’analyseur de workflow et résolvez tous les problèmes avant de déclarer le travail terminé.»
• Les packages préférés et épinglés, et les activités à privilégier ou à éviter (par exemple, les activités natives via Appeler le code).
• Conventions du projet: nommage, structure et modèles suivis par votre équipe.
• Contraintes explicites que l’agent doit respecter, telles que le fait de ne pas écraser les workflows d’interface utilisateur enregistrés ou les fichiers de configuration existants.

Le court AGENTS.md d'un projet UiPath peut ressembler à ceci:

# 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.

Pour connaître les conventions spécifiques à la RPA qui méritent d’être capturées ici, consultez la section Workflows RPA.

Le maintenir à jour

Un fichier de contexte n'est aussi bon que son contenu. Un fichier qui devient obsolète induise silencieusement l’agent de la même manière qu’un commentaire erroné trompe un développeur, il convient donc de le supprimer à mesure que vos conventions changent.