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

Aprovechar las citas en los resultados

Lección 3 de 14 Actualizado el 30 de julio de 2026 Principiante
En esta página
  1. Respuestas rastreables con citas
  2. Citas globales: la lista completa de fuentes
  3. Citas en línea: referencias dentro del texto
  4. El esquema de anotaciones estructuradas
  5. Comportamiento en streaming
  6. Construir una interfaz con fuentes
  7. Citas de colecciones
  8. Práctica guiada
  9. Puntos clave

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.

Citas y fuentes en las respuestas de Grok

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://)