Tools
Der kreative Werkzeugkasten für deinen Agenten.
Jedes Tool liefert eine stabile JSON-Struktur und ist für deinen Agenten mit ausführlichen, KI-lesbaren Schemas beschrieben. So wählt er ohne Hilfestellung das passende Tool.
01
Generierung starten
generate_presentation_startStartet einen neuen Job zur Präsentationserstellung. Wartet standardmäßig per Long-Polling direkt im Aufruf, sodass ein einziger Tool-Aufruf in der Regel die fertige Präsentation zurückgibt. Eine Generierung dauert meist 5 bis 7 Minuten.
- userPrompt
- Prompt, der die gewünschte Präsentation beschreibt.
- systemInstructions
- Anweisungen von KI zu KI mit drei Feldern: designStyle, resourcesToUse, context.
- slideCount
- Gewünschte Anzahl an Folien. 1 bis 25, Standard: 10.
- generateImages
- Ob das Modell Bilder generieren soll.
- themeId
- Optionale Theme-ID aus list_available_themes.
- images
- Optionale Bildanhänge (max. 8). Jeder Anhang ist eine öffentliche imageUrl, die als visuelle Referenz weitergegeben wird.
- waitForCompletionMs
- Long-Polling-Zeitbudget in Millisekunden. Empfohlen: 220000. Maximum: 900000.
02
Status abfragen
generate_presentation_statusGibt den Status eines laufenden Jobs zurück. Mit waitForCompletionMs wartet der Aufruf per Long-Polling, bis der Job einen Endstatus erreicht, und sendet über dein progressToken MCP-Fortschrittsbenachrichtigungen.
- jobId
- Job-UUID, die generate_presentation_start zurückgibt.
- waitForCompletionMs
- Long-Polling-Zeitbudget in Millisekunden.
03
Generierung abbrechen
generate_presentation_cancelBricht eine laufende Generierung ab. Hat der Job bereits einen Endstatus erreicht, passiert nichts.
- jobId
- UUID des abzubrechenden Jobs.
04
Kuratierte Themes auflisten
list_available_themesGibt den Katalog kuratierter Design-Themes zurück. Jedes Theme enthält einen fertigen designStyle-Prompt, den du unverändert als systemInstructions.designStyle übergeben kannst.
05
Abrechnung und KI-Credits abfragen
get_billing_statusGibt billing_plan und die verbleibenden ai_credits des angemeldeten Nutzers zurück, dazu die URL, die du weitergeben kannst, falls ein Upgrade oder eine Aufladung nötig ist.
06
Health Check
health_checkGibt den grundlegenden Status des MCP-Backend-Prozesses zurück. Praktisch, um die Verbindung zu prüfen.