Gerenciar ações

É possível adicionar ações durante a criação do repositório de dados ou depois. Esta página mostra as etapas para adicionar novas ações após a criação do repositório de dados e gerenciar a lista de ações.

Adicionar ações

Console

Para adicionar novas ações ao repositório de dados, siga estas etapas:

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

   Gemini Enterprise

2. No menu de navegação, clique em Repositórios de dados.

3. Selecione um repositório de dados.

4. No menu de navegação, selecione Ações.

5. Na página Ações:

   1. Se as ações não foram adicionadas durante a criação do repositório de dados, clique em Ativar ações. Em seguida, na página Ativar ações, para adicionar novas ações, faça o seguinte:
      • Para um repositório de dados federado:
        1. Selecione as ações na lista.
        2. Clique em Ativar ações.
      • Para um repositório de dados de ingestão:
        1. Expanda a seção Configurações de autenticação e forneça os detalhes de autenticação.
           1. Clique em Login e faça login no repositório de dados para verificar sua conta.
           2. Clique em Continuar.
        2. Opcional: expanda as Configurações avançadas e forneça os detalhes necessários.
        3. Selecione as ações a serem ativadas.
        4. Clique em Ativar ações.
   2. Para adicionar outras ações à lista atual, faça o seguinte:
      1. Selecione as ações na lista.
      2. Clique em Ativar ações.

6. Para autenticar novamente usando credenciais diferentes das usadas para criar o repositório de dados, faça o seguinte:

   1. Clique em Reautenticar na página Ações.
   2. Informe os detalhes de autenticação.
   3. Clique em Login para autorizar o Gemini Enterprise a acessar o repositório de dados.
   4. Clique em Atualizar para atualizar os novos detalhes de autenticação.

7. Para visualizar ou editar os parâmetros do repositório de dados para ações, faça o seguinte:

   1. Clique em Visualizar/editar parâmetros para editar detalhes específicos do conector. Por exemplo, para Microsoft Outlook, SharePoint e OneDrive, forneça o ID do locatário.
   2. Clique em Salvar para atualizar os detalhes do parâmetro.

Ver ações

Console

Para visualizar a lista de ações de um repositório de dados, faça o seguinte:

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

   Gemini Enterprise

2. No menu de navegação, clique em Repositórios de dados.

3. Selecione o repositório de dados.

4. No menu de navegação, selecione Ações. As ações ativadas durante a criação do repositório de dados aparecem como uma tabela na página Ações.

Desativar ações

Console

Para desativar ações, faça o seguinte:

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

   Gemini Enterprise

2. No menu de navegação, clique em Repositórios de dados.

3. Selecione o repositório de dados.

4. Selecione Ações no menu de navegação.

5. Selecione as ações a serem desativadas na tabela.

6. Clique em Desativar ações.

Gerenciar ações personalizadas

Pré-lançamento privado:o recurso de ações personalizadas está em pré-lançamento privado. Você precisa estar na lista de permissões para usar esse recurso. Para ser adicionado à lista de permissões, entre em contato com a equipe de contas ou a equipe de vendas.

O Gemini Enterprise oferece suporte a campos e entidades personalizados para ativar a pesquisa e as ações avançadas em repositórios de dados. Depois de criar um repositório de dados, você pode recuperar as operações disponíveis na sua fonte de dados e selecionar quais delas serão expostas como ações. Para otimizar a performance, também é possível refinar as descrições de cada ação e dos campos dela para o modelo de IA.

É possível usar essas ações personalizadas além das ações padrão fornecidas pelo Gemini Enterprise. Para conferir as ações oferecidas por padrão, consulte Ações compatíveis.

É possível configurar ações e campos personalizados das seguintes maneiras:

• Entidades personalizadas:gere ações personalizadas das entidades personalizadas definidas no repositório de dados e refine as descrições de ações e campos.
• Campos personalizados:modifique as ações padrão atuais descrevendo como os campos personalizados precisam ser preenchidos.

Antes de começar

Verifique se as entidades e operações personalizadas estão configuradas e expostas pelas fontes de dados remotas de terceiros antes de tentar recarregar as ações no Google Cloud console.

Configurar ações personalizadas com base em entidades personalizadas

É possível gerar automaticamente um novo conjunto de ações personalizadas com base nas entidades personalizadas definidas no repositório de dados conectado.

Para gerar e ativar ações personalizadas:

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

   Gemini Enterprise

2. No menu de navegação, clique em Repositórios de dados.

3. Selecione um repositório de dados.

4. No menu de navegação, clique em Ações.

5. Na página Ações, clique em Recarregar ações personalizadas para gerar a lista de ações.

   Observação: na primeira vez que você realizar essa ação, talvez seja necessário concluir um fluxo de consentimento do OAuth. Isso concede as permissões necessárias para recuperar a lista de ações personalizadas disponíveis para sua conta de administrador.

6. Analise as ações personalizadas descobertas automaticamente na lista de ações. Por padrão, todas as ações recém-geradas são marcadas como Desativadas.

7. Selecione as ações personalizadas que você quer disponibilizar.

   **Observação**: é possível selecionar e ativar até 100 ações.

8. Clique em Ativar ações. O status é marcado como Ativado para as ações selecionadas.

9. Clique em Salvar.

10. Opcional: para melhorar a experiência do usuário, enriqueça as descrições de ações e campos na especificação:

    1. Na página Ações, selecione uma ação cuja especificação você quer modificar.
    2. Clique em Fazer o download da especificação para fazer o download do arquivo JSON de especificação.
    3. Abra o arquivo JSON transferido por download em um editor de texto e modifique as descrições e os tipos de dados no inputSchema. Por exemplo, é possível adicionar uma instrução como "Sempre usar 10 como padrão" a uma descrição de parâmetro.
    4. No Google Cloud console, clique em Fazer o upload da especificação para fazer o upload do arquivo JSON atualizado. O arquivo de especificação é validado para erros de sintaxe básicos.
    5. Clique em Salvar.

Configurar campos personalizados para ações padrão

Para alguns repositórios de dados, as ações padrão são fornecidas automaticamente, e o suporte a campos personalizados é ativado por padrão durante a criação do repositório de dados. No entanto, é possível definir explicitamente como o modelo precisa processar campos personalizados específicos modificando a especificação da ferramenta.

Para atualizar uma ação padrão com definições de campo personalizado:

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

   Gemini Enterprise

2. No menu de navegação, clique em Repositórios de dados.

3. Selecione um repositório de dados.

4. No menu de navegação, clique em Ações.

5. Clique em Gerenciar especificação.

6. Selecione a ferramenta ou ação padrão que você quer atualizar.

7. Clique em Fazer o download da especificação para fazer o download do arquivo JSON de especificação.

8. Abra o arquivo JSON transferido por download em um editor de texto e adicione as definições, descrições e tipos de dados de campo personalizados ao inputSchema.

9. No Google Cloud console, clique em Fazer o upload da especificação para fazer o upload do arquivo JSON atualizado. O arquivo de especificação é validado para erros de sintaxe básicos.

10. Clique em Salvar.

Limitações

Se o token de atualização expirar, a ativação de ações personalizadas poderá falhar com um erro, ou as ações poderão não aparecer como ativadas. Para resolver esse problema, recarregue a página Ações ou reautorize o app conectado para atualizar o token.