Gamma

Visão geral

Gamma é uma plataforma de criação de conteúdo com IA que permite gerar apresentações, documentos, páginas web e posts para redes sociais de forma rápida e visualmente atraente. Com a integração no SquadOS, seus agentes podem criar e personalizar conteúdo Gamma de forma programática, desde apresentações a partir de texto até documentos baseados em templates, sem abrir o editor manualmente.

• Site oficial: https://gamma.app/
• Documentação na Composio: docs.composio.dev/toolkits/gamma

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Chave de API da sua conta Gamma, obtida nas configurações de desenvolvedor.

Como obter a credencial

1. Acesse gamma.app e faça login na sua conta.
2. Clique no seu avatar no canto superior direito e vá em Settings (Configurações).
3. Navegue até a aba API ou Developer (Desenvolvedor).
4. Clique em Generate API Key (Gerar chave de API) e copie o valor gerado.

Dica

Guarde sua chave de API em local seguro. Ela dá acesso programático completo à sua conta Gamma para criar e gerenciar conteúdo.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Gamma.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Criar a partir de template

GAMMA_CREATE_FROM_TEMPLATE

Cria novo conteúdo Gamma com base em um template existente. Use quando precisar gerar conteúdo com estrutura ou layout predefinido, fornecendo instruções e prompt personalizados. A API cria o conteúdo de forma assíncrona: esta ação verifica o status da geração periodicamente e retorna a gammaUrl quando concluído, ou um generationId se o tempo limite de 2 minutos for atingido.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
prompt	string	Sim	Instruções de texto, URLs de imagens e orientações para adaptar o template. Suporta de 1 a 100.000 tokens. Pode incluir conteúdo a preencher no template e instruções específicas de personalização.
gammaId	string	Sim	Identificador único do template Gamma a usar como base para a geração de conteúdo. Determina a estrutura e o layout do conteúdo gerado.
themeId	string	Não	Identificador de tema obtido pela API Listar Temas. Use o campo id (ex.: chisel, alien, aurora), NÃO o campo name que contém nomes legíveis por humanos. Se não especificado, usa o tema padrão do template.
exportAs	string	Não	Formato de exportação adicional para o conteúdo gerado. Opções: pdf (documento estático) ou pptx (PowerPoint editável). Os links de download expiram após um período — faça o download imediatamente.
folderIds	array	Não	Array de IDs de pastas onde o gamma gerado será armazenado. Use a API Listar Pastas para obter os IDs disponíveis.
imageOptions	object	Não	Opções de geração de imagens para o conteúdo do template. Consulte: https://developers.gamma.app/docs/image-models
sharingOptions	object	Não	Opções de controle de acesso para o conteúdo gerado. Consulte: https://developers.gamma.app/docs/how-does-the-generations-api-work#sharingoptions

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Gerar um Gamma

GAMMA_GENERATE_GAMMA

Gera uma apresentação, documento, página web ou conteúdo para redes sociais no Gamma usando IA. A API cria o conteúdo de forma assíncrona — consulte o generationId retornado para verificar o status.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
format	string	Não	Tipo de saída. presentation (apresentação de slides), document (página/relatório contínuo), webpage (página web), social (posts para Instagram/TikTok/LinkedIn). Padrão: presentation.
themeId	string	Não	Identificador de tema visual que define paleta de cores e tipografia. Para usar o tema padrão, omita este campo — NÃO passe default como valor. Os IDs de tema não podem ser adivinhados — você DEVE recuperá-los usando a API Listar Temas primeiro. Temas padrão usam palavras em minúsculas (alien, aurora), hífens (default-dark, blue-steel) ou IDs alfanuméricos (ag4mc9ggtxi8iyi). Temas personalizados de workspace usam o prefixo theme_ (theme_abc123xyz). NÃO use palavras separadas por sublinhado como corporate_blue — são inválidos.
exportAs	string	Não	Formato de download adicional junto com a URL Gamma. pdf (documento estático) ou pptx (PowerPoint editável). Os links expiram após um período — faça o download imediatamente.
numCards	integer	Não	Número de cards a criar (quando cardSplit='auto'). Usuários Pro: 1–60; Ultra: 1–75. Padrão: 10.
textMode	string	Sim	Modo de transformação de conteúdo. generate (a IA expande entradas breves em conteúdo completo), condense (resume texto longo para caber nos slides), preserve (mantém o texto exato, adiciona estrutura).
cardSplit	string	Não	Lógica de divisão de cards. auto (a IA divide em numCards slides, ignora \n---\n), inputTextBreaks (divide em cada marcador \n---\n, ignora numCards). Padrão: auto.
folderIds	array	Não	Pasta(s) de destino para armazenar o gamma gerado. Recupere os IDs disponíveis usando a API Listar Pastas. É possível especificar múltiplas pastas.
inputText	string	Sim	Texto e URLs de imagens para gerar o gamma. Pode ser breve (poucas palavras) ou extenso (várias páginas). Limite de tokens: 100.000 (~400.000 caracteres). URLs de imagens podem ser incluídas onde devem aparecer. Use \n---\n para controlar as quebras de card.
cardOptions	object	Não	Opções de layout dos cards. Consulte: https://developers.gamma.app/docs/how-does-the-generations-api-work#cardoptions
textOptions	object	Não	Opções de geração de texto. Consulte: https://developers.gamma.app/docs/how-does-the-generations-api-work#textoptions
imageOptions	object	Não	Opções de imagem para geração do gamma. Consulte: https://developers.gamma.app/docs/how-does-the-generations-api-work#imageoptions
sharingOptions	object	Não	Opções de compartilhamento e controle de acesso. Consulte: https://developers.gamma.app/docs/generate-api-parameters-explained
additionalInstructions	string	Não	Especificações extras para conteúdo, layouts, etc. Limite de caracteres: 1–2000.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter URLs de arquivos do Gamma

GAMMA_GET_GAMMA_FILE_URLS

Recupera o status da geração e as URLs dos arquivos. Consulte este endpoint a cada ~5 segundos até que o status seja completed.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
generation_id	string	Sim	O generationId obtido no endpoint POST de gerações. Deve conter apenas letras e números (caracteres alfanuméricos).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar pastas

GAMMA_LIST_FOLDERS

Recupera uma lista paginada de pastas no seu workspace do Gamma. Use quando precisar dos IDs de pastas para organizar o conteúdo gerado ou para buscar pastas específicas pelo nome.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
after	string	Não	Token de cursor para buscar a próxima página. Use o valor nextCursor da resposta anterior. A paginação é somente para frente.
limit	integer	Não	Número de itens a retornar por página. Máximo: 50.
query	string	Não	Busca por nome (sem distinção de maiúsculas/minúsculas). Filtra os resultados para itens que correspondam ao termo de busca.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar temas

GAMMA_LIST_THEMES

Recupera a lista de temas disponíveis no seu workspace. Retorna tanto temas padrão (globais) quanto temas personalizados (específicos do workspace) em formato paginado. Use para descobrir IDs e nomes de temas disponíveis para uso com a API de geração. Filtre por nome usando o parâmetro query.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
after	string	Não	Token de cursor para paginação. Use o valor nextCursor da resposta anterior para buscar a próxima página.
limit	integer	Não	Número máximo de temas a retornar por página. Deve ser entre 1 e 50.
query	string	Não	Busca temas por nome. Filtra a lista para exibir apenas temas que correspondam a esta string de consulta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.