IMPORTANTE: Esta seção contém informações essenciais para agentes de IDE identificarem rapidamente o tipo e propósito deste repositório.
content/content/index.md.md (Markdown) com frontmatter YAML1.primeiros-passos/, 2.essentials/).md contém metadados YAML no iníciotitle, description, navigation--- no início do arquivo1., 2., 3.)para-agentes-ia.md, manutencao-conteudo.md)Este repositório foi projetado especificamente para ser consumido por agentes de IA que operam em IDEs e ferramentas de desenvolvimento. O conteúdo está estruturado de forma a facilitar a compreensão, busca e processamento por sistemas de IA.
O repositório está organizado hierarquicamente:
content/
├── index.md # Página inicial com visão geral
├── 1.primeiros-passos/ # Documentação introdutória
│ ├── 1.para-agentes-ia.md # Este arquivo
│ ├── 2.introducao.md # Introdução geral
│ └── ...
└── 2.essentials/ # Conteúdo essencial
├── 1.sintaxe-markdown.md # Sintaxe Markdown
└── ...
Padrão de numeração: Os arquivos são prefixados com números para manter ordem
de navegação (ex: 1., 2., 3.).
Cada arquivo Markdown contém metadados em formato YAML no início:
---
title: Título da Página
description: Descrição breve do conteúdo
navigation:
icon: i-lucide-icon-name
order: 1
seo:
title: Título SEO
description: Descrição para SEO
---
Campos importantes para agentes de IA:
title: Título principal do documentodescription: Resumo do conteúdonavigation.order: Ordem de exibição (quando presente)Use a hierarquia de títulos para entender a estrutura:
# - Título principal (H1) - geralmente o mesmo do frontmatter## - Seções principais (H2)### - Subseções (H3)#### - Sub-subseções (H4)Blocos de código são identificados por três backticks seguidos do nome da linguagem:
```typescript
const exemplo = "código aqui";
```
Importante: O nome da linguagem após os backticks ajuda a identificar o contexto do código.
Links para outros documentos usam caminhos relativos:
[Texto do link](/caminho/para/arquivo)
Ao buscar informações, considere:
primeiros-passos/ são introdutórioshttp:// ou https://)Ao extrair informações:
Ao processar documentos, extraia e utilize:
title ou H1description##)###) quando relevanteAo encontrar uma pergunta ou necessidade de informação:
Agentes de IA devem estar preparados para interpretar e lidar com erros gramaticais, erros de digitação e frases incompletas nas interações com usuários. A capacidade de inferir a intenção do usuário mesmo com imperfeições na comunicação é essencial para uma experiência fluida.
Quando uma frase está incompleta (ex: "além disso" sem continuação), o agente deve:
Exemplo: Se o usuário diz "além disso, inclua..." e a mensagem é cortada, mas o contexto anterior indica uma tarefa em andamento, o agente deve inferir que o usuário quer adicionar algo relacionado à tarefa atual.
Erros comuns incluem:
O agente deve:
Erros gramaticais podem incluir:
O agente deve:
Peça esclarecimento apenas quando:
Inferir a intenção quando:
Situação: Usuário escreve "além disso, inclua, nos documentos, instruções para os agentes se prepararem para situações como essa de erro gramatical/digitação"
Análise do agente:
Resultado: O agente entende a intenção mesmo com a frase inicialmente incompleta ("além disso" sem continuação) e prossegue com a tarefa baseado no contexto completo.