
1 / 1
【Visão geral】 AGENTS.md é um formato aberto e simples em Markdown para dar contexto e instruções a agentes de IA que trabalham no seu código. Em vez de espalhar orientações por conversas ou arquivos proprietários, você mantém um local dedicado e previsível no repositório, funcionando como um README escrito para agentes em vez de pessoas. O formato é usado por mais de 60 mil projetos open-source e foi pensado para servir a qualquer pessoa, sem introduzir mais um arquivo proprietário. O problema que ele resolve é a falta de contexto: um agente precisa saber como compilar, quais testes rodar e quais convenções seguir. O AGENTS.md concentra essas informações, como etapas de build, testes e padrões de código, para que o agente consiga agir com segurança no seu projeto. Ele é voltado a desenvolvedores que criam ou usam agentes de código, mantenedores de projetos open-source e equipes que trabalham com monorepos grandes. 【Recursos principais】 • Formato de arquivo de instruções para agentes: um lugar previsível no repositório para dar contexto e instruções como etapas de build, testes e convenções. • Instruções aninhadas por pacote: em monorepos grandes, cada pacote pode ter seu próprio AGENTS.md, e o agente lê o arquivo mais próximo na árvore de diretórios. • Orientação para execução automatizada de testes: o agente tenta rodar as verificações programáticas listadas no AGENTS.md e corrigir falhas antes de concluir a tarefa. • Migração via symlink: permite renomear documentos existentes, como AGENT.md, para AGENTS.md usando links simbólicos para manter compatibilidade. 【Casos de uso】 1. Dar contexto e instruções de projeto a agentes de código de IA. 2. Documentar comandos de build e teste para que os agentes os executem. 3. Especificar diretrizes de estilo de código, mensagens de commit e pull requests para os agentes. 【Vantagens e desvantagens】 Vantagens: - Times que mantêm monorepos se beneficiam das instruções por pacote, pois cada subprojeto pode ter regras próprias sem poluir um único arquivo central. - Mantenedores de projetos open-source ganham um padrão aberto e reconhecido, já adotado por mais de 60 mil projetos, o que facilita a contribuição de agentes externos. Desvantagens: - Em instruções aninhadas, o AGENTS.md mais próximo do arquivo editado prevalece, e prompts explícitos do usuário no chat têm prioridade sobre tudo. - A orientação para execução automatizada de testes só funciona se você listar os comandos de teste no arquivo. 【Perguntas frequentes】 Q: O AGENTS.md substitui o README do projeto? A: Não. Ele funciona como um README para agentes: um local dedicado para o contexto e as instruções que ajudam agentes de IA a trabalhar no projeto. Q: Como funcionam as instruções em um monorepo com vários pacotes? A: Você pode colocar um AGENTS.md dentro de cada pacote, e o agente lê o arquivo mais próximo na árvore de diretórios; o mais próximo do arquivo editado prevalece. Q: Já tenho um arquivo AGENT.md. Preciso reescrever tudo? A: Não. É possível renomear o documento existente para AGENTS.md e usar links simbólicos para manter a compatibilidade.
free
Os preços mostrados são preços de referência dos EUA; os preços locais podem variar.
O WPS AI é um assistente de inteligência artificial integrado ao WPS Office, com capacidade de grandes modelos de…
O Baidu Comate é um assistente de programação com inteligência artificial desenvolvido pela Baidu com base no modelo…
UniConverter é uma ferramenta de conversão e aprimoramento de mídia com IA que trabalha com vídeo, áudio e imagens. Ela…
Adicionada
22/10/2026
Visualizações
657
Cliques
2
6 ferramentas semelhantes a considerar em vez de AGENTS.md