Operações de Banco de Dados Weaviate

Esta habilidade fornece acesso completo a bancos de dados vetoriais Weaviate, incluindo operações de busca, consultas em linguagem natural, inspeção de esquema, exploração de dados, busca filtrada, criação de coleções e importação de dados.

Quando Usar Esta Habilidade

• Use quando o usuário precisar inspecionar coleções, esquemas ou distribuição de dados do Weaviate.
• Use ao executar buscas semânticas, híbridas, por palavra-chave, filtradas ou do Query Agent contra o Weaviate.
• Use ao importar dados CSV, JSON, JSONL ou PDF para uma coleção Weaviate.
• Use ao criar dados de exemplo ou uma coleção para um fluxo de trabalho baseado em Weaviate.

Instância Weaviate Cloud

Se o usuário ainda não tiver uma instância, direcione-o para o console da nuvem para se registrar e criar um sandbox gratuito. Crie uma instância Weaviate através do Weaviate Cloud.

Variáveis de Ambiente

Obrigatório:

• WEAVIATE_URL - A URL do seu cluster Weaviate Cloud
• WEAVIATE_API_KEY - Sua chave de API Weaviate

Chaves de Provedor Externo (detectadas automaticamente): Defina apenas as chaves que suas coleções usam, consulte Requisitos de Ambiente para mais informações.

Índice de Scripts

Busca e Consulta

• Query Agent - Modo Perguntar: Use quando o usuário quiser uma resposta direta a uma pergunta com base nos dados da coleção. O Query Agent sintetiza informações de uma ou mais coleções e retorna uma resposta estruturada com citações de origem (nome da coleção e ID do objeto).
• Query Agent - Modo Buscar: Use quando o usuário quiser explorar ou navegar por objetos brutos em uma ou mais coleções. Ao contrário do modo perguntar, este retorna os objetos de dados reais em vez de uma resposta sintetizada.
• Busca Híbrida: Escolha padrão para a maioria das buscas. Oferece um bom equilíbrio entre compreensão semântica e correspondência exata de palavras-chave. Use esta opção quando não tiver certeza de qual tipo de busca escolher.
• Busca Semântica: Use para encontrar conteúdo conceitualmente semelhante, independentemente da formulação exata. Melhor quando a intenção importa mais do que palavras-chave específicas.
• Busca por Palavra-Chave: Use para encontrar termos exatos, IDs, SKUs ou padrões de texto específicos. Melhor quando a correspondência precisa de palavras-chave é necessária em vez de similaridade semântica.

Gerenciamento de Coleções

• Listar Coleções: Use para descobrir quais coleções existem na instância Weaviate. Este deve ser tipicamente o primeiro passo antes de realizar qualquer busca ou operação de dados.
• Obter Detalhes da Coleção: Use para entender o esquema de uma coleção — suas propriedades, tipos de dados, configuração do vetorizador, fator de replicação e status de multi-tenancy. Útil antes de executar buscas ou importações.
• Explorar Coleção: Use para analisar a distribuição de dados, valores principais e inspecionar o conteúdo real em uma coleção. Útil para entender como os dados se parecem antes de consultar.
• Criar Coleção: Use para criar novas coleções com esquemas personalizados antes de importar dados. Não especifique um vetorizador, a menos que o usuário solicite explicitamente (o padrão text2vec_weaviate é usado).

Operações de Dados

• Buscar e Filtrar: Use para recuperar objetos específicos por ID ou subconjuntos estritamente filtrados de dados. Melhor para recuperação precisa de dados em vez de busca.
• Importar Dados: Use esta opção quando o usuário pedir para importar, carregar ou ingerir um arquivo (CSV, JSON, JSONL, PDF) em uma coleção.
• Criar Dados de Exemplo: Use para criar dados de exemplo para uso imediato de outras habilidades, se não houver dados disponíveis ou se o usuário solicitar alguns dados de teste.

Recomendações

1. Comece listando as coleções se você não souber o que está disponível:

   uv run scripts/list_collections.py
   

2. Pergunte ao usuário se ele deseja criar dados de exemplo se nada estiver disponível e o usuário solicitar. Caso contrário, continue.

   uv run scripts/example_data.py
   

3. Obtenha os detalhes da coleção para entender o esquema:

   uv run scripts/get_collection.py --name "COLLECTION_NAME"
   

4. Explore os dados da coleção para ver valores e estatísticas:

   uv run scripts/explore_collection.py "COLLECTION_NAME"
   

…