O que Γ© o projeto
O Agents-Prompts Γ© um repositΓ³rio abrangente que documenta e disponibiliza os prompts, configuraΓ§Γ΅es e diretrizes dos principais agentes de IA do mercado. Com mais de 7000 linhas de cΓ³digo e instruΓ§Γ΅es, este projeto serve como uma referΓͺncia essencial para desenvolvedores que desejam entender como os agentes de IA sΓ£o construΓdos e como criar seus prΓ³prios agentes inteligentes.
Este repositΓ³rio tem como objetivo fornecer insights sobre a arquitetura interna dos principais agentes de IA, permitindo que desenvolvedores Γ©tudiem, compreendam e criem seus prΓ³prios agentes baseando-se em padrΓ΅es estabelecidos pelo mercado.
AlΓ©m dos prompts, o repositΓ³rio inclui ferramentas (tools.json), loops de agente (Agent loop.txt), mΓ³dulos especializados (Modules.txt), e documentaΓ§Γ£o detalhada sobre as capacidades de cada agente.
Lista de Todos os Agentes
O projeto documenta 15 agentes de IA distintos, abrangendo tanto soluΓ§Γ΅es proprietΓ‘rias quanto de cΓ³digo aberto. Cada agente possui sua prΓ³pria arquitetura, ferramentas e filosofias de design.
CategorizaΓ§Γ£o
Os agentes podem ser classificados de acordo com sua natureza de licenciamento, descriΓ§Γ£o foi baseado nos prompts e ferramentas disponΓveis na estrutura do projeto.
Por Licenciamento
Agentes com cΓ³digo-fonte disponΓvel publicamente: v0, Cursor, Manus, Windsurf, Replit, VSCode Agent (Cascade), Bolt, Roo Code, Cline, Codex CLI e outros.
Agentes distribuΓdos como serviΓ§os fechados com licenciamento restrito: Lovable, Same.dev, Devin AI, Trae AI, Dia Browser.
Por Ambiente de ExecuΓ§Γ£o
| Tipo | Agentes | CaracterΓsticas |
|---|---|---|
| IDE Integrado | Cursor, VSCode Agent, Roo Code, Cline | Executam diretamente no editor de cΓ³digo |
| Cloud IDE | Replit, Same.dev, Bolt (WebContainer) | Rodam em ambientes de navegador |
| CLI Terminal | Codex CLI, Manus | Interface de linha de comando |
| Assistente Web | v0 (Vercel), Lovable | Especializados em React/Next.js |
| AutΓ΄nomo Completo | Devin AI | Sistema operacional completo |
Por Capacidades Principais
| Categoria | Agentes | EspecializaΓ§Γ£o |
|---|---|---|
| Frontend | v0, Lovable, Bolt | React, Next.js, shadcn/ui |
| CΓ³digo Geral | Cursor, Cline, Codex CLI | Multi-linguagem |
| Full-Stack | Same.dev, Replit, Devin | Backend + Frontend |
| Deploy | v0, Bolt, Devin | Netlify, Fly.io, EasyPanel |
Mapa de RelaΓ§Γ΅es
Compreender como os diferentes agentes se relacionam ajuda a identificar padrΓ΅es arquiteturais e famΓlia de ferramentas compartilhadas.
FamΓlias de Agentes
Membros: Cascade (VSCode Agent), Roo Code, Windsurf
CaracterΓstica: Partilhamdas mesmas ferramentas e paradigmas de AI Flow
Membros: Cursor, Cline
CaracterΓstica: Clusterio de ferramentas Claude e interface em IDEs
Diagrama de DependΓͺncias e Tecnologias
Agrupamento por Empresa/Origem
| Empresa | Agentes | CΓ³digo Aberto |
|---|---|---|
| Vercel | v0 | Parcial (prompts disponΓveis) |
| Anthropic | Cursor (parceria) | Parcial |
| Codeium | Windsurf, Cascade, Roo | ConfiguraΓ§Γ΅es disponΓveis |
| Replit | Replit Agent | Prompt documentado |
| OpenAI | Codex CLI | Open Source (GitHub) |
| Lovable | Lovable AI | SoluΓ§Γ£o proprietΓ‘ria |
| Cognition Labs | Devin AI | SoluΓ§Γ£o proprietΓ‘ria |
| Same | Same.dev | SoluΓ§Γ£o proprietΓ‘ria |
Fluxo Geral de InformaΓ§Γ£o
A compreensΓ£o do fluxo de dados dentro dos agentes Γ© crucial para entender como as entradas do usuΓ‘rio sΓ£o transformadas em aΓ§Γ΅es e resultados.
Ciclo de Processamento do Agente
Fluxo de ComunicaΓ§Γ£o Agente-Herramientas
PadrΓ΅es Comuns
ApΓ³s anΓ‘lise dos 15 agentes, identificamos padrΓ΅es arquiteturais e de design que se repetem consistentemente.
PadrΓ΅es de Arquitetura
- Tool-First Design: Todos os agentes priorizam chamadas de ferramentas explΓcitas em vez de gerar cΓ³digo diretamente para o usuΓ‘rio.
- Read-Before-Edit: A maioria exigelitura do arquivo antes de modificΓ‘-lo para preservar o contexto e evitar conflitos.
- Atomic Tool Calls: Cada ferramenta Γ© chamada com parΓ’metros precisos e resultados esperados bem definidos.
- Iterative Refinement: Agentes completos continuam executando atΓ© que a tarefa esteja completamente resolvida.
- Context Awareness: Aproveitam o contexto de arquivos abertos e histΓ³rico para tomar decisΓ΅es informadas.
- Semantic Search: Preferem busca semΓ’ntica sobre busca literal para encontrar cΓ³digo relevante.
PadrΓ΅es de ComunicaΓ§Γ£o
- Progress Updates: Envio de mensagens intermediΓ‘rias durante operaΓ§Γ΅es longas via message_notify_user ou equivalente.
- Clarification Questions: Quando requisitos sΓ£o ambΓguos, o agente pergunta antes de agir.
- No Tool Names to User: NΓ£o mencionam nomes de ferramentas em respostas ao usuΓ‘rio final.
- Status Reporting: Indicam claramente quando completaram uma tarefa ou quando entraram em idle.
PadrΓ΅es de CΓ³digo Gerado
Os agentes mais avanΓ§ados seguem estas convenΓ§Γ΅es:
- TypeScript/Type Safety: Uso de tipos onde possΓvel
- Componentes Pequenos: Componentes com menos de 50 linhas
- Responsividade: Designs responsivos por padrΓ£o
- Error Handling: Tratamento adequado de erros
- Documentation: ComentΓ‘rios e READMEs atualizados
- Testing: AdiΓ§Γ£o de testes para componentes crΓticos
PadrΓ΅es de Ferramentas
| Categoria | Ferramentas Comuns | Consenso |
|---|---|---|
| File Operations | read_file, write_file, edit_file, delete_file | 100% dos agentes |
| Shell/Command | run_command, execute, shell_exec | 92% dos agentes |
| Search | grep_search, semantic_search, file_find | 100% dos agentes |
| Browser | navigate, click, input, scrape | 67% dos agentes |
| Deployment | deploy, expose_port | 42% dos agentes |
Riscos Identificados
Cada agente apresenta riscos especΓficos que devem ser considerados durante sua utilizaΓ§Γ£o ou ao criar novos agentes baseados nestes padrΓ΅es.
- ExecuΓ§Γ£o ArbitrΓ‘ria de CΓ³digo: Agentes com acesso a shell podem executar comandos prejudiciais se o prompt for manipulado.
- Vazamento de Credenciais: Ferramentas como deploy_expose_port podem expor dados sensΓveis.
- ModificaΓ§Γ£o Destrutiva: Sem verificaΓ§Γ£o, write_file pode sobrescrever dados importantes.
- Bypass de SeguranΓ§a: Agentes autΓ΄nomos podem ignorar prompts de seguranΓ§a se mal configurados.
- Custo de API: Agentes baseados em LLMs podem gerar custos significativos em uso intensivo.
- LatΓͺncia: MΓΊltiplas chamadas de ferramentas criam latΓͺncia acumulada.
- Estado Inconsistente: Sem controle de versΓ£o apropriado, alteraΓ§Γ΅es podem corromper o estado.
- DependΓͺncias Externas: Agentes que fazem web scraping dependem da disponibilidade de sites.
- Licenciamento: Prompts proprietΓ‘rios nΓ£o podem ser redistribuΓdos comercialmente.
- Privacidade de Dados: Agentes que enviam cΓ³digo para servidores externos podem violar polΓticas.
- Direitos Autorais: GeraΓ§Γ£o de cΓ³digo pode criar riscos de infraΓ§Γ£o se nΓ£o houver revisΓ£o humana.
AnΓ‘lise de ExposiΓ§Γ£o por Agente
| Agente | Risco Principal | NΓvel |
|---|---|---|
| v0 | Custo de deployment automΓ‘tico | MΓ©dio |
| Cursor | ModificaΓ§Γ£o de arquivos sem confirmaΓ§Γ£o | Alto |
| Manus | NΓΊmero elevado de ferramentas disponΓveis | Moderado |
| Windsurf | Complexidade da AI Flow paradigm | Moderado |
| Replit | Deploy automΓ‘tico implΓcito | Baixo |
| Devin | Autonomia total em sistema operacional | Alto |
| Bolt | LimitaΓ§Γ΅es do WebContainer | Baixo |
| Codex CLI | Sem isolamento de sandbox | Moderado |
IntegraΓ§Γ΅es
Os agentes documentados integram-se com uma variedade de ferramentas, serviΓ§os e plataformas externas para ampliar suas capacidades.
IntegraΓ§Γ΅es de Banco de Dados
IntegraΓ§Γ΅es de Deploy
IntegraΓ§Γ΅es de IA/Modelos
| Provedor | Modelos | Agentes que Usam |
|---|---|---|
| OpenAI | GPT-4o, o1, Codex | v0, Cursor, Codex CLI |
| Anthropic | Claude 3.5/3.7 Sonnet | Cascade, Cline, Roo |
| Groq | Llama 3.3 70B | v0 (suporte) |
| XAI (Grok) | Grok-2, Grok-3 | v0 (suporte via MCP) |
| DeepInfra | MΓΊltiplos modelos | v0 (suporte via MCP) |
IntegraΓ§Γ΅es de UI/Componentes
A maioria dos agentes frontend-first suportam especificamente:
- shadcn/ui: Componentes Radix + Tailwind (v0, Lovable, Bolt)
- Tailwind CSS: Framework CSS utilitΓ‘rio
- Lucide Icons: Γcones SVG consistentes
- Framer Motion: AnimaΓ§Γ΅es React
DependΓͺncias
AnΓ‘lise das dependΓͺncias tΓ©cnicas compartilhadas entre os agentes.
DependΓͺncias de Linguagem
| Linguagem | Uso Principal | Agentes |
|---|---|---|
| Python | Backend, Data Processing | Devin, Replit, Cline |
| JavaScript/TypeScript | Frontend, Full-Stack | Todos (100%) |
| Shell (Bash/Zsh) | AutomaΓ§Γ£o, Deploy | 85% dos agentes |
| Node.js | Runtime JavaScript | Todos os web agents |
DependΓͺncias de Framework
DependΓͺncias Externas CrΓticas
DependΓͺncias cuja indisponibilidade afeta mΓΊltiplos agentes:
- Modelos de LLM APIs: DependΓͺncia de uptime e custos de OpenAI, Anthropic, etc.
- Registros NPM: Todos os agentes dependem da disponibilidade do npm registry.
- Git: Controle de versΓ£o essencial exceto para exemplos isolados.
- Rede Internet: Wake-requerimentos de claude-sonnet
RecomendaΓ§Γ΅es
Com base na anΓ‘lise dos agentes existentes, aqui estΓ£o as recomendaΓ§Γ΅es para construir novos agentes ou melhorar os existentes.
RecomendaΓ§Γ΅es Arquiteturais
- Tool Abstraction Layer: Implementar uma camada de abstraΓ§Γ£o para ferramentas ofimensionando dependΓͺncia de fornecedor especΓfico.
- Sandbox Environment: Executar agentes em ambientes isolados para evitar danos acidentais ao sistema.
- Tool Registry Pattern: Registrar ferramentas dinamicamente com descriΓ§Γ΅es claras para DubLLM descoberta.
- Input Validation: Validar todos os parΓ’metros de ferramenta antes da execuΓ§Γ£o (path traversal, command injection).
- Checkpoint System: Implementar pontos de verificaΓ§Γ£o para rollback automΓ‘tico em caso de falha.
- Audit Logging: Registrar todas as aΓ§Γ΅es para auditoria e depuraΓ§Γ£o.
RecomendaΓ§Γ΅es de Prompt Engineering
Para agente consistente e seguro, inclua sempre:
- Identity Block: DefiniΓ§Γ£o clara do papel e capacidades
- Tool Descriptions: DescriΓ§Γ΅es detalhadas quando usar cada ferramenta
- Format Rules: Formato exato para tool calls (XML/JSON)
- Safety Guidelines: LimitaΓ§Γ΅es explΓcitas e como reportar problemas
- Error Handling: InstruΓ§Γ΅es para recover de failures
- Communication Policy: Quando falar vs quando agir
RecomendaΓ§Γ΅es de SeguranΓ§a
| PrΓ‘tica | ImplementaΓ§Γ£o | Prioridade |
|---|---|---|
| Least Privilege | Executar agentes com permissΓ΅es mΓnimas necessΓ‘rias | CrΓtica |
| Path Validation | Validar todos os paths (caminhos absolutos, symlinks) | CrΓtica |
| Command Allowlist | Permitir apenas comandos shell prΓ©-aprovados | CrΓtica |
| Network Isolation | Limitar trΓ‘fego de rede para APIs necessΓ‘rias apenas | Alta |
| Secrets Management | Nunca armazenar credenciais em cΓ³digo gerado | CrΓtica |
| User Confirmation | Exigir confirmaΓ§Γ£o para operaΓ§Γ΅es destrutivas | Alta |
| Size Limits | Limitar tamanho de arquivos lidos/escritos | Alta |
| Rate Limiting | Limitar taxa de LLM API calls para controle de custo | Alta |
RecomendaΓ§Γ΅es de Observabilidade
- Structured Logging: Logs estruturados (JSON) para anΓ‘lise automatizada.
- Metrics Collection: Coletar mΓ©tricas de latΓͺncia, custo, sucesso/falha.
- Tracing: Rastreamento distribuΓdo para debugging de fluxos complexos.
- Alerting: Alertas para anomalias (spikes de custo, falhas repetidas).
Antes de lanΓ§ar um agente em produΓ§Γ£o, verifique:
- Todos os prompts foram revisados contra jailbreaks
- Sandbox de testes configurado e testado
- Sistema de rollback implementado
- Logs de auditoria instrumentados
- DocumentaΓ§Γ£o do usuΓ‘rio final completa
- Limites de custo configurados no provedor LLM
- Testes de penetraΓ§Γ£o realizados
- Plano de resposta a incidentes documentado
prΓ³ximos Passos
Esta visΓ£o geral forneceu um panorama completo do ecossistema de agentes documentados no Agents-Prompts. Para aprofundar-se:
- Explore cada agente individualmente: Cada pasta contΓ©m prompts especΓficos e ferramentas detalhadas.
- Compare implementaΓ§Γ΅es: Veja como diferentes agentes abordam o mesmo problema.
- Estude os patterns: Identifique padrΓ΅es reutilizΓ‘veis para seus prΓ³prios agentes.
- Contribua: Adicione documentaΓ§Γ£o de novos agentes ao projeto.
Links importantes para documentaΓ§Γ£o das plataformas: AI SDK (Vercel) β’ Anthropic Claude β’ Codeium β’ Replit API