Ir para o conteúdo principal
Português— Escolher um idioma
Menu

O Padrão RAG Híbrido com o Grok

Aula 13 de 16 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. Combinar Todas as Fontes de Informação
  2. Arquitetura do Padrão
  3. O Contributo de Cada Fonte
  4. Como Decorre um Pedido Híbrido
  5. Três Situações Onde o Padrão Se Destaca
  6. Pontos-chave

Combinar Todas as Fontes de Informação

O RAG Híbrido (Retrieval-Augmented Generation) é o padrão mais avançado no ecossistema do Grok. O seu princípio: deixe de decidir antecipadamente onde reside a resposta. As suas coleções internas, a pesquisa na web, a pesquisa no X e a execução de código ficam todas disponíveis num único pedido, e o modelo decide quais solicitar com base na pergunta colocada. Deixa de criar ramificações condicionais; abre portas.

4
Fontes Combináveis
Automático
Seleção de Ferramentas
Duplo
Citações Internas + Web
Assíncrono
SDK Python Nativo

Arquitetura do Padrão

Tecnicamente, tudo se resume à lista tools: declara várias ferramentas sem especificar uma ordem ou condição.

response = await client.responses.create(
    model="grok-4.5",
    input="Compare a nossa documentação interna com as melhores práticas de mercado para autenticação de API.",
    tools=[
        {
            "type": "collections_search",
            "collection_ids": [collection_id]
        },
        {"type": "web_search"},
        {"type": "x_search"},
        {"type": "code_interpreter"}
    ]
)

Perante esta pergunta, o Grok irá provavelmente buscar a sua documentação na coleção, executar uma pesquisa na web sobre as melhores práticas de autenticação e, em seguida, sintetizar os dois elementos numa resposta comparativa. As outras duas ferramentas permanecem não utilizadas: nada na pergunta exige opiniões de utilizadores do X ou um cálculo em Python. Esta seleção é o cerne do padrão e explica por que razão declarar uma ferramenta extra não tem qualquer custo, desde que não seja relevante.

O Contributo de Cada Fonte

A collections_search abre o acesso às suas bases de conhecimento internas: documentação técnica privada, políticas e procedimentos, contratos e documentos legais, base de apoio ao cliente. Esta é a única fonte que contém aquilo que o modelo não poderia saber de outra forma: a realidade da sua empresa.

A web_search abrange o espaço público. Encontra aquilo que não controla e que muda: regulamentos e normas oficiais, documentação técnica de fornecedores, notícias, pontos de comparação de mercado. Este é o complemento natural das coleções, que apenas ficam desatualizadas quando as atualiza.

A x_search consulta o X e fornece acesso a um tipo diferente de material: opiniões e feedback em tempo real, tendências tecnológicas, reações a um anúncio recente, sentimento geral do mercado. Ativa-a quando a pergunta concerne o que as pessoas pensam, e não o que está escrito.

A code_interpreter, finalmente, executa Python num ambiente isolado (sandbox). Calcula sobre dados que as outras ferramentas acabaram de extrair, produz um gráfico, transforma um conjunto de dados ou verifica se um excerto de código funciona. Esta é a única ferramenta que produz nova informação em vez de a recuperar.

Como Decorre um Pedido Híbrido

Quando várias ferramentas estão disponíveis, a execução segue sempre o mesmo fluxo. O Grok começa por analisar a pergunta para determinar quais as fontes que a servem, consulta as coleções internas, pesquisa externamente na web ou no X quando necessário, sintetiza tudo numa resposta coerente e, finalmente, anexa as suas citações. Estas distinguem as referências internas, com o prefixo collections://, das referências externas em https:// — assim, sabe ao ler a resposta qual a alegação que provém dos seus documentos e qual provém de outro lugar.

Três Situações Onde o Padrão Se Destaca

Na inteligência competitiva, uma pergunta como «Como é que os nossos concorrentes gerem a integração de clientes?» mobiliza simultaneamente as três fontes documentais: a coleção descreve o seu próprio percurso de integração, a web fornece artigos e estudos sobre as práticas de mercado, e o X traz feedback bruto de utilizadores que acabaram de experienciar a integração com um concorrente.

Na conformidade, «A nossa política de dados está em conformidade com o mais recente regulamento da UE?» exige colocar dois textos lado a lado: a sua política atual, armazenada na coleção, e o texto regulamentar em vigor, recuperado da web. Nenhum dos dois é suficiente isoladamente, e este é exatamente o caso em que a abordagem manual se torna penosa.

Finalmente, no apoio técnico, «Como resolvo este erro de tempo limite na nossa API?» combina os seus guias internos de resolução de problemas com fóruns, o Stack Overflow e a documentação oficial da estrutura. O agente obtém numa única resposta aquilo que teria procurado em dois separadores e num wiki.

Pontos-chave

  • O padrão RAG híbrido combina coleções internas, web, X e código num único pedido
  • O Grok escolhe automaticamente as ferramentas relevantes com base na pergunta
  • As quatro ferramentas são: collections_search, web_search, x_search, code_interpreter
  • As citações distinguem as fontes internas (collections://) das fontes web (https://)
  • Este padrão é ideal para casos que exigem cruzar fontes internas e externas