Herramientas
El kit creativo de tu agente.
Cada herramienta devuelve un JSON con una estructura estable y se describe a tu agente con esquemas detallados y legibles por IA, para que elija la adecuada sin que tengas que guiarlo.
01
Iniciar una generación
generate_presentation_startLanza un nuevo trabajo de generación de presentaciones. Por defecto hace long polling en la propia llamada, así que normalmente una sola llamada devuelve la presentación terminada. Las generaciones suelen tardar de 5 a 7 minutos.
- userPrompt
- Prompt que describe la presentación que quieres obtener.
- systemInstructions
- Indicaciones de IA a IA con tres campos: designStyle, resourcesToUse y context.
- slideCount
- Número de diapositivas deseado. De 1 a 25; 10 por defecto.
- generateImages
- Indica si el modelo debe generar imágenes.
- themeId
- ID de tema opcional obtenido de list_available_themes.
- images
- Imágenes adjuntas opcionales (máximo 8). Cada una es un imageUrl público que se envía como referencia visual.
- waitForCompletionMs
- Tiempo máximo de long polling en milisegundos. Recomendado: 220000. Máximo: 900000.
02
Consultar el estado
generate_presentation_statusDevuelve el estado de un trabajo en curso. Pasa waitForCompletionMs para hacer long polling hasta que el trabajo llegue a un estado final y recibir notificaciones de progreso MCP a través de tu progressToken.
- jobId
- UUID del trabajo devuelto por generate_presentation_start.
- waitForCompletionMs
- Tiempo máximo de long polling en milisegundos.
03
Cancelar una generación
generate_presentation_cancelCancela una generación en curso. Si el trabajo ya ha llegado a un estado final, no hace nada.
- jobId
- UUID del trabajo que se va a cancelar.
04
Listar temas seleccionados
list_available_themesDevuelve el catálogo de temas de diseño seleccionados. Cada tema incluye un prompt designStyle listo para usar que puedes pasar tal cual como systemInstructions.designStyle.
05
Consultar facturación y créditos de IA
get_billing_statusDevuelve el billing_plan y los ai_credits restantes del usuario autenticado, además de la URL que puedes compartir si necesita mejorar su plan o recargar créditos.
06
Comprobación de estado
health_checkDevuelve el estado básico del proceso MCP del backend. Útil para verificar la conectividad.