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

Crear y gestionar colecciones

Lección 5 de 16 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. De archivos aislados a una base de conocimientos
  2. Una API separada y el motivo
  3. Crea tu primera colección
  4. Las cinco operaciones disponibles
  5. Puntos clave

De archivos aislados a una base de conocimientos

Hasta ahora, cada documento existía de forma aislada: lo subías, lo referenciabas y el índice generado para la ocasión desaparecía junto con la consulta. Las colecciones cambian la escala: agrupan tus archivos en bases de conocimientos estructuradas, indexadas una sola vez y consultables indefinidamente. Esta es la base del RAG (Generación Aumentada por Recuperación) con Grok, y la diferencia se nota en cuanto un equipo de soporte consulta doscientas fichas de producto en lugar de un único PDF.

Piensa en una colección como una carpeta inteligente. Depositas documentos, xAI los indexa para la búsqueda semántica y Grok explora esta base para responder con precisión, extrayendo los tres pasajes útiles entre miles.

100k
Archivos por cuenta
100 GB
Capacidad total
CRUD
Operaciones completas
$2.50
Por cada 1.000 búsquedas

Una API separada y el motivo

No gestionarás las colecciones desde la API que has utilizado desde el inicio del curso. Estas corresponden a la Management API, alojada en management-api.x.ai, con la URL base:

https://management-api.x.ai/v1

Esta separación no es un capricho arquitectónico. Crear, modificar o eliminar una colección son operaciones administrativas con consecuencias graves, y xAI exige una clave dedicada para ellas: una Management API Key, con el permiso AddFileToCollection. La ventaja es inmediata para los equipos: el servicio que consulta la base desde tu aplicación pública recibe la clave estándar y no puede destruir nada; solo tu canal de ingestión posee la clave de gestión.

Crea tu primera colección

La creación se reduce a una única llamada con un nombre:

curl -X POST https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection_name": "technical-docs"}'

La respuesta devuelve el identificador que debes conservar:

{
  "collection_id": "col_xyz789",
  "collection_name": "technical-docs",
  "created_at": "2026-04-01T10:00:00Z"
}

Elige este nombre con cuidado: aparecerá en todas tus listas y, dentro de seis meses, será la única pista que te permita distinguir dos bases vecinas. technical-docs cumple esta función; test2 no. Adopta una convención desde la primera colección, porque renombrar una base ya referenciada por tres aplicaciones cuesta más que nombrarla bien desde el principio.

Las cinco operaciones disponibles

La Management API expone un conjunto CRUD completo sobre las colecciones:

OperaciónMétodoEndpoint
CrearPOST/v1/collections
ListarGET/v1/collections
DetallesGET/v1/collections/{collection_id}
ActualizarPUT/v1/collections/{collection_id}
EliminarDELETE/v1/collections/{collection_id}

Listar tus colecciones se realiza sin parámetros y ofrece una visión útil antes de cualquier operación de mantenimiento:

curl https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

La eliminación sigue la misma lógica, designando el identificador obtenido en la creación:

curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Hay algo que debería tranquilizarte al ejecutar este comando: eliminar una colección borra la indexación, no los archivos. Tus documentos siguen accesibles mediante la Files API y pueden reindexarse en otro lugar. Pierdes la estructura de búsqueda, no la materia prima, lo que hace que reconstruir una base mal organizada sea mucho menos arriesgado de lo que parece.

Puntos clave

  • Las colecciones agrupan tus archivos en bases de conocimientos indexadas para RAG
  • La gestión se realiza mediante la Management API (management-api.x.ai), no la API estándar
  • Se requiere una Management API Key con el permiso AddFileToCollection
  • Los límites son 100.000 archivos y 100 GB por cuenta
  • Las cinco operaciones CRUD cubren la creación, lectura, actualización y eliminación