Registro de skills
Infraestrutura de agentesSkills públicas

Search Engine

Busca textual completa e semântica para agentes de IA — consulta, indexação, busca vetorial, autocompletar, depuração de ranqueamento, gerenciamento de sinônimos e análise de busca.

O que esta skill ensina

Um roteiro reutilizável para um tipo específico de trabalho.

Um servidor MCP informa a um agente quais ações estão disponíveis. Uma skill adiciona o julgamento em torno dessas ações: como reconhecer o trabalho, qual sequência seguir, o que evitar e como decidir que o resultado está completo.

Orquestre operações de busca — busca por texto completo, busca vetorial/semântica, autocompletar, gerenciamento de índice, configuração de sinônimos e análise de busca. Use ao pesquisar documentos, construir índices de busca, executar consultas semânticas, gerenciar sinônimos, analisar desempenho de busca ou depurar ranqueamento.

Arquitetura

Como Search Engine orienta um agente ADK-Rust.

A skill permanece legível e portátil porque contém instruções em vez de credenciais de serviço ou dados de negócio. O ADK-Rust a fornece ao agente, o agente escolhe dentro do limite de ferramentas revisado e o servidor MCP conectado executa a operação autenticada.

01

Solicitação do usuário

O agente recebe um objetivo expresso em linguagem comum.

02

Habilidade Search Engine

Corresponde à intenção, fornece o guia de decisão e restringe o limite da ferramenta.

03

Agente ADK-Rust

Planeja o fluxo de trabalho e transmite cada passo significativo pelo runtime.

04

mcp-search

Executa operações autenticadas contra o sistema que possui a capacidade.

05

Resultado verificado

As regras de conclusão da skill moldam as evidências retornadas ao usuário.

Instruções portáteis: SKILL.md · Limite de capacidade: mcp-search · Ferramentas permitidas: 20

Guia de decisão

Como o agente transforma uma solicitação na ação correta.

Essas rotas vêm diretamente das instruções da skill. Elas ajudam o modelo a reconhecer a intenção e selecionar uma ferramenta ou fluxo de trabalho focado em vez de improvisar por toda a superfície da capacidade.

01

"buscar", "encontrar", "consultar"?

search (texto completo) ou semantic_search (significado)

02

"similar", "como este", "relacionado"?

find_similar / query_vectors

03

"autocompletar", "sugerir"?

suggest

04

"indexar", "adicionar documento", "ingestão"?

index_document / upsert_vectors

05

"criar índice", "esquema"?

create_index

06

"por que ranqueado", "explicar", "depurar"?

explain_ranking / test_query

07

"análise", "desempenho", "zero resultados"?

get_search_analytics

08

"sinônimos"?

get_synonyms / update_synonyms

Fluxos de trabalho comprovados

Sequências repetíveis para resultados úteis.

Um fluxo de trabalho une várias chamadas de ferramentas em uma tarefa que o usuário realmente reconhece. A skill explica a sequência e o resultado pretendido enquanto o ADK-Rust transmite o progresso do agente pelo runtime compartilhado.

011 chamadas

Busca por Texto Completo

Busca por palavra-chave com filtros

021 chamadas

Busca Semântica

Baseada em significado (vetorial)

031 chamadas

Indexar Documento

Adicionar/atualizar no índice

042 chamadas

Depurar Ranqueamento

Explicar por que o documento foi ranqueado assim

052 chamadas

Melhorar Relevância

Encontrar zero resultados → adicionar sinônimos

06Best For chamadas

Modo

Ferramenta

Limite da ferramenta

A skill pode usar 20 ferramentas documentadas.

Esta lista de permissões é declarada pela skill. Ela mantém o agente focado nas ações necessárias para este trabalho enquanto mcp-search mantém a responsabilidade pela autenticação, validação e sistema conectado.

search
semantic_search
multi_search
suggest
find_similar
list_indexes
get_index
create_index
index_document
delete_document
upsert_vectors
query_vectors
list_namespaces
get_vector_stats
get_search_analytics
get_index_stats
explain_ranking
test_query
get_synonyms
update_synonyms

Regras de trabalho

O que o agente deve fazer.

  • Use semantic_search quando a intenção do usuário for mais importante que palavras-chave exatas
  • Verifique get_search_analytics regularmente para consultas sem resultados
  • Adicione sinônimos para termos comuns que não retornam resultados
  • Use explain_ranking para depurar ordenação inesperada

Limites operacionais

O que o agente deve evitar.

  • Não use busca por texto completo para consultas vagas/conceituais (use semântica)
  • Não indexe sem especificar campos pesquisáveis
  • Não ignore consultas sem resultados (indicam lacunas)

Instalar e conectar

Adicione a skill ao lado da capacidade que ela espera.

Instale o repositório onde seu carregador de skills ADK-Rust possa descobri-lo, conecte mcp-search e confirme que as ferramentas declaradas estão disponíveis antes de pedir ao agente para usar o fluxo de trabalho.

Instalar a skill
git clone https://github.com/zavora-ai/skill-search-engine.git \
  ~/.skills/skills/search-engine
Formato de carregamento ADK-Rust
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("search-engine").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

A declaração de compatibilidade do repositório: Requer servidor mcp-search conectado (Meilisearch, Typesense, Elasticsearch, Pinecone ou customizado).

Documentação oficial

Leia o pacote completo da skill.

O repositório permanece autoritativo para suas instruções exatas, exemplos, scripts auxiliares, recursos, requisitos MCP, licença e atualizações posteriores.

Registro da fonte

Metadados do repositório para esta entrada da skill.

Ver repositório público ↗
Licença
Apache-2.0
Ferramentas permitidas
20
Referências
3
Revisão
b72a8a4f88bd
Atualizado
31 de mai. de 2026