Tools
O kit criativo do seu agente.
Cada tool retorna um JSON com formato estável e é descrita para o seu agente com schemas ricos e legíveis por IA, para que ele escolha a certa sem precisar de ajuda.
01
Iniciar uma geração
generate_presentation_startInicia um novo job de geração de apresentação. Por padrão, faz long-polling na própria chamada, então uma única chamada de tool normalmente já retorna a apresentação pronta. As gerações costumam levar de 5 a 7 minutos.
- userPrompt
- Prompt que descreve a apresentação desejada.
- systemInstructions
- Orientações de IA para IA com três campos: designStyle, resourcesToUse e context.
- slideCount
- Número desejado de slides. De 1 a 25, padrão 10.
- generateImages
- Define se o modelo deve gerar imagens.
- themeId
- ID de tema opcional, obtido em list_available_themes.
- images
- Imagens anexas opcionais (máx. 8). Cada uma é uma imageUrl pública, enviada como referência visual.
- waitForCompletionMs
- Tempo máximo de long-polling em milissegundos. Recomendado: 220000. Máximo: 900000.
02
Consultar status da geração
generate_presentation_statusRetorna o status de um job em andamento. Passe waitForCompletionMs para fazer long-polling até o job chegar a um estado final e receber notificações de progresso MCP pelo seu progressToken.
- jobId
- UUID do job retornado por generate_presentation_start.
- waitForCompletionMs
- Tempo máximo de long-polling em milissegundos.
03
Cancelar uma geração
generate_presentation_cancelCancela uma geração em andamento. Não faz nada se o job já tiver chegado a um status final.
- jobId
- UUID do job a ser cancelado.
04
Listar temas selecionados
list_available_themesRetorna o catálogo de temas de design selecionados. Cada tema já vem com uma string de prompt designStyle pronta para uso, que você pode passar sem alterações como systemInstructions.designStyle.
05
Consultar billing e créditos de IA
get_billing_statusRetorna o billing_plan e os ai_credits restantes do usuário autenticado, além da URL a ser compartilhada caso ele precise fazer upgrade ou recarregar créditos.
06
Health check
health_checkRetorna o status básico do processo MCP no backend. Útil para verificar a conectividade.