Tool
Il kit creativo del tuo agente.
Ogni tool restituisce un JSON con una struttura stabile ed è descritto al tuo agente con schemi ricchi e leggibili dall'AI, così sceglie quello giusto senza bisogno di aiuto.
01
Avvia una generazione
generate_presentation_startAvvia un nuovo job di generazione di una presentazione. Per impostazione predefinita fa long-polling nella stessa chiamata, quindi di solito una sola chiamata al tool restituisce la presentazione finita. Le generazioni di solito richiedono da 5 a 7 minuti.
- userPrompt
- Prompt che descrive la presentazione desiderata.
- systemInstructions
- Indicazioni da AI ad AI con tre campi: designStyle, resourcesToUse e context.
- slideCount
- Numero di slide desiderato. Da 1 a 25, predefinito 10.
- generateImages
- Indica se il modello deve generare immagini.
- themeId
- ID facoltativo di un tema ottenuto da list_available_themes.
- images
- Immagini allegate facoltative (massimo 8). Ognuna è un imageUrl pubblico inoltrato come riferimento visivo.
- waitForCompletionMs
- Tempo massimo di long-polling in millisecondi. Consigliato: 220000. Massimo: 900000.
02
Controlla lo stato della generazione
generate_presentation_statusRestituisce lo stato di un job in corso. Passa waitForCompletionMs per fare long-polling finché il job non raggiunge uno stato finale e per ricevere le notifiche di avanzamento MCP tramite il tuo progressToken.
- jobId
- UUID del job restituito da generate_presentation_start.
- waitForCompletionMs
- Tempo massimo di long-polling in millisecondi.
03
Annulla una generazione
generate_presentation_cancelAnnulla una generazione in corso. Non fa nulla se il job ha già raggiunto uno stato finale.
- jobId
- UUID del job da annullare.
04
Elenca i temi selezionati
list_available_themesRestituisce il catalogo dei temi di design selezionati. Ogni tema include una stringa di prompt designStyle pronta all'uso, che puoi passare così com'è come systemInstructions.designStyle.
05
Leggi fatturazione e crediti AI
get_billing_statusRestituisce billing_plan e gli ai_credits rimanenti dell'utente autenticato, più l'URL da condividere se l'utente deve passare a un piano superiore o ricaricare i crediti.
06
Health check
health_checkRestituisce lo stato di base del processo MCP nel backend. Utile per verificare la connessione.