Aprovechar las citas en los resultados
En esta página
Respuestas rastreables con citas
Cuando un usuario formula una pregunta factual a tu aplicación, quiere poder verificar la información. Las citas de la API de Grok cubren exactamente esta necesidad: cada dato recuperado mediante búsqueda web incluye su fuente. Esto te permite construir interfaces donde cada afirmación sea clicable y verificable.

La API ofrece dos mecanismos de citación complementarios: citas globales y citas en línea. Entender cómo funcionan te permitirá crear experiencias de usuario profesionales y transparentes.
Citas globales: la lista completa de fuentes
Las citas globales se devuelven por defecto en el atributo citations de la respuesta. Contienen una lista de todas las URL consultadas por el modelo, incluso aquellas que no se mencionan directamente en el texto de la respuesta.
response = client.responses.create(
model="grok-4.5",
input="What are the latest AI regulations in Europe?",
tools=[{"type": "web_search"}]
)
# Access global citations
for citation in response.citations:
print(f"Source: {citation.url}")
No se requiere ninguna configuración adicional. Este es el comportamiento nativo de la API.
Citas en línea: referencias dentro del texto
Las citas en línea insertan enlaces Markdown directamente en el texto de la respuesta, utilizando el formato [[N]](url), donde N es un número secuencial que comienza en 1. Si se cita la misma fuente varias veces, se reutiliza el número original.
El comportamiento por defecto depende del SDK que utilices:
- API de Respuestas directa: citas en línea activadas por defecto
- SDK de xAI: citas en línea desactivadas por defecto (opt-in)
Activar las citas en línea con el SDK de xAI
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["inline_citations"]
)
Desactivar las citas en línea en la API de Respuestas
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
El esquema de anotaciones estructuradas
Cada cita en línea genera un objeto de anotación con metadatos precisos. Esta estructura permite un procesamiento programático avanzado:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Los campos start_index y end_index siguen la convención de rebanadas (slices) de Python. Puedes utilizarlos para extraer el texto citado exacto o crear una representación HTML personalizada:
text = response.output_text
for annotation in response.annotations:
cited_text = text[annotation.start_index:annotation.end_index]
print(f"Cited text: {cited_text}")
print(f"Source: {annotation.url}")
Comportamiento en streaming
Al utilizar streaming, las citas en línea aparecen progresivamente en los fragmentos de texto. Sin embargo, las anotaciones completas solo están disponibles en la respuesta final. Planifica un procesamiento en dos fases si tu interfaz muestra las fuentes en tiempo real.
Construir una interfaz con fuentes
Aquí tienes un ejemplo de cómo transformar las citas en HTML estructurado:
def format_response_with_sources(response):
text = response.output_text
sources = []
# Collect unique sources
seen_urls = set()
for citation in response.citations:
if citation.url not in seen_urls:
sources.append(citation.url)
seen_urls.add(citation.url)
# Build the render
html = f"<div class='response'>{text}</div>"
html += "<div class='sources'><h4>Sources</h4><ul>"
for i, url in enumerate(sources, 1):
html += f"<li><a href='{url}'>[{i}] {url}</a></li>"
html += "</ul></div>"
return html
Citas de colecciones
Si utilizas la herramienta collections_search junto con web_search, las citas procedentes de tus documentos subidos emplean un formato de URI específico: collections://collection_id/files/file_id. Distingue estas citas de las citas web estándar para adaptar la representación en el front-end.
Práctica guiada
Crea una aplicación que muestre los resultados de búsqueda de Grok con un sistema de notas al pie. Cada hecho debe enlazar de vuelta a su fuente original. Prueba con preguntas sobre actualidad y verifica manualmente que los enlaces sean válidos y relevantes.
Puntos clave
- Las citas globales (lista de URL) se devuelven por defecto, sin configuración
- Las citas en línea (enlaces en el texto) se activan mediante el parámetro
include - El comportamiento por defecto de las citas en línea varía según el SDK
- Cada anotación contiene la URL, los índices de posición y el número de cita
- En streaming, las anotaciones completas solo están disponibles en la respuesta final
- Las citas de colecciones utilizan un formato de URI distinto (
collections://)