Compartilhar um agente de fluxo de trabalho

Acesso antecipado : agente de fluxo de trabalho

Este recurso está sujeito aos "Termos da Pré-GA" nos Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos Pré-lançamento de IA Generativa. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

Compartilhe os agentes de fluxo de trabalho que você criou e iniciou usando o Workflow Builder com outros usuários da sua organização.

Com o compartilhamento de agentes, é possível:

• Compartilhar agentes ativos com usuários e grupos na sua organização.
• Configurar programações de execução personalizadas ou acionadores baseados em eventos.
• Acompanhar execuções de prévia e execuções automatizadas.
• Duplicar agentes de fluxo de trabalho compartilhados para personalizar as etapas.

Dependendo das configurações de controle de recursos do app, talvez seja necessário que um administrador analise e aprove seu pedido antes de compartilhar um agente.

Atenção:ao compartilhar um agente, você também está compartilhando o acesso a todas as fontes de dados e arquivos associados a ele. Os usuários podem consultar o agente sobre o conteúdo dessas fontes, mesmo que não tenham acesso direto ao arquivo ou à fonte de dados.

Por exemplo, se você fizer o upload de um arquivo confidencial para a seção de conhecimento do agente e compartilhar o agente, qualquer usuário com acesso poderá fazer perguntas ao agente sobre o conteúdo desse arquivo.

Compartilhar um agente de fluxo de trabalho

Para compartilhar um agente de fluxo de trabalho, faça o seguinte:

App

1. Abra o app Gemini Enterprise e acesse a página Galeria de Agentes.

   A página Galeria de Agentes aparece mostrando todos os agentes pré-criados e personalizados.

2. Na seção Seus agentes, encontre o agente que você quer compartilhar.

   Observação: é possível compartilhar um agente que está no estado draft, mas outros usuários não podem executá-lo até que ele seja ativado.

3. No cabeçalho superior direito da tela do Workflow Builder, clique em Compartilhar.

4. Insira os endereços de e-mail dos usuários ou Grupos do Google com quem você quer compartilhar o agente.

   Observação: é possível compartilhar seu agente com endereços de e-mail de usuários individuais. O compartilhamento com Grupos do Google não está ativado para usuários finais. Um administrador do app Gemini Enterprise ou qualquer usuário com o papel de administrador do Discovery Engine (discoveryengine.admin) pode ativar o compartilhamento de grupos no nível do app Gemini Enterprise level.

5. Clique em Concluído.

   Observação: se o administrador do app tiver ativado a revisão do administrador para o compartilhamento de agentes, um pedido de compartilhamento será enviado ao administrador do app para análise e aprovação. Depois que o administrador do app aprovar o pedido, o agente será compartilhado com as pessoas na lista de acesso. Você pode editar o pedido de compartilhamento a qualquer momento para adicionar ou remover usuários ou cancelar o pedido.

Controle de revisão do administrador

Por padrão, os proprietários de agentes podem compartilhar seus agentes com qualquer usuário da organização sem a aprovação de um administrador do app. No entanto, os administradores do app podem mudar as configurações de controle de recursos do app para exigir a revisão e aprovação do administrador para o compartilhamento de agentes no app.

Por padrão, os proprietários de agentes não podem compartilhar seus agentes com grupos. No entanto, o administrador do app Gemini Enterprise pode escolher tornar os agentes compartilháveis com Grupos do Google, com ou sem a aprovação do administrador.

O processo de compartilhamento

Somente o compartilhamento inicial de um agente exige revisão e aprovação do administrador. As revisões subsequentes do agente não precisam de nova aprovação.

O compartilhamento de agentes segue um processo de duas etapas quando a revisão do administrador está ativada:

1. O proprietário do agente compartilha o agente com um ou mais usuários ou Grupos do Google.

2. O administrador do app analisa o pedido de compartilhamento e o aprova ou nega.

Analisar um pedido de compartilhamento

Os administradores do app são responsáveis por analisar e gerenciar pedidos de compartilhamento de agentes.

Observações:

• Esta seção só se aplica se o recurso Ativar o compartilhamento de agentes sem aprovação do administrador estiver desativado nos controles de recursos do app.
• Somente os administradores do app com o papel do IAM de administrador do Gemini Enterprise podem analisar e aprovar pedidos de compartilhamento.

Console

Para analisar um pedido de compartilhamento como administrador do app, faça o seguinte:

1. No Google Cloud console, acesse a página Gemini Enterprise > Apps.

   Gemini Enterprise

2. Clique no nome do app que contém o agente.

3. No menu de navegação do app, clique em Agentes.

4. Encontre o agente com uma ação Analisar pedido de compartilhamento na coluna Permissões do usuário.

   

5. Clique em Analisar pedido de compartilhamento.

6. No painel Pedido de compartilhamento:

   • Analise a lista de acesso em Compartilhamento solicitado com os seguintes usuários.
   • Opcional: modifique a lista de acesso para adicionar ou remover contas de usuário, Grupos do Google ou pools de identidade do WIF.

7. Para aprovar o pedido e conceder acesso, clique em Aprovar e ativar.

8. Para rejeitar o pedido, clique em Negar.

Usar um agente compartilhado

Quando um proprietário de agente compartilha um agente de fluxo de trabalho com você, é possível acessar e visualizar a configuração do gráfico. Embora o gráfico de fluxo de trabalho seja somente leitura para usuários compartilhados, você pode executar uma prévia manualmente, configurar suas próprias configurações de acionador, visualizar seu próprio histórico de execução, ou fazer uma cópia do agente.

App

1. Abra o app da Web do Gemini Enterprise em um navegador.
2. No menu de navegação do app da Web, clique em Agentes.
3. Acesse a seção Compartilhados comigo > Da sua organização.

4. Clique no agente de fluxo de trabalho compartilhado que você quer visualizar. O agente é iniciado em um layout de designer somente leitura, mostrando o gráfico de nós ativos. Observação: se o agente compartilhado estiver suspenso ou desativado, a tela do Workflow Builder não será renderizada, mas ainda será possível visualizar as execuções.

5. Opcional: para realizar uma execução de teste manual do fluxo de trabalho do agente:

   • Clique em Visualizar no cabeçalho superior direito da tela do Workflow Builder.
   • Execute a prévia. Se a execução de prévia falhar porque um conector usado pelo fluxo de trabalho não está autorizado, clique em Ativar conectores abaixo da mensagem de erro para concluir o fluxo do OAuth.

Configurar seus próprios acionadores

Os acionadores em um agente compartilhado são específicos do usuário. É possível configurar uma programação de execução personalizada ou filtros de eventos para executar um agente compartilhado automaticamente.

Para configurar seus próprios acionadores, faça o seguinte:

App

1. Abra o app da Web do Gemini Enterprise em um navegador.
2. No menu de navegação do app da Web, clique em Agentes > Galeria.
3. Acesse a seção Compartilhados comigo > Da sua organização e clique no agente de fluxo de trabalho compartilhado para o qual você quer configurar um acionador.

4. Acesse a configuração do acionador:

   • Selecione o menu Ações > Configurar acionadores.
   • Como alternativa, abra o agente de fluxo de trabalho na tela do editor do Workflow Builder, clique no título do agente e selecione Configurar acionadores.

5. É possível configurar um acionador usando um dos seguintes modos:

   • Programação:selecione Executar em uma programação e configure quando o agente será executado para você (como a frequência e o fuso horário).
   • Evento:selecione Executar em eventos do app e configure os filtros de eventos para especificar quando o agente será executado para você. Por exemplo, para um acionador de evento do Google Drive, é possível filtrar por campos como Proprietários (como um ID do Google, por exemplo, janedoe), Nome, Tipo MIME, Hora da modificação ou Pasta mãe. Selecione um operador (como contém ou é igual a), insira um valor e combine várias regras usando condições AND ou OR.

6. Se o fluxo de trabalho usar conectores que exigem autenticação (por exemplo, conectores usados em uma etapa do agente em vez do próprio acionador), ative e autorize os conectores no editor da tela do Workflow Builder quando solicitado.

7. Clique em Salvar. O acionador é salvo e executa o agente automaticamente. É possível acionar manualmente o agente para visualizar o que acontecerá quando a programação ou o acionador de eventos executar esse agente. Se você quiser que o agente pare de ser executado, selecione Não executar em eventos do app ou Não executar em uma programação na janela Configurar acionadores.

Visualizar suas execuções

Para visualizar suas execuções, faça o seguinte:

App

1. No menu de navegação do app da Web, clique em Agentes.
2. Acesse a seção Compartilhados comigo > Da sua organização e clique no agente de fluxo de trabalho compartilhado.
3. Na tela do Workflow Builder, clique na guia Execuções.
4. Clique em uma execução específica para visualizar os registros de execução e o rastreamento detalhado.

Para mais informações, consulte Execuções de agentes de fluxo de trabalho.

Fazer uma cópia de um agente de fluxo de trabalho compartilhado

Os agentes compartilhados são somente leitura para usuários compartilhados, exceto pelas configurações de acionador. Se você quiser editar e personalizar as etapas do fluxo de trabalho de um agente compartilhado, crie uma cópia no seu próprio espaço de trabalho.

Para criar um duplicado editável do agente compartilhado, faça o seguinte:

App

1. Abra o app da Web do Gemini Enterprise em um navegador.
2. No menu de navegação do app da Web, clique em Agentes > Galeria.
3. Acesse a seção Compartilhados comigo > Da sua organização e clique no agente de fluxo de trabalho compartilhado que você quer copiar.
4. Na tela do editor do Workflow Builder, clique no título do agente e selecione Fazer uma cópia. A cópia é adicionada à lista Seus agentes.

Dependências de agentes compartilhados

Se o agente importar e referenciar outros agentes (subagentes) nas etapas do fluxo de trabalho, tenha em mente o seguinte:

• Requisitos de acesso: ao compartilhar um agente pai ou importar um agente para o seu agente, verifique se todos os usuários na sua lista de acesso também têm acesso a todos os subagentes importados.
• Falhas de execução: se um usuário executar um agente sem acesso a um subagente importado, a execução falhará com uma mensagem pedindo que ele solicite acesso ao proprietário.

Considerações

• Se o proprietário do agente ativar uma nova versão ou atualizar a versão ativa do agente de fluxo de trabalho, todos os usuários compartilhados executarão automaticamente a nova versão ativa nas execuções subsequentes.

• Se um agente for desativado ou suspenso, a tela do Workflow Builder não será renderizada e os usuários compartilhados não poderão executar o agente, mas ainda poderão visualizar os históricos de execução anteriores e os registros de sessão na galeria Execuções. Se o agente for descompartilhado, desativado ou excluído, os usuários compartilhados perderão todo o acesso, incluindo os históricos de execução anteriores e os registros de sessão.

• As ações que modificam dados externos exigem a aprovação human-in-the-loop (HITL), exceto para e-mails ou eventos de agenda enviados a você mesmo.

A seguir

• Saiba como criar um agente de fluxo de trabalho.
• Saiba como editar um agente de fluxo de trabalho.
• Saiba como gerenciar versões de agentes de fluxo de trabalho.
• Saiba como monitorar execuções de agentes de fluxo de trabalho.