---
title: "Respuestas de IA con citas de tus propios archivos | Calypso"
canonical_url: "https://www.calypso.so/es/elephant/citations"
last_updated: 2026-11-21
meta:
  description: "Cada respuesta de Elephant nombra el archivo, la página y el pasaje del que sale, con un enlace al original. Si tus archivos no la cubren, lo dice."
  keywords: "AI answers with citations, chat with documents with sources, AI that cites the page, verifiable AI answers, RAG with citations"
  "og:description": "Cada respuesta de Elephant nombra el archivo, la página y el pasaje del que sale, con un enlace al original. Si tus archivos no la cubren, lo dice."
  "og:title": "Respuestas de IA con citas de tus propios archivos | Calypso"
  "twitter:description": "Cada respuesta de Elephant nombra el archivo, la página y el pasaje del que sale, con un enlace al original. Si tus archivos no la cubren, lo dice."
  "twitter:title": "Respuestas de IA con citas de tus propios archivos | Calypso"
---

Conecta tu IA

**Elephant · Citas**

# Cada respuesta dice de dónde salió.

Cada afirmación remite al archivo y al pasaje del que sale, con la página en los PDF y un enlace para abrir el original. Si tus fuentes no cubren una pregunta, Elephant lo dice en vez de rellenar el hueco. Los desarrolladores reciben las mismas fuentes como datos estructurados, ancladas al texto por posición de carácter.

[**Leer la documentación de citas**](https://docs.calypso.so/context/ask/citations-and-sources) [**Prueba gratis 14 días**](https://elephant.calypso.so/join?targetAppKey=elephant)

**El ejemplo**

## Pregunta una vez. Renderiza las fuentes desde la respuesta.

El modo nativo mantiene la respuesta con forma OpenAI: anotaciones sobre el texto, fuentes en file_search_call.results. Nada que analizar, nada propietario que aprender.

**CALYPSO_API_KEY**

```
import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["CALYPSO_API_KEY"],
                base_url="https://api.calypso.so/v1")

resp = client.responses.create(
    model="elephant-agent",
    input="What is our refund policy?",
    metadata={"citation_compat": "native", "sources_appendix": "omit"},
)

print(resp.output_text)
for item in resp.output:
    if item.type == "file_search_call":
        for r in item.results:
            a = r.attributes
            print(f"[{a['source_index']}] {a['label']}")   # refund_policy_2026.pdf (p. 4)
```

**Dos superficies**

## Responses para interfaces con citas. Chat Completions por compatibilidad.

Ambos endpoints llevan citas. Responses expone toda la superficie estructurada; Chat Completions se limita a la forma url_citation que define esa especificación.

### **Responses**

<dl>

<dt>**Las citas viven en**</dt>
<dd>output[] → message → output_text.annotations[]</dd>

<dt>**Las fuentes viven en**</dt>
<dd>output[] → file_search_call.results[]</dd></dl>

Recomendado. En streaming envía un evento annotation.added por cita y los resultados completos en response.completed.

### **Chat Completions**

<dl>

<dt>**Las citas viven en**</dt>
<dd>choices[0].message.annotations[] como url_citation</dd>

<dt>**Las fuentes viven en**</dt>
<dd>Un apéndice "Sources:" en texto plano dentro del contenido</dd></dl>

Las fuentes de archivos y medios se mapean a url_citation con una URL firmada cuando existe y el nombre de archivo como título. En streaming, las anotaciones llegan en un último fragmento.

**Los atributos**

## Qué lleva cada fuente.

Los mismos atributos aparecen en los resultados de Responses y en los de Search. Construye tu lista de fuentes directamente desde ellos.

| **source_index** | Número de fuente estable, desde 1, que coincide con el orden [n] del texto. Úsalo para las insignias y la lista. |
| --- | --- |
| **label** | Listo para mostrar, por ejemplo refund_policy_2026.pdf (p. 4). Si no hay más, usa el nombre del archivo. |
| **page_number · page_label · locator_label** | Dónde dentro del documento, cuando se sabe. Los PDFs citan la página; otros documentos citan el archivo. |
| **modality · mime_type** | text, multimodal o image, y el tipo MIME. Una cita a una imagen apunta a la propia imagen. |
| **access_url · media_id** | Una URL firmada para abrir el original cuando existe, e identificadores de medios para vistas previas. |
| **text · excerpt · preview** | La evidencia citada que usó la respuesta, más descriptores estructurados de extracto y vista previa. |

**Cómo funciona**

## Preguntar, mapear, abrir.

1. 01 ### **Pregunta a un agente**

   Llama a Responses con elephant-agent o con un agente con nombre. La recuperación corre sobre sus buckets y la evidencia vuelve con la respuesta.
2. 02 ### **Mapea las posiciones al texto**

   Cada anotación lleva start_index y end_index. Coloca tus marcadores [n] desde las posiciones, numerados por source_index.
3. 03 ### **Deja que los usuarios abran la fuente**

   Renderiza la lista de fuentes desde los atributos y enlaza cada entrada a su access_url para que el lector pueda comprobar la página.

**Renderizado**

## Cuatro reglas de la documentación.

1. 01 ### **Ancla por posiciones, no por marcadores**

   Usa start_index y end_index para colocar referencias. No extraigas tokens [n] del texto.
2. 02 ### **Numera por source_index**

   Es estable, empieza en 1 y coincide con el orden de las citas. Úsalo para insignias y lista.
3. 03 ### **Ordena antes de cortar**

   Aplica las anotaciones en orden descendente de start_index para que las inserciones anteriores no desplacen las posiciones posteriores.
4. 04 ### **Respeta el estado de grounding**

   Muestra un panel de fuentes solo cuando grounded_sources_state es available. hidden significa que la política oculta las fuentes; missing y none significan que no hay nada que mostrar.

**De la documentación**

## El esquema en una tabla.

| **Modelo** | Anotaciones OpenAI: objetos de cita anclados al texto por posición de caracteres; el texto de la respuesta se mantiene plano |
| --- | --- |
| **Responses** | output[] → message → output_text.annotations[] · output[] → file_search_call.results[] |
| **Chat Completions** | choices[0].message.annotations[] (url_citation) + "Sources:" appendix |
| **Modos de compatibilidad** | metadata.citation_compat: legacy \| native · metadata.sources_appendix: include \| omit |
| **Evento de streaming** | response.output_text.annotation.added |
| **Citas por página** | PDFs, que se leen como imágenes de página; las imágenes citan la imagen; otros documentos citan el archivo |
| **Estados de grounding** | available · hidden · missing · none |

**Preguntas y respuestas**

## Antes de renderizar tu primera cita.

**Sigue leyendo**

[<h3>**Fuentes **</h3>PDF, capturas, páginas y notas. Qué lee y cómo lo guardas.](https://www.calypso.so/elephant/sources) [<h3>**Buckets **</h3>Carpetas que tu IA recuerda. Pregunta a una, o a todas.](https://www.calypso.so/elephant/buckets) [<h3>**Agentes **</h3>Asistentes con nombre, con sus propios buckets e instrucciones.](https://www.calypso.so/elephant/agents) [<h3>**Búsqueda **</h3>El pasaje exacto, ordenado, sin respuesta escrita.](https://www.calypso.so/elephant/search) [<h3>**Privacidad **</h3>Privado por defecto: no entrena con tus archivos, nunca borra, tú eliges qué puede hacer cada IA.](https://www.calypso.so/elephant/privacy) [<h3>**Citas en la documentación **</h3>La referencia desde la que está escrita esta página, con cada endpoint y campo.](https://docs.calypso.so/context/ask/citations-and-sources)

**Empieza hoy**

## **Confía en respuestas que puedes comprobar.**

Guarda un PDF, pregunta a Elephant y abre la página detrás de la respuesta.

[**Prueba gratis 14 días**](https://elephant.calypso.so/join?targetAppKey=elephant) [**Lee la documentación**](https://docs.calypso.so/context/ask/citations-and-sources)