Pular para o conteúdo principal
Acessar Studio
Editor

Ações

Adicione ações ao agente para que ele possa interagir com serviços externos como Google, Microsoft 365 e Roberty.

Ações

A seção Ações permite adicionar ferramentas externas ao agente. Quando o agente recebe uma tarefa que exige interação com um serviço — enviar um e-mail, buscar um evento no calendário, acionar um robô RPA — ele utiliza as ações configuradas para concluir a tarefa.

Adicionar uma ação​

  1. Clique em Adicionar Ação na seção Ações do Editor.
  2. O catálogo de ações será aberto. No painel esquerdo, selecione a categoria desejada:
    • Google — Google Calendar, Gmail, Google Drive, Google Sheets
    • Microsoft 365 — Outlook Mail, Outlook Calendar, Outlook Contacts, Teams, SharePoint, Excel, Word, OneDrive
    • Roberty — Robô RPA, Chamada de API, MCP
  3. No painel direito, clique na ferramenta desejada.
  4. O painel de configuração da ação será aberto.

Configurar uma ação​

Ao selecionar uma ferramenta, o painel Nova Ação é exibido com dois grupos de campos:

Identificação​

  • Nome — nome da ação exibido no editor. Por padrão, preenchido com o nome da ferramenta.
  • Descrição — explica ao agente quando e como usar essa ação. Quanto mais precisa a descrição, melhor o agente decide quando acioná-la.

Configurações​

Campos específicos de cada ferramenta. Os tipos de campo mais comuns são:

  • Conexão — selecione a conexão de serviço configurada no workspace (ex.: conta Google, conta Microsoft).
  • Robô — selecione o robô RPA que será acionado.
  • Ações permitidas — checkboxes para habilitar ou desabilitar operações específicas da ferramenta (ex.: criar, editar, excluir).
  • Campos de texto ou número — parâmetros livres da ferramenta.

Clique em Salvar para confirmar.

Gerenciar ações existentes​

As ações adicionadas aparecem listadas na seção Ações. Para cada ação você pode:

  • Configurar — reabre o painel de configuração para editar nome, descrição e configurações.
  • Remover — remove a ação do agente. Uma confirmação será solicitada antes da exclusão.
informação

As ações disponíveis dependem das conexões configuradas no workspace. Se uma ferramenta exigir uma conexão e nenhuma estiver configurada, ela não aparecerá como opção ou não poderá ser salva. Consulte Conexões para saber como configurar.

Referência de ações​

Para ver os parâmetros detalhados de cada ferramenta, consulte o Catálogo de Ações: