• PENDING
  • RUNNING
  • COMPLETED
  • FAILED

Como processar lotes de documentos com sua IA

Conecte o Voyage AI ao seu agente para lidar com tarefas massivas de vetorização em segundo plano. Você aciona o trabalho e deixa a API fazer o esforço pesado.

Pergunte à IA sobre esta página

Resposta rápida

Como vetorizar grandes conjuntos de dados sem atingir o limite de requisições?

Você usa tarefas em lote (batch jobs) em segundo plano para processar arquivos em massa. Sua IA inicia o trabalho, monitora o status e busca os resultados assim que a API termina o serviço.

Para onde os dados vão.

Os resultados do processamento em lote.

Assim que o trabalho termina, seus dados ficam em um destes estados.

PENDING

Tarefa na fila

A API aceitou seu pedido. Sua IA aguarda o lote sair da fila para o processamento ativo.

RUNNING

Processamento ativo

O lote está sendo vetorizado agora. Sua IA pode verificar o status periodicamente para ver o progresso.

COMPLETED

Vetores prontos

O trabalho foi concluído com sucesso. Sua IA já pode acessar os embeddings para suas próximas tarefas.

FAILED

Intervenção humana

Algo deu errado com o lote. Você precisará verificar os logs de erro e decidir como corrigir os arquivos de origem.

O fluxo

O que sua IA faz quando os dados chegam.

A IA gerencia o ciclo de vida da tarefa em lote para que você não precise monitorar a API manualmente.

  1. Preparar os dados

    A IA envia seus documentos brutos para o armazenamento do Voyage AI para prepará-los para a vetorização.

    upload_file

  2. Iniciar a tarefa

    A IA avisa a API para começar a processar os arquivos enviados como um único lote grande.

    create_batch

  3. Acompanhar o progresso

    A IA verifica o status da tarefa para saber se ainda está rodando ou se já terminou.

    get_batch

  4. Ver histórico

    A IA consulta tarefas anteriores para encontrar IDs de lotes específicos ou checar atividades recentes.

    list_batches

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar seu primeiro processamento em lote.

Pontos de partida

Substitua o texto entre colchetes pelos nomes reais dos seus arquivos ou IDs de lote.

Voyage AI Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_x7lwFbbAdz5StvxoOu2Tkh9eDMu9Uh5i3GKObLMP/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Voyage AI capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "voyage-ai-ai-embeddings-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_x7lwFbbAdz5StvxoOu2Tkh9eDMu9Uh5i3GKObLMP/mcp"
    }
  }
}
Copie no chat04

  • Faça o upload deste PDF e inicie um novo lote para ele.

  • Verifique o status do meu último lote de processamento.

  • Liste todos os lotes que eu executei recentemente.

  • Me avise se o lote [ID] já terminou.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Voyage AI uma vez e pronto.

Basta vincular sua conta uma única vez. Suas credenciais ficam criptografadas e você pode gerenciar lotes imediatamente pelo seu cliente de IA.

Conectar Voyage AI à sua IA

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode deletar meus arquivos enviados?

    Não. As ferramentas atuais permitem apenas o upload e o gerenciamento de tarefas em lote.

  • 02

    A IA espera o lote terminar antes de responder?

    Depende de como você pede. Você pode pedir para ela apenas checar o status ou pedir para monitorar o trabalho até que ele seja concluído.

  • 03

    Posso mudar o modelo de embedding no meio de um lote?

    Não. Uma vez que o lote é criado, os parâmetros ficam definidos para aquela tarefa específica.

  • 04

    A IA consegue ver minhas outras atividades na API?

    Não. A IA só tem acesso às ações específicas fornecidas pelas ferramentas do Voyage AI.

  • 05

    Como a IA sabe quando uma tarefa falha?

    A IA usa as ferramentas de status de lote para identificar estados de erro e informará você.

  • Mais dúvidas sobre o Voyage AI? A página do Connector responde. Veja tudo o que o Voyage AI Connector pode fazer

Conecte Voyage AI ao Claude, Cursor, ChatGPT e outros