Files é a peça mais simples quando o objetivo é colocar um documento dentro de uma interação específica. Pela documentação da xAI, quando um arquivo é anexado a uma mensagem de chat, a API adiciona nos bastidores a ferramenta attachment_search, transformando a solicitação em um fluxo mais agente, capaz de buscar no conteúdo do arquivo e raciocinar sobre ele.
O exemplo oficial de Chat with Files mostra duas formas comuns de uso: anexar um arquivo por URL pública ou usar o file_id de um arquivo já enviado. O exemplo usa a Responses API e traz grok-4.20-reasoning como modelo demonstrativo. A referência da Files API, por sua vez, diz que a API permite fazer upload, gerenciar e recuperar arquivos para uso com modelos Grok, além de anexá-los a mensagens de chat.
Em termos práticos, Files é o caminho mais bem documentado para tarefas como resumir um PDF, consultar um relatório, revisar um contrato ou fazer perguntas sobre um conjunto pequeno e temporário de documentos dentro de uma conversa.
Collections resolve um problema diferente. Em vez de anexar arquivos apenas a uma conversa, a proposta é manter uma coleção de documentos reutilizável, com armazenamento persistente e busca semântica sobre muitos documentos. A própria documentação da xAI cita o uso em aplicações RAG e em buscas sobre grandes conjuntos de documentos.
Para operar Collections via API, a documentação informa que é preciso criar uma Management API Key com a permissão AddFileToCollection. A referência REST também lista o endpoint para adicionar um documento existente a uma coleção: /v1/collections/{collection_id}/documents/{file_id}.
Essa distinção é importante para desenho de produto: Files serve para levar documentos a uma conversa; Collections serve para montar uma base de conhecimento persistente; Collections Search é a ferramenta de busca sobre o conteúdo dessa coleção.
A documentação da ferramenta Collections Search mostra chamadas para collections_search com argumentos como query e limit. Além disso, uma página relacionada ao Grok 4.20 exibe na navegação a seção “Collections Search (RAG)”, colocando esse recurso no contexto de ferramentas e recuperação para RAG.
Isso é suficiente para afirmar que a documentação da xAI descreve capacidades de Collections Search/RAG na plataforma. Mas não é suficiente para afirmar que o Grok 4.3, especificamente, já foi confirmado oficialmente como compatível com todo o fluxo Files + Collections Search.
| Necessidade | Peça mais indicada na xAI | Afirmação segura com base na documentação |
|---|---|---|
| Perguntar ou resumir documentos em uma conversa específica | Files / Chat with Files | O Grok pode pesquisar e raciocinar sobre documentos anexados a mensagens de chat; arquivos podem vir de URL pública ou de file_id, com ativação automática de attachment_search. |
| Testar rapidamente uma conversa com arquivo | Chat with Files | O exemplo oficial usa URL pública ou file_id e demonstra o fluxo com grok-4.20-reasoning. |
| Criar uma base de conhecimento reutilizável | Collections | Collections oferece armazenamento persistente e busca semântica em muitos documentos, e a documentação cita aplicações RAG e grandes conjuntos documentais. |
| Fazer busca semântica dentro de uma coleção | Collections Search | A documentação mostra chamadas collections_search com parâmetros como query e limit. |
| Automatizar ingestão e gestão de documentos | Collections API | O uso da API requer Management API Key com permissão AddFileToCollection, e a referência REST lista o endpoint para adicionar documento existente a uma coleção. |
Primeiro, nas fontes fornecidas não há uma página oficial de modelo ou matriz de suporte do Grok 4.3. O que aparece são materiais de Grok 4, Grok 4 0709, Grok 4 Fast e Grok 4.20. Esses documentos ajudam a entender a família e o ecossistema, mas não autorizam concluir que o identificador Grok 4.3 tem suporte oficial ao fluxo completo.
Segundo, a documentação do Google Cloud Vertex AI menciona Grok 4.1 Fast, com strong tool-calling capabilities e efficient knowledge base synthesis. Mas isso não é Grok 4.3 e está no contexto de um partner model no Vertex AI, não como uma declaração da API nativa da xAI para Grok 4.3.
Terceiro, uma página de comparação de terceiros menciona Grok 4.3, mas não é documentação oficial da API da xAI. Para compatibilidade de modelo, ferramentas e fluxos RAG, esse tipo de fonte não deve substituir uma matriz de suporte oficial.
Uma forma precisa de comunicar o estado atual seria:
A documentação oficial da xAI mostra que Grok pode usar Files para trabalhar com documentos anexados a mensagens de chat; Collections oferece armazenamento persistente e busca semântica para aplicações RAG; e há documentação para Collections Search. Porém, com as fontes disponíveis, não há confirmação oficial de que o Grok 4.3, especificamente, suporte o fluxo completo Files + Collections Search para perguntas e respostas sobre base de conhecimento.
O que não é recomendável é transformar isso em: Grok 4.3 já foi oficialmente confirmado para todo o fluxo RAG com Files e Collections Search. A conclusão mais rigorosa é que as peças de plataforma estão documentadas, mas a confirmação no nível da versão Grok 4.3 continua sem evidência suficiente.
Se a sua necessidade é fazer perguntas sobre documentos de forma pontual, comece por Files, Chat with Files e Files API. Esses documentos cobrem URL pública, file_id, anexos em mensagens de chat e a ferramenta attachment_search.
Se a meta é uma base de conhecimento reutilizável, o caminho documentado passa por Collections, Collections via API, a referência REST de gerenciamento de coleções e Collections Search Tool. Essas páginas sustentam armazenamento persistente, busca semântica, permissões de API e adição de documentos existentes a uma coleção.
Se a sua documentação interna, proposta comercial ou especificação técnica precisa citar Grok 4.3 nominalmente, o mais prudente é esperar uma página oficial da xAI, uma matriz de suporte ou uma referência de API que trate dessa versão. Não misture Grok 4, Grok 4.20, Grok 4 Fast, Grok 4.1 Fast no Vertex AI ou descrições de terceiros como se fossem a mesma confirmação oficial.
Dá para confirmar que a xAI documenta Files, Collections e Collections Search/RAG como capacidades da plataforma. O que não dá para confirmar, com as fontes fornecidas, é que o Grok 4.3 já esteja oficialmente coberto para o fluxo completo de ler arquivos e depois usar Collections Search como base de conhecimento. O rótulo correto, por enquanto, é evidência insuficiente — não suporte confirmado.