Ir al contenido principal
Español— Elegir un idioma
Menú

Filtrado por dominio

Lección 5 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Control de las fuentes de búsqueda
  2. Dos parámetros mutuamente excluyentes
  3. Uso de allowed_domains (lista de permitidos)
  4. Uso de excluded_domains (lista de bloqueados)
  5. Sintaxis del SDK
  6. Límites y buenas prácticas
  7. Puntos clave

Control de las fuentes de búsqueda

De forma predeterminada, la búsqueda web explora toda la red. Esto funciona bien para consultas generales, pero a menudo se queda corto en casos de uso profesionales donde necesitas fuentes fiables y controladas. El filtrado por dominio te permite restringir o excluir sitios específicos.

Dos parámetros mutuamente excluyentes

La búsqueda web ofrece dos parámetros de filtrado:

  • allowed_domains: restringe la búsqueda a los dominios especificados (lista de permitidos)
  • excluded_domains: excluye dominios específicos de los resultados (lista de bloqueados)

Estos dos parámetros son mutuamente excluyentes. No puedes usar ambos en la misma solicitud. Si lo intentas, la API devolverá un error.

Cada parámetro acepta un array de hasta 5 dominios.

Uso de allowed_domains (lista de permitidos)

Utiliza este parámetro cuando sepas exactamente qué fuentes quieres consultar. Por ejemplo, para investigación académica:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest publications on transformers?",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

El modelo busca solo en estos tres dominios. Esto garantiza que los resultados procedan de fuentes científicas verificadas.

Casos de uso de la lista de permitidos

  • Investigación académica: limitar a arxiv.org, scholar.google.com, nature.com
  • Documentación técnica: limitar a sitios oficiales de tecnología
  • Inteligencia competitiva: limitar a sitios de la competencia
  • Cumplimiento normativo: limitar a fuentes gubernamentales o reguladoras

Uso de excluded_domains (lista de bloqueados)

Utiliza este parámetro cuando quieras una búsqueda amplia pero necesites excluir fuentes poco fiables o irrelevantes:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the best JavaScript frameworks in 2026?",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

El modelo busca en toda la web excepto en los dominios excluidos.

Casos de uso de la lista de bloqueados

  • Excluir foros: evitar opiniones no verificadas
  • Excluir agregadores: evitar contenido duplicado
  • Excluir competidores: mantener su contenido fuera de tus resultados
  • Excluir muros de pago: evitar sitios con contenido inaccesible

Sintaxis del SDK

xAI SDK

tools=[client.tools.web_search(
    allowed_domains=["arxiv.org", "nature.com"]
)]

OpenAI SDK

tools=[{
    "type": "web_search",
    "excluded_domains": ["reddit.com"]
}]

Vercel AI SDK

tools: [xai.tools.webSearch({
  allowedDomains: ["arxiv.org", "nature.com"]
})]

Ten en cuenta la convención camelCase (allowedDomains) en el SDK de JavaScript.

Límites y buenas prácticas

El límite de 5 dominios puede parecer restrictivo. En la práctica, te obliga a ser selectivo con las fuentes, lo que mejora la calidad de los resultados. Si necesitas más flexibilidad, puedes ejecutar varias solicitudes con diferentes dominios y agregar los resultados en el lado del cliente.

Cuando uses allowed_domains, asegúrate de que los dominios elegidos cubran el tema solicitado. Un dominio demasiado restrictivo podría impedir que el modelo encuentre información relevante, lo que podría llevarle a responder sin datos actualizados.

Puntos clave

  • Dos parámetros disponibles: allowed_domains (lista de permitidos) y excluded_domains (lista de bloqueados)
  • Mutuamente excluyentes: no puedes combinarlos en la misma solicitud
  • Máximo 5 dominios por parámetro
  • La lista de permitidos es ideal para fuentes controladas y fiables
  • La lista de bloqueados funciona para búsquedas amplias con pocas exclusiones