Herramientas para agentes
Qué puedes automatizar con Gemini Notebook API y su servidor MCP
La preview permite crear cuadernos y cargar fuentes, pero consultar su contenido sigue pendiente. Acceso OAuth, cuentas admitidas, cuotas y un ejemplo útil.
Automatizar la biblioteca antes de automatizar las respuestas
Gemini Notebook API permite que una aplicación o un agente cree cuadernos persistentes y les añada fuentes. Es útil para reunir documentación sin cargar cada enlace a mano. Su límite actual importa tanto como esa posibilidad: recuperar información del cuaderno y generar materiales siguen en el roadmap. No conviene diseñar un chatbot que dependa de esas funciones como si ya estuvieran disponibles.
La API y su servidor MCP están en una Public Preview temprana. Durante esta fase solo admiten cuentas personales de Google; Google Workspace todavía no está soportado. Es el estado de la documentación consultada el 4 de noviembre, no una afirmación de que el lanzamiento haya ocurrido hoy.
| Necesidad | Qué ofrece la preview |
|---|---|
| Crear y organizar cuadernos | Crear, obtener metadatos, listar y cambiar el nombre. |
| Cargar fuentes | Web pública, YouTube con subtítulos, texto y Markdown. |
| Consultar el conocimiento o generar materiales | Pendiente en el roadmap. |
| Subir archivos binarios, usar URLs de Drive o borrar recursos | Pendiente en el roadmap. |
REST y MCP dan acceso al mismo conjunto de operaciones
El servicio REST parte de https://notebook.googleapis.com/v1. Para los agentes existe un servidor remoto en https://notebook.googleapis.com/mcp con transporte Streamable HTTP. Expone siete herramientas: create_notebook, get_notebook, list_notebooks, update_notebook, create_source, get_source y list_sources.
El nombre de una herramienta puede sugerir más de lo que hace. get_source obtiene metadatos y estado de procesamiento; no es una consulta de preguntas sobre el contenido. MCP facilita que un agente invoque las operaciones, pero no amplía el alcance de la API.
Un ejemplo hipotético sería preparar un cuaderno para estudiar una biblioteca de programación. El agente seleccionaría su documentación pública, añadiría un vídeo con subtítulos y guardaría unas notas en Markdown. La automatización deja reunidas las fuentes para trabajar con ellas; este ejemplo no supone una llamada ejecutada ni una respuesta generada por la API.
Añadir una fuente no significa que ya esté lista
La ingesta es asíncrona. Una fuente empieza en PROCESSING y termina en ACTIVE o FAILED. El flujo debe consultar su estado y registrar los errores; recibir el recurso creado no demuestra que su contenido se haya procesado correctamente.
Las páginas deben ser accesibles por HTTPS sin acceso privado ni muro de pago. En YouTube se admiten vídeos públicos o no listados con subtítulos. Para texto y Markdown en línea se aplican dos límites a la vez: 500.000 palabras por fuente y 1.000.000 de bytes de payload. Un documento puede agotar el límite de bytes mucho antes que el de palabras.
En ese cuaderno de investigación, guardaría la URL de origen y el identificador de cada recurso en un registro propio. Antes de reintentar una carga comprobaría qué quedó creado. Así podría detectar duplicados y distinguir una fuente pendiente de una fallida. Es una recomendación de implementación, especialmente útil mientras el borrado de recursos siga pendiente en esta API.
Acceso con OAuth y cuotas concretas
La autenticación usa OAuth 2.0, no una API key. Hay que habilitar notebook.googleapis.com en un proyecto de Google Cloud y haber entrado al menos una vez en Gemini Notebook con la cuenta que autoriza el acceso. Existen los permisos notebook y notebook.readonly para escritura/lectura y solo lectura, respectivamente. Con credenciales ADC, también se envía x-goog-user-project para identificar el proyecto de cuota.
La API es gratuita durante la Public Preview, sujeta a límites. Por proyecto hay 100 peticiones de lectura y 100 de escritura por minuto. Por usuario, CreateSource admite 20 por minuto; los demás métodos, 60 por minuto por método. Superarlos devuelve 429 y requiere reintentos espaciados con variación aleatoria.
La capacidad total depende del nivel de la cuenta. Estos son los máximos publicados por Google para la preview; no son una medición de velocidad ni una garantía de que una carga masiva vaya a completarse sin errores.
| Nivel | Cuadernos por usuario | Fuentes por cuaderno |
|---|---|---|
| Free | 100 | 50 |
| Plus | 200 | 100 |
| Pro | 500 | 300 |
| Ultra | 500 | 600 |
Dónde lo usaría hoy
Lo probaría como entrada controlada de fuentes para una investigación personal o una colección temática. Mantendría la selección y el registro de cargas en la aplicación, y exigiría estado ACTIVE antes de dar una fuente por incorporada. Una carpeta llena de enlaces aporta poco si incluye versiones viejas, duplicados o páginas que no llegaron a procesarse.
Para una integración MCP también planificaría la renovación del acceso. Los tokens que genera el procedimiento local con gcloud caducan a la hora; pegarlos una vez en la configuración no resuelve una conexión permanente. Mantendría esos secretos fuera del repositorio y acotaría qué cuenta y qué cuadernos puede utilizar el agente.
No trasladaría documentación corporativa a una cuenta personal para salvar la ausencia de Workspace. Si el producto necesita consultar el conocimiento por API, generar materiales o gestionar un ciclo completo de altas y bajas, ese requisito queda fuera del alcance publicado hoy. La decisión es aprovechar la ingesta disponible cuando resuelve una necesidad concreta, conservando los originales y sin construir sobre promesas del roadmap.