Citas y fuentes automáticas
En esta página
Trazabilidad de la información
Una de las ventajas clave de la búsqueda web frente a la simple generación de texto es la trazabilidad. Cuando el modelo utiliza información procedente de una búsqueda web, la API devuelve automáticamente citas con las URL de las fuentes que ha consultado. Esto te permite verificar la información y presentarla con referencias en tu aplicación.
Cómo funcionan las citas
La API genera las citas automáticamente sin necesidad de ninguna configuración por tu parte. Una vez activada la búsqueda web y si el modelo utiliza los resultados de la búsqueda en su respuesta, las fuentes se incluyen en el objeto de respuesta.
Accede a las citas mediante el campo citations de la respuesta. Cada cita contiene la URL de la fuente y el contexto en el que se ha utilizado.
Uso de citas en tu aplicación
Mostrar las fuentes
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in quantum computing?",
tools=[{"type": "web_search"}]
)
# Display the response
print(response.output_text)
# Display the citations
if hasattr(response, 'citations') and response.citations:
print("\nSources:")
for citation in response.citations:
print(f" - {citation.url}")
Integrar las fuentes en una interfaz de usuario
En una aplicación web, puedes convertir las citas en enlaces clicables. Esto refuerza la credibilidad de tu aplicación y permite al usuario final verificar la información.
def format_response_with_sources(response):
output = response.output_text
if hasattr(response, 'citations') and response.citations:
output += "\n\n---\n**Sources:**\n"
for i, citation in enumerate(response.citations, 1):
output += f"{i}. [{citation.url}]({citation.url})\n"
return output
Casos de uso de las citas
Chatbots empresariales
Para un asistente de IA diseñado para tus clientes, las citas aportan transparencia. El usuario puede verificar que la información procede de una fuente fiable, lo que genera confianza en las respuestas.
Aplicaciones de supervisión
En una herramienta de supervisión automatizada, las citas son esenciales para rastrear el origen de la información. Permiten vincular cada conclusión con su fuente y facilitan el análisis en profundidad.
Generación de informes
Si utilizas la API para generar informes automatizados, las citas sirven de bibliografía. Documentan las fuentes utilizadas y aportan rigor al informe.
Combinar citas y filtrado por dominio
Al combinar allowed_domains con las citas, obtienes un sistema de búsqueda controlado y trazable:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Current state of AI regulation in Europe",
tools=[{
"type": "web_search",
"allowed_domains": [
"ec.europa.eu",
"eur-lex.europa.eu",
"legifrance.gouv.fr"
]
}]
)
Las citas confirmarán que la información procede exclusivamente de fuentes autorizadas.
Limitaciones a tener en cuenta
- Las citas no siempre están presentes: si el modelo responde sin utilizar resultados de búsqueda, no se genera ninguna cita.
- El formato exacto de las citas puede variar según el SDK utilizado.
- Las citas hacen referencia a las páginas consultadas, no necesariamente a los pasajes exactos utilizados.
- El número de citas depende de la cantidad de fuentes que el modelo haya utilizado realmente.
Puntos clave
- Las citas son automáticas: no requieren configuración.
- Son accesibles a través del campo
citationsde la respuesta. - Las citas aportan trazabilidad y credibilidad a tu aplicación.
- Se combinan con el filtrado por dominio para un control total.
- Intégralas en tu interfaz para permitir la verificación de las fuentes.