Busca na Base de Conhecimento
Desenvolvedor
O que é a Busca na Base de Conhecimento?
Seção intitulada “O que é a Busca na Base de Conhecimento?”A ferramenta search_knowledge realiza busca semântica (RAG) na base de conhecimento do seu produto. Diferente de busca por palavras-chave, ela entende o significado por trás da sua consulta e retorna os documentos mais relevantes, mesmo que as palavras exatas não coincidam.
Parâmetros
Seção intitulada “Parâmetros”| Parâmetro | Obrigatório | Descrição |
|---|---|---|
query | Sim | Descreva o que você está procurando — seja específico e descritivo |
top_k | Não | Número máximo de resultados a retornar (padrão: 5) |
Quando usar
Seção intitulada “Quando usar”- Antes de implementar uma feature — verifique se há documentação ou decisões existentes
- Ao investigar um bug — busque procedimentos relacionados ou problemas conhecidos
- Antes de tomar decisões arquiteturais — encontre discussões anteriores ou ADRs
- Ao escrever documentação — verifique o que já existe para evitar duplicação
Dicas para melhores resultados
Seção intitulada “Dicas para melhores resultados”Seja descritivo, não use palavras-chave
Seção intitulada “Seja descritivo, não use palavras-chave”Busca semântica funciona melhor com descrições em linguagem natural:
| Em vez de… | Tente… |
|---|---|
| “auth" | "Como funciona a autenticação de usuários neste workspace?" |
| "deploy" | "Qual é o processo de deploy para releases em produção?" |
| "API rate limit" | "Quais são as regras de rate limiting da REST API?” |
Ajuste o top_k para suas necessidades
Seção intitulada “Ajuste o top_k para suas necessidades”- Use
top_k: 3para resultados focados e de alta confiança - Use
top_k: 10quando explorar um tópico amplo ou reunir múltiplas perspectivas
Combine com o contexto do projeto
Seção intitulada “Combine com o contexto do projeto”Para melhores resultados, carregue o contexto do projeto primeiro (acontece automaticamente), depois busque na base de conhecimento. Isso dá ao seu assistente de IA tanto a visão geral do workspace quanto informações detalhadas específicas.
O que é indexado?
Seção intitulada “O que é indexado?”A base de conhecimento inclui todos os documentos importados no Prodgy:
- Especificações e requisitos de workspace
- Registros de decisão arquitetural (ADRs)
- Playbooks e runbooks
- Notas de reunião e decisões (capturadas pelo Prodgy Assistant)
- Documentação técnica
- Quaisquer outros documentos carregados na base de conhecimento