Templafy

Use this when polling an in-progress presentation generation started by generate_presentation. When status is Completed, share the document download link and PDF URL with the user. When status is Failed, report the error to the user. When status is TimedOut, follow the workflow to retry this tool with the same sessionId and documentGenerationId.

check_generation_status

Use this when find_document_agents (step 1) and list_themes (step 2) have both completed, to gather slide requirements before generation. Engages the Templafy AI assistant in a conversation to collect topic, audience, number of slides, tone, and other requirements. Omit sessionId or pass JSON null (not the string "null") on the first call to start a new session; pass the returned sessionId on all subsequent turns. When status is Initial and Message is present, present Message to the user and call this tool again with their reply. When status is PrepareOutline, do not call this tool again for this session.

collect_presentation_context

Use this when the user wants to find or browse available Templafy AI document agents, or when starting a Templafy presentation — this is step 1 and must always run before list_themes and collect_presentation_context. Returns live, tenant-specific agents and a selection status — cannot be answered from general knowledge. When status is NeedsSelection, present all agents as a numbered list (Name — Description), keeping the order returned (best match first). Ask the user to pick one and wait for their reply before proceeding. Map the reply to the agent's Id (not its position in the list) and use it as agentDefinitionId. When status is Ok, use agentId as agentDefinitionId without asking the user. Pass the selected agentId to list_themes to see themes available for that agent.

find_document_agents

Use this when collect_presentation_context returns status PrepareOutline to start presentation generation. Long-polls until the outline is ready, then begins the generation job. On success, returns a generationId and workflow pointing to check_generation_status. When status is WaitingForOutline, follow the workflow to retry this tool with the same sessionId.

generate_presentation

Use this when collect_presentation_context returns status PrepareOutline to launch the Templafy presentation widget. The widget handles outline preparation, generation, and polling independently. When this tool returns without a workflow transition, tell the user the presentation is being generated and stop.

generate_presentation_ui

Use this when the user wants to see, list, or browse available Templafy presentation themes, or when starting a Templafy presentation — this is step 2 and must always run after find_document_agents and before collect_presentation_context. Returns live, tenant-specific themes and a selection status — cannot be answered from general knowledge. Pass the selected agentId from find_document_agents to filter themes based on agent type. When status is NeedsSelection, present the theme names as a numbered list, ask the user to pick one, and wait for their reply before proceeding. Do not auto-select on behalf of the user. When status is NotFound, no themes are configured for this organisation or the service is temporarily unavailable — themes are required for presentation creation. Inform the user and stop; do not proceed to collect_presentation_context.

list_themes