Forneça ao seu agente o contexto do projeto

A cada sessão, seu agente de codificação começa do zero. Sem uma origem permanente de convenções do projeto, as mesmas instruções são repetidas, e o agente muda quando uma é ignorada. Um arquivo de contexto resolve isso: um arquivo que o agente lê automaticamente no início de uma sessão, mantendo as regras e convenções que deve seguir todas as vezes.

Por que um arquivo de contexto

Digitar novamente suas convenções em cada solicitação é lento e fácil de cometer erros. Um arquivo de contexto torna essas instruções persistentes e consistentes, para que o agente siga seu estilo de automação por padrão em vez de adivinhar.

AgentS.md, a convenção comum

AGENTS.md uma convenção emergente entre ferramentas: um arquivo Markdown na raiz do seu projeto que os agentes de codificação leem para obter instruções do projeto. Alguns agentes procuram seu próprio nome de arquivo, mas a ideia é a mesma, independentemente do nome exato. A documentação do próprio agente lista o nome do arquivo e o local que ele espera.

Escopo global e do projeto

A maioria dos agentes é compatível com dois níveis de contexto:

• A global contém suas preferências pessoais, aplicadas em cada projeto, como sua organização e tenant padrão da UiPath ou seu estilo preferido.
• O projeto mantém convenções específicas de um projeto, mantidas no arquivo de contexto do projeto, para que elas acompanham o repositório e toda a equipe se beneficia.

As regras para toda a organização pertencem ao contexto global; as regras específicas do projeto pertencem ao arquivo do projeto.

O que colocar

Um arquivo de contexto útil é curto e objetivos. Para o trabalho da UiPath, os conteúdos úteis incluem:

• As habilidades uipath-maestro-flow UiPath para esse projeto, para que o agente alcança o certo (por uipath-rpa , para trabalho de Automação de Processos Robóticos (RPA) ou para orquestração de processos).
• Uma regra de qualidade permanente, como "Sempre execute o Analisador de Fluxo de Trabalho e resolva todos os problemas antes de declarar o trabalho concluído".
• Pacotes preferidos e fixados e as atividades a favorecer ou evitar (por exemplo, atividades nativas sobre Invoke Code).
• Convenções do projeto: nomenclatura, estrutura e os padrões que sua equipe segue.
• Restrições explícitas que o agente deve respeitar, como não substituir fluxos de trabalho de interface gráfica gravados ou arquivos de configuração existentes.

Um curto AGENTS.md para um projeto da UiPath pode ser parecido com isso:

# 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 convenções específicas de RPA que vale a pena capturar aqui, consulte Fluxos de trabalho de RPA.

Mantendo-o atualizado

Um arquivo de contexto é tão bom quanto seu conteúdo. Um arquivo que fica desatualizado enganoso silenciosamente o agente da mesma forma que um comentário errado enganou um desenvolvedor; portanto, vale a pena podar à medida que suas convenções mudam.