Filtrar Domínios na Pesquisa Web
Nesta página
Controlar Fontes para Resultados Fiáveis
Quando integra a pesquisa web numa aplicação empresarial, não quer que o modelo recolha informações de qualquer lugar. Um chatbot jurídico precisa de consultar fontes oficiais, um assistente médico deve limitar-se a publicações científicas e uma ferramenta de monitorização tecnológica deve visar sites de referência.
A API do Grok oferece dois parâmetros de filtragem para controlar as fontes: allowed_domains e excluded_domains. Estes parâmetros conferem-lhe um controlo granular sobre o âmbito da pesquisa.
Os Dois Modos de Filtragem
Lista de Permissões: allowed_domains
Este parâmetro restringe a pesquisa apenas aos domínios que especificar. O modelo não consultará nenhum outro site:
response = client.responses.create(
model="grok-4.5",
input="What are the latest advancements in AI?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Lista de Exclusão: excluded_domains
Este parâmetro permite todas as fontes exceto as que listar. Útil para excluir sites pouco fiáveis ou concorrentes:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
A Regra de Exclusividade Mútua
Os parâmetros allowed_domains e excluded_domains são mutuamente exclusivos. Não pode utilizar ambos simultaneamente numa única chamada. Se tentar combiná-los, a API devolverá um erro.
Escolha a sua estratégia com base no caso de uso:
- Lista de permissões (
allowed_domains): quando sabe exatamente quais as fontes fiáveis e todo o resto é suspeito - Lista de exclusão (
excluded_domains): quando a maioria das fontes é aceitável, mas algumas colocam problemas
Limite de Cinco Domínios
Cada parâmetro aceita um máximo de 5 domínios. Esta restrição obriga-o a priorizar as suas fontes. Se precisar de abranger mais sites, considere fazer várias chamadas com listas diferentes ou utilize a lista de exclusão para bloquear os poucos domínios problemáticos.
Sintaxe do Domínio
Especifique os domínios sem protocolo nem barra final:
# Correto
"allowed_domains": ["arxiv.org", "nature.com"]
# Incorreto
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Casos de Uso Práticos
Assistente de Investigação Científica
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Monitorização Regulamentar Europeia
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Chatbot Empresarial Sem Redes Sociais
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Estratégia de Filtragem Dinâmica
Numa aplicação real, pode adaptar a filtragem com base no contexto do pedido do utilizador:
def get_search_config(category):
configs = {
"legal": {
"allowed_domains": ["legifrance.gouv.fr", "eur-lex.europa.eu"]
},
"tech": {
"excluded_domains": ["pinterest.com", "quora.com"]
},
"general": {}
}
return configs.get(category, {})
search_params = get_search_config(user_category)
tools = [{"type": "web_search", **search_params}]
Prática Guiada
Crie um assistente especializado num domínio à sua escolha (jurídico, científico, tecnológico). Configure a filtragem de domínios adequada e teste-a com várias perguntas. Compare os resultados obtidos com e sem filtragem para medir o impacto na relevância da resposta.
Pontos-chave
allowed_domainsrestringe a pesquisa a uma lista de sites permitidosexcluded_domainsexclui sites específicos da pesquisa- Ambos os parâmetros são mutuamente exclusivos: apenas um por chamada
- Máximo de 5 domínios por parâmetro
- Especifique os domínios sem protocolo (
arxiv.org, e nãohttps://arxiv.org) - Adapte a estratégia ao caso de uso: lista de permissões para domínios sensíveis, lista de exclusão para filtragem ligeira