Consulte os conectores compatíveis com a integração de aplicativos.

Criar integrações com o Gemini Code Assist

O Gemini Code Assist é um colaborador com tecnologia de IA no Google Cloud que ajuda usuários de todos os níveis de habilidade, onde eles precisam. Na Application Integration, o Gemini Code Assist pode ajudar você a:

• Criar integrações
• Configurar tarefas de conector em uma integração
• Configurar tarefas da API REST de chamadas em uma integração
• Adicionar condições de borda e anexar outras tarefas a uma integração
• Configurar tarefas JavaScript
• Gerar descrição da integração

Para informações detalhadas sobre o Gemini para Google Cloud, consulte Visão geral do Gemini para Google Cloud .

Antes de começar

1. No console do Google Cloud , acesse a página Integração de aplicativos.
   

   Acessar o Application Integration

   A imagem a seguir mostra a página "Application Integration":

   

   1. Na seção Usar a IA para criar integrações, clique em Explorar.
   2. No painel Gemini na integração de aplicativos que aparece, clique em Ativar serviço para ativar a API Gemini para Google Cloud .

      Para informações sobre como ativar o Gemini Code Assist em um Google Cloud , consulte Configurar o Gemini Code Assist para um projeto.

2. Configure a Application Integration no seu projeto do Google Cloud . Para mais informações, consulte Configurar a integração de aplicativos.
3. Se você planeja criar uma integração usando conectores, configure as conexões desejadas no projeto do Google Cloud .
4. Se você planeja criar uma integração usando APIs do Apigee API Hub que estão em um projeto host, confira se você provisionou o API Hub no seu projeto e se a conta de serviço da Application Integration tem o papel necessário para acessar as APIs no outro projeto.

Observação:o Gemini oferece recomendações ou sugestões com base no conector e no hub de APIs para suas integrações usando as conexões configuradas em Conectores de integração e APIs no Hub de APIs do Apigee. Se você não tiver conexões ou APIs configuradas no projeto, o Gemini talvez não forneça recomendações ou sugestões baseadas em conectores e APIs.

Funções exigidas

• Para receber as permissões necessárias para usar o Gemini, peça ao administrador para conceder a você o papel do IAM de Usuário do Gemini para o Google Cloud (roles/cloudaicompanion.user) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

  Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

• Se você planeja criar uma integração com o Hub de APIs da Apigee, verifique se tem a função de leitor do hub de APIs do Cloud (roles/apigeeregistry.viewer) no projeto que contém as APIs.
• Se você planeja criar uma integração com os Conectores de integração, verifique se tem o papel de leitor de conectores (roles/connectors.viewer) no projeto.

Tarefas e gatilhos compatíveis

O Gemini pode ajudar você a adicionar as seguintes tarefas e acionadores:

gatilhos

Tarefas

Gatilho da API Gatilho do Cloud Pub/Sub Gatilho do Salesforce Jira Cloud ServiceNow Zendesk Gatilho do Cloud Scheduler

Tarefa de mapeamento de dados Tarefa "Aprovação" Suspender tarefa Tarefa do JavaScript Cloud Run functions Tarefa cronômetro Devolver tarefa Tarefa "Enviar e-mail" Tarefa do Conectores Tarefa "Chamar endpoint REST" Doc AI: tarefa de processo O Gemini também ajuda a criar as seguintes tarefas de fluxo de controle, mas não pode gerar subintegrações: Tarefa Para cada loop Tarefa "Para cada paralelo" Tarefa de repetição while Tarefa "Chamar integração"

Criar uma integração

O Gemini ajuda a criar integrações usando suas instruções de linguagem natural (ou comandos) como entrada. Assim, você pode criar integrações simples ou complexas rapidamente e com o mínimo de configurações manuais.

Forneça uma breve instrução ou descrição do fluxo de integração que você pretende criar. O Gemini vai sugerir um ou mais fluxos de integração para ajudar você a começar.

Para criar uma integração usando o Gemini, siga estas etapas:

1. No console do Google Cloud , acesse a página Integração de aplicativos.

   Acessar o Application Integration

2. Clique em spark Quero ajuda para criar. O painel Criar integração com o Gemini é exibido.

   Como alternativa, na página Criar integração, crie uma nova integração e, no editor de integração, clique em pen_spark Criar fluxos de integração com o Gemini para usar o Gemini.



1. Se quiser usar um modelo de comando, selecione um dos modelos de comando de exemplo. Caso contrário, insira um comando para o Gemini gerar integrações. Para saber como escrever comandos melhores, consulte Escrever comandos melhores.

   Por exemplo, suponha que você adicionou a seguinte solicitação: Criar uma integração que busca um problema do Jira e cria um tíquete do Zendesk.

2. Clique em Gerar.
   Observação:o Gemini sugere um ou mais fluxos de integração que qualificam seu comando:

   • Se você tiver ativado o API Hub e Integration Connectors e atendido a todos os pré-requisitos, as recomendações vão conter tarefas de Chamar endpoint REST e conectores.
   • Se você tiver um requisito de mapeamento de dados na integração, o Gemini também poderá sugerir uma tarefa de mapeamento de dados. Quando você confirma o comando, a tarefa de mapeamento de dados é substituída por uma tarefa JavaScript.

   O diagrama a seguir mostra o painel Criar uma integração com o Gemini com as sugestões fornecidas pelo Gemini:

   

   Use os botões Anterior e Próxima para conferir as sugestões.

3. Se você quiser modificar o nome da integração sugerida, atualize o campo Nome da integração.
   Observação:o nome da integração precisa ser exclusivo no projeto do Google Cloud .
4. Selecione uma região para a integração. Se o projeto tiver uma única região provisionada, o campo Região será definido como essa região.
   Observação:a lista Região mostra as regiões provisionadas no seu projeto do Google Cloud . Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para mais informações.
5. Se você quiser editar o comando, clique em Editar comando.
6. Para aceitar uma sugestão de fluxo de integração, clique em Confirmar. A Application Integration mostra o progresso das etapas para criar a integração. As integrações criadas usando o Gemini substituem todos os elementos e variáveis de integração atuais.

   

Recomendações contextuais

Você pode usar o Gemini para oferecer recomendações contextuais para suas integrações atuais. O Gemini pode ajudar você a fornecer recomendações de configuração de conector adequadas ao contexto com base no fluxo lógico da sua integração atual. Se uma conexão na sua integração tiver mais de mil entidades, esse conector não será incluído nas recomendações do Gemini. Para mais limitações, consulte Limitações.

Configurar tarefas do conector

O Gemini pode ajudar você a oferecer recomendações de configuração de conector adequadas ao contexto com base no fluxo lógico da sua integração atual. Se uma conexão na sua integração tiver mais de mil entidades, esse conector não será incluído nas recomendações do Gemini. Para mais limitações, consulte Limitações.

É possível configurar o conector com as substituições recomendadas pelo Gemini ou interagir com o Gemini (usando comandos) e pedir as sugestões de configuração desejadas.

Para configurar uma tarefa do conector na integração usando o Gemini, siga estas etapas:

1. No console do Google Cloud , acesse a página Integração de aplicativos.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece com todas as integrações disponíveis no projeto do Google Cloud .

3. Selecione uma integração para abrir no editor de integração.
4. Na barra de navegação, clique no botão Nova visualização de tela (pré-lançamento) para ativar. Em seguida, use a tela para criar o fluxo de trabalho de integração.
5. Para uma tarefa de conector, clique em Mais ações e em Configurar tarefa.

   Um menu pop-up semelhante à imagem a seguir aparece mostrando um conjunto de recomendações do Gemini.

   Observação:o Gemini pode recomendar a tarefa de conectores para tarefas de endpoint REST de chamada e vice-versa.

   

6. O Gemini recomenda automaticamente uma ou mais substituições ou alternativas relevantes para o fluxo lógico da sua integração. Você pode usar a entrada de comando para interagir com o Gemini e ajustar ou gerar novamente as recomendações sugeridas, se quiser.

7. Selecione uma das substituições ou modificações recomendadas para aceitar. O Gemini configura a tarefa do conector selecionada.

Configurar tarefas da API REST Chamar

Se você tiver ativado o API Hub no seu projeto, o Gemini na Application Integration poderá ajudar a fornecer recomendações de configuração de tarefas e tarefa de chamada de endpoint REST adequadas ao contexto com base no fluxo lógico da integração atual. Você pode usar essas recomendações para substituir ou modificar diretamente as tarefas atuais sem precisar passar por nenhum processo de configuração manual.

Você pode substituir diretamente uma tarefa ou uma configuração de tarefa com as substituições recomendadas pelo Gemini ou interagir com o Gemini (usando comandos) e pedir as sugestões de tarefa desejadas.

Depois de cumprir todos os pré-requisitos, siga estas etapas para substituir ou modificar uma tarefa na sua integração usando o Gemini:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração para abrir no editor de integração.
4. Na barra de navegação, clique no botão Nova visualização de tela (pré-lançamento) para ativar. Em seguida, use a tela para criar o fluxo de trabalho de integração.
5. Na tela do editor de integração, selecione a tarefa que você quer substituir ou modificar.
6. Clique em Mais ações e em Configurar tarefa.

   Um menu pop-up semelhante à imagem a seguir aparece mostrando um conjunto de recomendações do Gemini.

   Observação:o Gemini pode recomendar a tarefa de conectores para tarefas de endpoint REST de chamada e vice-versa.

   

7. O Gemini recomenda automaticamente uma ou mais substituições ou alternativas relevantes para o fluxo lógico da sua integração. Você pode usar a entrada de comando para interagir com o Gemini e ajustar ou gerar novamente as recomendações sugeridas, se quiser.

8. Basta selecionar uma das substituições ou modificações recomendadas para aceitar.

   O Gemini substitui ou modifica diretamente a tarefa selecionada sem configurações adicionais.

Adicionar condições de borda e anexar outras tarefas

Você pode usar o Gemini para anexar novas tarefas e adicionar condições de borda ao fluxo de integração atual.

Para adicionar uma condição de borda ou anexar novas tarefas à integração usando o Gemini, siga estas etapas:

1. No Google Cloud, acesse a página Integração de aplicativos.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece com todas as integrações disponíveis no projeto do Google Cloud .

3. Selecione uma integração para abrir no editor de integração.
4. Na barra de navegação, clique no botão Nova visualização de tela (pré-lançamento) para ativar. Em seguida, use a tela para criar o fluxo de trabalho de integração.
5. No editor de integração, selecione a borda em que você quer adicionar a condição de borda ou em que você quer anexar uma nova tarefa.
6. Clique em Mais ações e em Criar ramificação.

   Um menu pop-up semelhante à imagem a seguir vai aparecer para você fornecer uma entrada.

   

7. Digite o comando especificando a condição de borda que você quer adicionar ou a tarefa adicional que você quer anexar.

   Aqui está um exemplo de comando que você pode usar:

         If order qty>100, send an email

   Para saber como escrever comandos melhores, consulte Escrever comandos melhores.

8. Clique em pen_spark Criar.

O Gemini insere automaticamente as condições de borda qualificadas e configura as tarefas adicionais da borda selecionada na integração atual.

9. Clique em Confirmar para aceitar as inserções e adições sugeridas.

   Se você não gostar das inserções ou adições sugeridas, clique em Cancelar .

Configurar tarefas JavaScript

Você pode usar o Gemini para configurar tarefas JavaScript na integração. O Gemini pode ajudar você a fornecer recomendações de configuração de tarefas JavaScript apropriadas ao contexto com base no fluxo lógico da sua integração atual. Você pode usar essas recomendações para substituir ou modificar diretamente as tarefas atuais sem precisar passar por nenhum processo de configuração manual.

Adicionar uma tarefa em JavaScript

A tarefa JavaScript permite criar snippets de código JavaScript personalizados para sua integração. Para adicionar os snippets de código usando o Gemini, siga estas etapas:

1. No Google Cloud, acesse a página Integração de aplicativos.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece com todas as integrações disponíveis no projeto do Google Cloud .

3. Crie uma integração ou selecione uma integração para abri-la no editor de integração.
4. Clique e posicione o elemento JavaScript no editor de integração.
5. Clique no elemento JavaScript na tela para conferir o painel de configuração de tarefas JavaScript.
6. Clique em spark Script com o Gemini. O painel Script com Gemini é aberto. Em seguida, faça o seguinte:
   1. Se quiser usar um modelo de comando, selecione um dos modelos de comando de exemplo. Caso contrário, insira um comando para que o Gemini gere o código JavaScript. Para saber como escrever comandos melhores, consulte Escrever comandos melhores.

      Suponha que você queira processar um pedido de cliente. Sua integração contém as variáveis customer e item. Para criar um pedido, insira um comando semelhante ao seguinte:

      Create order using customer and items.
      

      

   2. Clique em Gerar.

      O Gemini sugere um ou mais snippets de código que qualificam seu comando. Use os botões Anterior e Próxima para conferir as sugestões.

   3. Para adicionar o snippet de código sugerido à tarefa JavaScript, clique em Confirmar. O snippet de código aparece no campo Editor JavaScript.

Editar uma tarefa em JavaScript

A tarefa JavaScript permite criar snippets de código JavaScript personalizados para sua integração. Para adicionar os snippets de código usando o Gemini, siga estas etapas:

1. No Google Cloud, acesse a página Integração de aplicativos.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece com todas as integrações disponíveis no projeto do Google Cloud .

3. Selecione uma integração que contenha a tarefa JavaScript.
4. Clique e posicione o elemento JavaScript no editor de integração.
5. Clique no elemento JavaScript na tela para conferir o painel de configuração de tarefas JavaScript.
6. Clique em Abrir editor de script. A página Editor de tarefas do JavaScript é exibida.
7. Clique em spark Usar o Gemini para editar e entender o script > Editar script. O painel Editar script com o Gemini é exibido. Em seguida, faça o seguinte:
   1. Se quiser usar um modelo de comando, selecione um dos modelos de comando de exemplo. Caso contrário, insira um comando para o Gemini gerar o código JavaScript. Para saber como escrever comandos melhores, consulte Escrever comandos melhores.

      Suponha que você queira fazer login no pedido quando o custo dele for maior que 100. Em seguida, insira um comando semelhante a este:

            Log in the order when the cost is greater than 100.
            

      

   2. Clique em Gerar.

      O Gemini sugere um ou mais snippets de código que qualificam seu comando. Use os botões Anterior e Próxima para conferir as sugestões.

   3. Para adicionar as atualizações sugeridas ao snippet de código na tarefa JavaScript, clique em Confirmar. O snippet de código atualizado aparece no campo Editor JavaScript.

Entender a tarefa em JavaScript

O Gemini pode ajudar a entender o snippet de código na tarefa JavaScript. Para fazer isso, siga estas etapas:

1. Na integração, clique no elemento JavaScript na tela para acessar o painel de configuração de tarefas JavaScript.
2. No painel de configuração da tarefa, clique em Abrir editor de script. O painel Editor de script vai aparecer. Em seguida, faça o seguinte:
   1. Clique em spark > info_spark Help me understand.

      Se você quiser entender uma parte do código, selecione a parte do snippet que você quer entender e clique em spark > info_spark Help me understand.

      O painel Gemini é exibido:

      

   2. No painel do Gemini, insira um comando para que o Gemini entenda o snippet de código. Para saber como escrever comandos melhores, consulte Escrever comandos melhores.

Gerar descrição da integração

O recurso de descrição de integração disponível no Gemini na Application Integration fornece um resumo da integração que você criou no editor de integração. O resumo da descrição da integração é gerado em linguagem simples e pode ajudar você a entender o caso de uso geral da integração, a orquestração subjacente e o contexto de negócios, que podem ser difíceis de avaliar devido à estrutura ou complexidade de uma integração.

Para gerar um resumo da descrição da integração usando o Gemini, siga estas etapas:

1. No console do Google Cloud , acesse a página Integração de aplicativos.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece com todas as integrações disponíveis no projeto do Google Cloud .

3. Selecione uma integração para abrir no editor de integração.
4. Na barra de ferramentas do editor de integração, clique em (Resumo da integração). A página de detalhes da integração vai aparecer.
5. Na página de detalhes da integração, clique em Ajuda com a descrição.

   O Gemini analisa a integração no editor de integração e gera uma descrição de resumo semelhante à imagem a seguir.

   

6. Clique em Concluído para aceitar a descrição da integração gerada.

   Verifique e valide a integração (incluindo as variáveis) antes de executá-la.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

Limitações

O Gemini no Application Integration está sujeito às seguintes limitações:

• Se a conexão na sua integração tiver mais de mil entidades, esse conector não será incluído nas recomendações do Gemini.
• Application Integration oferece suporte à residência de dados. As integrações criadas com o Gemini oferecem suporte à residência de dados. Não armazenamos dados, como comandos e respostas do Gemini. Apenas os dados em uso e em trânsito para geração usando o Gemini não têm suporte à residência de dados.

Gerar feedback

Você pode receber suporte ou enviar feedback contextual ao usar o Gemini para criar integrações. Essas informações nos ajudam a melhorar o Gemini.

A seguir

• Saiba como escrever comandos melhores.
• Saiba como testar e publicar uma integração.
• Saiba como o Gemini para o Google Cloud usa seus dados.
• Saiba mais sobre informações gerais do Gemini para o Google Cloud .