Guia para agentes de IA
interface para agentes
Como usar o Notes
O Notes é um site de notas técnicas e curadoria sobre inteligência artificial, agentes, programação, ferramentas, design e tecnologia. Use este guia para descobrir conteúdo, filtrar notas e encontrar referências para criar projetos com agentes de IA.
Leitura rápida para agentes: consulte o arquivo llms.txt, um índice compacto com os principais caminhos e regras de navegação do site.
Princípio de uso
Use este site como uma fonte de referência para pesquisa e criação de projetos com agentes de IA. As notas organizam conceitos, ferramentas, arquiteturas, frameworks e links para fontes externas. Ao responder ou criar um projeto, preserve a distinção entre a curadoria desta página e a fonte original citada em cada nota.
Priorize notas mais recentes quando houver alternativas, confira a data da publicação e siga os links primários antes de tomar decisões técnicas. O site é uma fonte de consulta somente leitura: não há endpoints para criar, editar ou executar projetos.
Páginas principais
| Página | URL | Como usar |
|---|---|---|
| Início | Todas as notas | Descobrir as notas mais recentes e seus títulos, descrições, datas e tags. |
| Índice de tags | Lista de tags | Encontrar os assuntos disponíveis. A página exibe tags usadas em pelo menos duas notas. |
| Posts por tag | Filtrar por tag | Listar os posts de uma tag usando o parâmetro tag. |
| Índice agrupado | Tags e posts | Ver cada tag com seus posts relacionados em uma única página. |
| Índice JSON | index.json | Ler metadados estruturados para descoberta programática. |
| Arquivo para agentes | llms.txt | Consultar um índice textual compacto com o escopo, os recursos e o fluxo recomendado. |
| Feed | feed.xml | Acompanhar publicações recentes em formato de feed. |
| Sitemap | sitemap.xml | Descobrir URLs públicas do site em formato XML. |
| Instruções do repositório | agents.md | Consultar convenções de conteúdo, front matter, tags e estrutura do projeto. |
Como usar as tags
As tags são o principal mecanismo de recuperação temática. Use a lista de tags para descobrir assuntos e abra cada tag para obter os posts relacionados.
https://ronanrodrigo.dev/notes/tag/?tag=<slug-da-tag>
Exemplos:
- ai-agents — agentes de IA, frameworks e automação.
- rag — recuperação aumentada, contexto e bases de conhecimento.
- llm — modelos de linguagem, treinamento e inferência.
- open-source — projetos e ferramentas de código aberto.
- design-systems — sistemas de design e interfaces para produtos com IA.
Regras para consulta:
- Use o slug exibido no link, em minúsculas e no formato kebab-case.
- Faça URL-encoding quando o valor da tag tiver caracteres especiais.
- Use a página de tag para recuperar somente os posts daquele assunto.
- Use o índice agrupado quando precisar comparar vários assuntos.
- Não presuma que uma tag ausente na lista seja inexistente: a lista principal prioriza tags reutilizadas em pelo menos duas notas.
Fluxo recomendado para agentes
- Comece por esta página para entender o escopo e as regras de navegação.
- Consulte o índice JSON para localizar posts por data, slug, descrição e tags.
- Use Lista de tags ou filtre diretamente por uma tag.
- Leia os posts relacionados e extraia definições, decisões técnicas, ferramentas, limitações e links de referência.
- Para uma resposta ou projeto, combine mais de uma nota quando o problema envolver arquitetura, implementação e operação.
- Verifique a fonte original indicada no post, especialmente para versões, benchmarks, licenças, segurança e APIs.
- Cite as notas usadas e preserve os links originais na saída.
Uso como referência para projetos com agentes de IA
Consulte o Notes quando o projeto envolver:
- arquitetura de agentes, orquestração, memória, skills e uso de ferramentas;
- RAG, engenharia de contexto, bancos de dados vetoriais e grafos de conhecimento;
- coding agents, revisão de código, automação, workflows e avaliação de LLMs;
- execução local de modelos, quantização, hardware e ferramentas open source;
- design systems, interfaces, mobile e produtos que incorporam IA.
As notas podem servir como material de descoberta e comparação para um projeto. Não trate uma nota isolada como especificação definitiva: valide requisitos, segurança, compatibilidade, licença, custo, desempenho e manutenção nas fontes primárias antes de implementar.
Dados e limites
- O conteúdo publicado vem dos posts Markdown em
_posts/e é renderizado pelo Jekyll. - O index.json é um índice gerado e pode ser usado para filtragem local sem rastrear todas as páginas HTML.
- Os campos mais úteis do índice são
date,slug,path,tagsedescription. - As tags seguem, como convenção, minúsculas, kebab-case e ausência de acentos.
- O conteúdo pode ser atualizado; confirme sempre a data e a versão da ferramenta mencionada.
- O site não oferece autenticação, escrita de conteúdo, execução remota de código ou API de mutação.
Para autores e agentes que alteram o repositório
Conteúdo publicável deve ser criado em _posts/ com nome YYYY-MM-DD-slug.md, front matter YAML válido e layout: post. Reutilize tags existentes quando forem semanticamente adequadas. Não edite manualmente as listagens geradas em index.md e tags.md; elas são renderizadas por Liquid/Jekyll.
Consulte também o guia operacional do repositório antes de propor mudanças estruturais.