Visão Geral
A ferramenta Qdrant Vector Search permite adicionar capacidades de busca semântica aos seus agentes CrewAI utilizando o Qdrant, um mecanismo de busca por similaridade vetorial. Com essa ferramenta, seus agentes podem pesquisar em documentos armazenados em uma coleção Qdrant usando similaridade semântica.Instalação
Instale os pacotes necessários:Uso Básico
Veja um exemplo mínimo de como utilizar a ferramenta:Exemplo Completo e Funcional
Veja um exemplo completo mostrando como:- Extrair texto de um PDF
- Gerar embeddings usando OpenAI
- Armazenar no Qdrant
- Criar um fluxo de trabalho RAG agente CrewAI para busca semântica
Parâmetros da Ferramenta
Parâmetros Obrigatórios
qdrant_url
(str): URL do seu servidor Qdrantqdrant_api_key
(str): Chave de API para autenticação com o Qdrantcollection_name
(str): Nome da coleção Qdrant a ser pesquisada
Parâmetros Opcionais
limit
(int): Número máximo de resultados a serem retornados (padrão: 3)score_threshold
(float): Limite mínimo de similaridade (padrão: 0.35)custom_embedding_fn
(Callable[[str], list[float]]): Função personalizada para vetorização de textos
Parâmetros de Busca
A ferramenta aceita estes parâmetros em seu schema:query
(str): Consulta de busca para encontrar documentos similaresfilter_by
(str, opcional): Campo de metadado para filtrarfilter_value
(str, opcional): Valor para filtrar
Formato de Retorno
A ferramenta retorna resultados no formato JSON:Embedding Padrão
Por padrão, a ferramenta utiliza o modelotext-embedding-3-small
da OpenAI para vetorização. Isso requer:
- Chave de API da OpenAI definida na variável de ambiente:
OPENAI_API_KEY
Embeddings Personalizados
Em vez de utilizar o modelo padrão de embeddings, você pode utilizar sua própria função de embeddings nos casos em que:- Deseja usar um modelo de embeddings diferente (ex: Cohere, HuggingFace, modelos Ollama)
- Precisa reduzir custos utilizando modelos de código aberto
- Tem requisitos específicos quanto à dimensão dos vetores ou à qualidade dos embeddings
- Deseja utilizar embeddings específicos para determinado domínio (ex: textos médicos ou jurídicos)
Tratamento de Erros
A ferramenta trata os seguintes erros específicos:- Lança ImportError se
qdrant-client
não estiver instalado (com opção de instalar automaticamente) - Lança ValueError se
QDRANT_URL
não estiver definido - Solicita instalação de
qdrant-client
se estiver ausente utilizandouv add qdrant-client