- Claude Opus 4.1 (
claude-opus-4-1-20250805) - Claude Opus 4 (
claude-opus-4-20250514) - Claude Sonnet 4.5 (
claude-sonnet-4-5-20250929) - Claude Sonnet 4 (
claude-sonnet-4-20250514) - Claude Sonnet 3.7 (descontinuado) (
claude-3-7-sonnet-20250219) - Claude 3.5 Haiku (
claude-3-5-haiku-20241022)
Principais benefícios
- Citações naturais - Alcance a mesma qualidade de citação que a pesquisa na web para qualquer conteúdo
- Integração flexível - Use em retornos de ferramentas para RAG dinâmico ou como conteúdo de nível superior para dados pré-buscados
- Atribuição adequada de fonte - Cada resultado inclui informações de fonte e título para atribuição clara
- Sem necessidade de soluções alternativas de documentos - Elimina a necessidade de soluções alternativas baseadas em documentos
- Formato de citação consistente - Corresponde à qualidade e formato de citação da funcionalidade de pesquisa na web do Claude
Como funciona
Os resultados de pesquisa podem ser fornecidos de duas maneiras:- De chamadas de ferramentas - Suas ferramentas personalizadas retornam resultados de pesquisa, permitindo aplicações RAG dinâmicas
- Como conteúdo de nível superior - Você fornece resultados de pesquisa diretamente em mensagens de usuário para conteúdo pré-buscado ou em cache
Esquema de resultado de pesquisa
Os resultados de pesquisa usam a seguinte estrutura:Campos obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
type | string | Deve ser "search_result" |
source | string | A URL de fonte ou identificador do conteúdo |
title | string | Um título descritivo para o resultado de pesquisa |
content | array | Um array de blocos de texto contendo o conteúdo real |
Campos opcionais
| Campo | Tipo | Descrição |
|---|---|---|
citations | object | Configuração de citação com campo booleano enabled |
cache_control | object | Configurações de controle de cache (por exemplo, {"type": "ephemeral"}) |
content deve ser um bloco de texto com:
type: Deve ser"text"text: O conteúdo de texto real (string não vazia)
Método 1: Resultados de pesquisa de chamadas de ferramentas
O caso de uso mais poderoso é retornar resultados de pesquisa de suas ferramentas personalizadas. Isso permite aplicações RAG dinâmicas onde ferramentas buscam e retornam conteúdo relevante com citações automáticas.Exemplo: Ferramenta de base de conhecimento
Método 2: Resultados de pesquisa como conteúdo de nível superior
Você também pode fornecer resultados de pesquisa diretamente em mensagens de usuário. Isso é útil para:- Conteúdo pré-buscado de sua infraestrutura de pesquisa
- Resultados de pesquisa em cache de consultas anteriores
- Conteúdo de serviços de pesquisa externos
- Testes e desenvolvimento
Exemplo: Resultados de pesquisa diretos
Resposta do Claude com citações
Independentemente de como os resultados de pesquisa são fornecidos, Claude inclui automaticamente citações ao usar informações deles:Campos de citação
Cada citação inclui:| Campo | Tipo | Descrição |
|---|---|---|
type | string | Sempre "search_result_location" para citações de resultado de pesquisa |
source | string | A fonte do resultado de pesquisa original |
title | string ou null | O título do resultado de pesquisa original |
cited_text | string | O texto exato sendo citado |
search_result_index | integer | Índice do resultado de pesquisa (baseado em 0) |
start_block_index | integer | Posição inicial no array de conteúdo |
end_block_index | integer | Posição final no array de conteúdo |
search_result_index refere-se ao índice do bloco de conteúdo do resultado de pesquisa (baseado em 0), independentemente de como os resultados de pesquisa foram fornecidos (chamada de ferramenta ou conteúdo de nível superior).
Múltiplos blocos de conteúdo
Os resultados de pesquisa podem conter múltiplos blocos de texto no arraycontent:
start_block_index e end_block_index.
Uso avançado
Combinando ambos os métodos
Você pode usar resultados de pesquisa baseados em ferramentas e de nível superior na mesma conversa:Combinando com outros tipos de conteúdo
Ambos os métodos suportam misturar resultados de pesquisa com outro conteúdo:Controle de cache
Adicione controle de cache para melhor desempenho:Controle de citação
Por padrão, as citações são desativadas para resultados de pesquisa. Você pode ativar citações definindo explicitamente a configuraçãocitations:
citations.enabled é definido como true, Claude incluirá referências de citação ao usar informações do resultado de pesquisa. Isso permite:
- Citações naturais para suas aplicações RAG personalizadas
- Atribuição de fonte ao fazer interface com bases de conhecimento proprietárias
- Citações de qualidade de pesquisa na web para qualquer ferramenta personalizada que retorne resultados de pesquisa
citations for omitido, as citações serão desativadas por padrão.
As citações são tudo ou nada: ou todos os resultados de pesquisa em uma solicitação devem ter citações ativadas, ou todos devem tê-las desativadas. Misturar resultados de pesquisa com diferentes configurações de citação resultará em um erro. Se você precisar desativar citações para algumas fontes, você deve desativá-las para todos os resultados de pesquisa nessa solicitação.
Melhores práticas
Para pesquisa baseada em ferramentas (Método 1)
- Conteúdo dinâmico: Use para pesquisas em tempo real e aplicações RAG dinâmicas
- Tratamento de erros: Retorne mensagens apropriadas quando as pesquisas falharem
- Limites de resultado: Retorne apenas os resultados mais relevantes para evitar estouro de contexto
Para pesquisa de nível superior (Método 2)
- Conteúdo pré-buscado: Use quando você já tiver resultados de pesquisa
- Processamento em lote: Ideal para processar múltiplos resultados de pesquisa de uma vez
- Testes: Ótimo para testar o comportamento de citação com conteúdo conhecido
Melhores práticas gerais
-
Estruture resultados efetivamente
- Use URLs de fonte claras e permanentes
- Forneça títulos descritivos
- Divida conteúdo longo em blocos de texto lógicos
-
Mantenha consistência
- Use formatos de fonte consistentes em sua aplicação
- Garanta que os títulos reflitam com precisão o conteúdo
- Mantenha a formatação consistente
-
Trate erros com elegância
Limitações
- Os blocos de conteúdo de resultado de pesquisa estão disponíveis na Claude API e no Vertex AI do Google Cloud
- Apenas conteúdo de texto é suportado dentro de resultados de pesquisa (sem imagens ou outras mídias)
- O array
contentdeve conter pelo menos um bloco de texto