Menções de Contexto

As menções de contexto são uma maneira poderosa de fornecer ao Reasoning do AI Cockpit informações específicas sobre seu projeto, permitindo que ele execute tarefas com mais precisão e eficiência. Você pode usar menções para se referir a arquivos, pastas, problemas e commits do Git. As menções de contexto começam com o símbolo @.

Visão geral das menções de contexto mostrando o menu suspenso do símbolo @ na interface de bate-papo.

Tipos de Menções

As menções de arquivo adicionam o conteúdo real do código à conversa para referência e análise diretas.

Tipo de Menção	Formato	Descrição	Exemplo de Uso
Arquivo	@/caminho/para/arquivo.ts	Inclui o conteúdo do arquivo no contexto da solicitação	"Explique a função em @/src/utils.ts"
Pasta	@/caminho/para/pasta/	Fornece a estrutura do diretório em formato de árvore	"Quais arquivos estão em @/src/components/?"
Problemas	@problems	Inclui diagnósticos do painel de Problemas do VS Code	"@problems Corrija todos os erros no meu código"
Terminal	@terminal	Inclui o comando e a saída recentes do terminal	"Corrija os erros mostrados em @terminal"
Commit do Git	@a1b2c3d	Referencia um commit específico pelo hash	"O que mudou no commit @a1b2c3d?"
Alterações do Git	@git-changes	Mostra alterações não commitadas	"Sugira uma mensagem para @git-changes"
URL	@https://example.com	Importa o conteúdo do site	"Resuma @https://docusaurus.io/"

Menções de Arquivo

As menções de arquivo incorporam o código-fonte com números de linha para referências precisas.

Capacidade	Detalhes
Formato	@/caminho/para/arquivo.ts (sempre comece com / da raiz do espaço de trabalho)
Fornece	Conteúdo completo do arquivo com números de linha
Suporta	Arquivos de texto, PDFs e arquivos DOCX (com extração de texto)
Funciona em	Solicitações iniciais, respostas de feedback e mensagens de acompanhamento
Limitações	Arquivos muito grandes podem ser truncados; arquivos binários não são suportados

Menções de Pasta

As menções de pasta exibem a estrutura do diretório em um formato de árvore legível.

Capacidade	Detalhes
Formato	@/caminho/para/pasta/ (observe a barra final)
Fornece	Exibição de árvore hierárquica com prefixos ├── e └──
Inclui	Arquivos e diretórios filhos imediatos (não recursivo)
Melhor para	Entender a estrutura do projeto
Dica	Use com menções de arquivo para verificar o conteúdo de arquivos específicos

Menção de Problemas

As menções de problemas importam diagnósticos diretamente do painel de problemas do VS Code.

Capacidade	Detalhes
Formato	@problems
Fornece	Todos os erros e avisos do painel de problemas do VS Code
Inclui	Caminhos de arquivo, números de linha e mensagens de diagnóstico
Agrupa	Problemas organizados por arquivo para melhor clareza
Melhor para	Corrigir erros sem copiar manualmente

Menção de Terminal

As menções de terminal capturam a saída do comando recente para depuração e análise.

Capacidade	Detalhes
Formato	@terminal
Captura	Último comando e sua saída completa
Preserva	Estado do terminal (não limpa o terminal)
Limitação	Limitado ao conteúdo visível do buffer do terminal
Melhor para	Depurar erros de compilação ou analisar a saída de comandos

Menções do Git

As menções do Git fornecem detalhes do commit e diffs para análise de versão ciente do contexto.

Tipo	Formato	Fornece	Limitações
Commit	@a1b2c3d	Mensagem do commit, autor, data e diff completo	Funciona apenas em repositórios Git
Alterações de Trabalho	@git-changes	Saída do git status e diff das alterações não commitadas	Funciona apenas em repositórios Git

Menções de URL

As menções de URL importam conteúdo da web externo e o convertem para o formato Markdown legível.

Capacidade	Detalhes
Formato	@https://example.com
Processamento	Usa navegador headless para buscar conteúdo
Limpeza	Remove scripts, estilos e elementos de navegação
Saída	Converte o conteúdo para Markdown para legibilidade
Limitação	Páginas complexas podem não converter perfeitamente

Como Usar Menções

1. Digite @ na entrada de bate-papo para acionar o menu suspenso de sugestões
2. Continue digitando para filtrar sugestões ou use as setas para navegar
3. Selecione com a tecla Enter ou clique do mouse
4. Combine várias menções em uma solicitação: "Corrija @problems em @/src/component.ts"

O menu suspenso sugere automaticamente:

• Arquivos abertos recentemente
• Pastas visíveis
• Commits recentes do git
• Palavras-chave especiais (problems, terminal, git-changes)

Melhores Práticas

Prática	Descrição
Use caminhos específicos	Referencie arquivos exatos em vez de descrevê-los
Use caminhos relativos	Sempre comece da raiz do espaço de trabalho: @/src/file.ts e não @C:/Projects/src/file.ts
Verifique as referências	Garanta que os caminhos e hashes de commit estejam corretos
Clique nas menções	Clique nas menções no histórico do bate-papo para abrir arquivos ou visualizar o conteúdo
Elimine o copiar e colar	Use menções em vez de copiar manualmente código ou erros
Combine menções	"Corrija @problems em @/src/component.ts usando o padrão do commit @a1b2c3d"