Visão geral do Workflows

Os fluxos de trabalho são agentes que você pode criar usando o Workflow Builder no seu app da Web do Gemini Enterprise. Esses agentes são projetados para executar uma sequência de etapas ou ações, que podem incluir uma combinação de automação com IA e intervenção humana, com base em um gatilho configurado. As respostas do fluxo de trabalho podem ser determinísticas ou não determinísticas, dependendo da lógica geral de orquestração do agente.

Workflows são ideais para os seguintes casos de uso:

• Processos de várias etapas com lógica de sequência definida. Por exemplo, automatizar uma lista de verificação de integração de funcionários em ferramentas como o Gmail e o Agenda.
• Tarefas com automação com IA e aprovações humanas. Por exemplo, elaborar um relatório com IA que exige a aprovação do usuário antes da publicação.
• Orquestrações complexas com lógica condicional. Por exemplo, rotear leads de vendas para equipes diferentes com base na região e no orçamento.

Os seguintes recursos estão disponíveis no Workflow Builder:

• Criar um fluxo de trabalho com linguagem natural: descreva seu fluxo de trabalho em linguagem simples e gere um scaffold de fluxo de trabalho automaticamente.
• Usar modelos de fluxo de trabalho: navegue e comece com modelos pré-criados para casos de uso comercial comuns.
• Configurar gatilhos de fluxo de trabalho: execute fluxos de trabalho automaticamente quando os dados mudarem nos conectores.
• Conectar conectores às etapas do agente: ative ferramentas de leitura e gravação (como Gmail, Jira e Google Drive) nas etapas do agente do Gemini para pesquisar dados, enviar mensagens e gerenciar registros.
• Use etapas de controle de fluxo: adicione ramificação condicional, filtragem de dados e loops ao fluxo de trabalho.
• Conectar servidores MCP: conecte servidores MCP como etapas de fluxo de trabalho ou como ferramentas para etapas do agente do Gemini.
• Use etapas de human-in-the-loop: adicione etapas de revisão humana, aprovação e solicitação de informações ao seu fluxo de trabalho.
• Adicionar agentes ao seu fluxo de trabalho: transfira tarefas para outros agentes de IA especializados no seu fluxo de trabalho.
• Gerenciar versões de fluxo de trabalho: salve, compartilhe, compare e restaure versões de fluxo de trabalho.
• Editar um fluxo de trabalho com linguagem natural: edite fluxos de trabalho descrevendo as mudanças em linguagem natural.
• Ver registros de execução do fluxo de trabalho: monitore as execuções do fluxo de trabalho com traces de execução etapa por etapa.
• Compartilhar um fluxo de trabalho: compartilhe fluxos de trabalho ativos com outros usuários na sua organização.

Conectores compatíveis

O Workflows é compatível com estes conectores:

• Gmail
• Google Agenda
• Google Chat
• Google Drive
• Confluence
• Confluence Data Center
• Jira
• Jira Data Center
• Microsoft Teams
• Notion
• OneDrive
• Outlook
• Salesforce
• SharePoint
• ServiceNow
• Slack

Antes de começar

Antes de conhecer esses novos recursos, faça o seguinte:

• Verifique se um administrador do Gemini Enterprise ativou o botão do Workflow Builder nas configurações de gerenciamento de recursos do app. Para mais informações, consulte Gerenciar recursos do app da Web.
• Verifique se você tem um app da Web do Gemini Enterprise com os repositórios de dados necessários conectados. Para mais informações, consulte Sobre apps e repositórios de dados.

Tela do fluxo de trabalho

O Workflow Builder oferece uma tela híbrida que combina a facilidade dos comandos de linguagem natural com o controle de um editor visual.

• Designer de conversação: acessível no início da criação do fluxo de trabalho e no editor visual, ele oferece uma interface de conversação para criar e refinar seu fluxo de trabalho usando comandos em linguagem natural. Isso é ideal para usuários que preferem uma experiência de desenvolvimento sem código e querem usar linguagem natural para criar fluxos de trabalho.

  • 
  • 

• Tela do editor: fornece uma representação visual do fluxo de trabalho. Ele fornece um fluxo lógico de nós que representam as etapas e as conexões entre eles. O editor visual é ideal para usuários que querem refinar a lógica do fluxo de trabalho, adicionar lógica condicional e fazer a integração com várias ferramentas e aplicativos.

  

  • Visualização: a guia de visualização mostra uma prévia em tempo real do fluxo de trabalho, permitindo que você execute simulações para testar o fluxo e fazer os ajustes necessários.

    

  • Execuções: a guia "Execuções" mostra uma lista de todas as execuções do fluxo de trabalho, incluindo a data e a hora de cada execução, o gatilho que iniciou a execução e o status atual dela.

    

Componentes do fluxo de trabalho

Um fluxo de trabalho consiste nos seguintes componentes:

• gatilhos
• Etapas
• Variáveis

Gatilhos

Gatilhos são eventos que iniciam a execução de um fluxo de trabalho. A tabela a seguir lista os gatilhos compatíveis com fluxos de trabalho:

Gatilho	Descrição	Campos de configuração
Acionador manual	Aciona a execução do fluxo de trabalho sob demanda. Para iniciar o fluxo de trabalho, os usuários podem digitar @ e o nome do fluxo de trabalho em um comando de chat do app Gemini Enterprise.	Campos de entrada: campos de entrada opcionais ou obrigatórios que os usuários podem preencher ao iniciar o fluxo de trabalho.
Programar gatilho	Aciona a execução do fluxo de trabalho em uma frequência especificada.	Frequência: a frequência com que o fluxo de trabalho é acionado. É possível especificar a frequência em minutos, horas, dias, semanas, meses ou usar uma expressão cron personalizada. Fuso horário: o fuso horário da frequência.
Gatilho de evento	Aciona a execução do fluxo de trabalho quando os dados mudam em um conector.	Conector: o aplicativo conectado que gera o evento. Filtro: os critérios que precisam ser atendidos para que o evento acione o fluxo de trabalho.

Observação: os gatilhos de evento definem a condição inicial de um fluxo de trabalho com base na atividade do conector externo (como o recebimento de um e-mail). Eles são configurados como acionadores de fluxo de trabalho e não aparecem como nós de etapa intermediária no fluxo da tela.

Etapas

As etapas são tarefas individuais que o fluxo de trabalho executa. Cada etapa é executada em sequência, e o resultado de cada etapa pode influenciar a próxima.

A tabela a seguir lista as etapas compatíveis, categorizadas pelo tipo de ação que elas realizam:

Categoria	Etapa	Descrição	Campos de configuração
Nós de agente	Agente do Gemini	Um agente com tecnologia de IA que pode ser configurado para ler, raciocinar e responder com base em instruções predefinidas.	Campos de entrada: Instruções: as instruções para o Agente do Gemini. Conhecimento: os arquivos ou recursos adicionais que o Agente do Gemini pode acessar para gerar respostas. Quando um repositório de dados do Google Drive ou do OneDrive é configurado, as opções Adicionar do Drive e Adicionar do OneDrive ficam disponíveis. Com essas opções, você pode selecionar arquivos ou pastas específicos, restringindo a pesquisa do agente apenas a esses recursos. A pesquisa é realizada em tempo real em cada execução do agente, então todas as mudanças nos arquivos de origem são refletidas imediatamente. Importante: se a ferramenta completa do Drive ou do OneDrive estiver ativada no mesmo nó do agente, ela terá precedência e concederá ao agente acesso irrestrito à pesquisa. A solução alternativa recomendada é usar dois nós Gemini Agent distintos. O primeiro nó deve usar o conhecimento restrito para pesquisa, e o segundo pode usar a ferramenta completa para outras funcionalidades, como escrever atualizações. Apps conectados: selecione quais conectores e ações o agente pode acessar no ambiente de execução. É possível selecionar ações de pesquisa de forma granular e ativar ou desativar ações de modificação de dados. Para mais informações, consulte Configurar conectores e ações de nós de agente. Modelo: o modelo do Gemini que o Agente do Gemini usa. Observação: apenas os modelos Gemini 3.0 e mais recentes são compatíveis. Campos de saída: A resposta do Agente do Gemini é capturada como uma variável que pode ser transmitida como entrada para as etapas seguintes do fluxo de trabalho. Formato de saída: é possível especificar a saída como texto simples ou em um formato JSON estruturado. Esquema JSON: ao usar a saída estruturada, é possível definir um esquema JSON manual para especificar o formato e os tipos de dados das variáveis de saída, garantindo um processamento de dados consistente em toda a orquestração.
Controle de fluxo	Condição	As condições são instruções lógicas que determinam como o fluxo de trabalho executa as etapas. Elas definem os critérios que precisam ser atendidos para que uma etapa seja executada e podem ser baseadas no resultado de etapas anteriores ou em fontes de dados externas.	Campos de entrada: Nome da ramificação: o nome da ramificação a ser executada se a condição for verdadeira. Variável: a variável a ser avaliada. É possível selecionar uma variável da saída das etapas anteriores. Operador: o operador (como `contains`, `equals`, `greater than`) a ser usado na avaliação. Valor: o valor a ser comparado com a variável. É possível especificar um valor estático ou selecionar uma variável da saída das etapas anteriores. + Condição: é possível adicionar outras condições usando operadores lógicos, como "AND" e "OR".
Human in the loop	Solicitar informações	Permite solicitar informações de um usuário humano.	Campos de entrada: Mensagem: a mensagem que será exibida para o usuário. É possível especificar uma mensagem estática ou selecionar uma variável da saída das etapas anteriores. Perguntas: as perguntas que serão feitas ao usuário. Você pode especificar o tipo de resposta que está solicitando (como resposta curta, parágrafo, data, e-mail, seleção única ou sim ou não). Campos de saída: As perguntas que o usuário respondeu.

Configurar conectores e ações de nós de agente

Ao configurar um nó do Agente do Gemini, é possível controlar quais conectores e ações o agente pode acessar no momento da execução. É possível restringir o agente a operações de pesquisa somente leitura ou ativar ações de write-back mutáveis.

Resumo: recursos de ação do nó do agente

Capacidade	Categoria de ação	Granularidade da seleção	Exemplo de caso de uso:
Pesquisa e consulta	Search For Data	Por ação (ativar ou desativar ações individuais)	Consultas amplas, busca de tíquetes, pesquisa em bases de conhecimento.
Modificação dos dados	Add Or Update Data	Nível do conector (alternância de tudo ou nada)	Criar tíquetes, atualizar o status de problemas, enviar e-mails.

Anexar e autorizar um conector

App

Para anexar um conector a um nó de agente, faça o seguinte:

1. Na tela do fluxo de trabalho, clique no nó Agente do Gemini para abrir o painel de configuração.
2. Em Apps conectados, localize o conector que você quer anexar (como Jira, Gmail ou Google Drive).
3. Mude a chave do conector para Ativado.
   • Se esta for a primeira vez que você ou sua organização usam o conector, conclua o fluxo de autorização do OAuth para conceder as permissões necessárias.
4. Clique na seta de expansão () ao lado do nome do conector para ativar as ações compatíveis com ele.

Selecionar categorias de ação

Cada conector organiza as ações em duas categorias distintas:

• Pesquisar dados: ações que pesquisam, consultam, listam ou recuperam registros do serviço conectado.
  • Seleção de ações detalhadas: clique no ícone Configurar () ao lado de Pesquisar dados para conferir todas as ações de pesquisa disponíveis (como Search Events, List Events ou List Calendars). É possível ativar ou desativar ações individuais de forma independente.
  • Filtros de pesquisa determinísticos: limite os escopos de pesquisa configurando filtros com menus suspensos estruturados ou expressões de consulta nativas, como a linguagem de consulta do Jira (JQL), a linguagem de consulta do Confluence (CQL), as consultas de pesquisa do Drive ou os operadores de pesquisa do Gmail.
  • Teste de consultas inline: valide suas consultas diretamente no painel de configuração para verificar se os filtros retornam os resultados esperados antes de executar o fluxo de trabalho.
• Adicionar ou atualizar dados: ações que criam, modificam, enviam ou excluem registros no aplicativo de destino (por exemplo, criar um problema do Jira ou enviar um e-mail).
  • Alternância no nível do conector: a alternância de ação mutativa opera no nível do conector. Ativar essa opção concede ao agente acesso a todas as operações de mutação compatíveis com esse conector.

Observação: a adição ou atualização de dados por conectores exige revisão humana. Se você ativar um conector, mas desativar todas as ações nas categorias Pesquisar dados e Adicionar ou atualizar dados, o agente não poderá interagir com o conector no ambiente de execução.

Requisito de dependência de ação

Atenção: as ações de mutação dependem de ações somente leitura e pesquisa para resolver identificadores de entidade no tempo de execução.

As ações de mutação geralmente exigem que o agente primeiro procure um identificador de registro (como um ID de problema, e-mail de contato ou ID de pasta) antes de realizar uma operação de atualização, criação ou exclusão.

Por exemplo, uma ação Atualizar problema do Jira exige que o agente primeiro consulte o Jira para receber o issue_id interno. Se as ações de mutação forem ativadas sem as ações de pesquisa correspondentes, o agente não poderá procurar os registros de destino necessários, o que causará erros de execução de ação no ambiente de execução (como ENTITY_NOT_FOUND ou erros de parâmetro ausente). Ao ativar ações de mutação, sempre ative as ações de pesquisa e recuperação compatíveis.

Exemplo: restringir um agente à pesquisa somente leitura do Jira

App

O exemplo a seguir mostra como configurar um nó do Agente do Gemini para pesquisar problemas do Jira sem permitir que o agente crie ou modifique problemas:

1. Na tela do fluxo de trabalho, clique no nó Agente do Gemini para abrir o painel de configuração.
2. Em Apps conectados, mude o Jira para Ativado (conclua a autorização OAuth se solicitado).
3. Clique na seta de expansão () ao lado de Jira.
4. Verifique se a opção Pesquisar dados está Ativada e mude Adicionar ou atualizar dados para Desativada.
5. Clique no ícone Configurar () ao lado de Pesquisar dados e verifique se apenas as ações de pesquisa somente leitura desejadas (como Pesquisar no Jira) estão ativadas.

Resolução de ações e precedência de ambiente de execução

Quando o fluxo de trabalho é executado, o Agente do Gemini seleciona e invoca ações com base nas seguintes regras de precedência:

Estado da configuração	Execução de ações no ambiente de execução
Pesquisa ativada	Expõe ações padrão de listagem e recuperação para todas as operações de pesquisa ativadas.
Ação de pesquisa individual desativada	A ação de pesquisa específica é omitida do catálogo de ações do agente.
Adicionar / Atualizar dados ativados	Expõe ações de mutação com as ações de pesquisa ativadas.
Adicionar / Atualizar dados desativados	Todas as ações de criação, atualização e exclusão de dados são bloqueadas para esse conector.

Variáveis

Variáveis são valores que podem ser transmitidos entre as etapas de um fluxo de trabalho. Esses valores são gerados como saída de etapas e podem ser usados como entrada para etapas subsequentes.

Versões do fluxo de trabalho

Ao criar um fluxo de trabalho, você pode salvá-lo como rascunho ou ativá-lo. Depois de ativar o fluxo de trabalho, é possível criar outras versões dele, além de salvar, comparar e restaurar essas versões. Ter várias versões de um fluxo de trabalho pode ser útil nos seguintes cenários:

• Você quer testar uma nova versão do fluxo de trabalho sem interromper a versão atual.
• Você quer reverter para uma versão anterior do fluxo de trabalho.

Para mais informações, consulte Gerenciar versões de fluxo de trabalho.

Problemas conhecidos

Veja a seguir os problemas e as limitações conhecidos dos fluxos de trabalho nesta versão:

• Suporte à linguagem natural
• Problemas de exibição do modelo de e-mail
• Confiabilidade da linguagem natural
• Falhas no carregamento da guia "Execuções"
• Os conectores não aparecem após a autorização
• Tempos limite de execução sob carga pesada
• Falha nas ações desativadas
• Recomendação de modelo
• Formatação do nó de aprovação

A seguir

• Saiba como criar um fluxo de trabalho com linguagem natural.
• Saiba como usar modelos de fluxo de trabalho.
• Saiba como configurar acionadores de eventos.
• Saiba como compartilhar um fluxo de trabalho.
• Saiba como gerenciar versões de fluxo de trabalho.