Criar ações com o Gemini no ambiente de desenvolvimento integrado

Compatível com:

Google SecOps SOAR

Observação: esse recurso é coberto pelos Termos de produtos e recursos em pré-GA dos Termos específicos de serviço do Google Security Operations. Os recursos pré-GA podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as diretrizes do serviço de suporte técnico do Google SecOps e os Termos específicos de serviço do Google SecOps.
Se esse recurso não estiver visível no seu ambiente, consulte Gerenciar recursos em fase de pré-lançamento ou entre em contato com o administrador do sistema.

Observação:esse recurso está em pré-lançamento particular e não está disponível para todos os clientes em todas as regiões. Os recursos em fase de pré-lançamento particular não são gerenciáveis na página do Gerenciador de Pré-lançamento Público na plataforma do Google SecOps.

Neste documento, descrevemos como usar o Gemini para gerar código Python personalizado para ações de resposta no ambiente de desenvolvimento integrado (IDE) do Google SecOps. Com esse recurso, você pode criar ações descrevendo o que precisa em linguagem natural.

Observação:só é possível usar esse recurso para criar ações em integrações existentes. Não é possível gerar novas ações para novas integrações.

Criar uma ação com o Gemini

1. No menu de navegação do Google SecOps, acesse Resposta > IDE.
2. No ambiente de desenvolvimento integrado, selecione uma integração e abra o menu Criar nova ação.
3. Clique em Gerar ação com o Gemini.
4. Na caixa de diálogo Gerar ação, faça o seguinte:
1. Escolha uma integração na lista Integração.
2. Insira um comando detalhado no campo Inserir comando.
Observação:para mais informações sobre como gerar os melhores resultados com comandos, consulte Práticas recomendadas para comandos.
5. Clique em Gerar com o Gemini.
6. Analise a tela de prévia, que mostra o comando inserido, uma descrição da ação proposta e detalhes sobre as entradas e saídas.
7. Clique em Proceed.
8. No editor que aparece, revise o código gerado. Dependendo dos resultados, escolha uma das seguintes opções:
   • Aceitar: se o código atender aos seus requisitos, clique em Salvar.
   • Modificar: edite o código manualmente no editor para refinar a lógica e clique em Salvar.
   • Iterar: se o código exigir mudanças significativas, volte ao campo de comando para fornecer instruções mais específicas e gerar a ação novamente.
   • Descartar: saia da página ou selecione outro item. Uma caixa de diálogo de confirmação vai aparecer para garantir que você quer sair sem salvar o código gerado.
9. Configure as especificações técnicas da ação, incluindo as configurações de Tempo limite, Parâmetros e Resultado JSON. Para mais informações, consulte Criar uma nova ação para ser usada em um playbook.
10. Defina o botão como Ativado e clique em Salvar.

A ação agora está disponível para uso em Playbook > Ações.

Práticas recomendadas para comandos

Para receber o código mais preciso e utilizável do Gemini, siga estas práticas recomendadas ao escrever seu comando:

• Sugira nomes e parâmetros específicos: sugira explicitamente o nome da ação e os parâmetros que ela deve incluir.
• Foco em endpoints únicos: para melhores resultados, use comandos para ações síncronas que interagem com um único endpoint de API.
• Defina a estrutura JSON: sugira a estrutura adequada para os resultados JSON para garantir que o código esteja alinhado aos requisitos do playbook.
• Mantenha o código em um único módulo: peça que todo o código da ação seja escrito em um único módulo para ajudar na revisão e na implementação.
• Inclua documentação e exemplos: adicione links para a documentação da API, exemplos de API ou exemplos de uso específicos no comando.
• Referenciar recursos de integração atuais: é possível referenciar outros scripts da mesma integração para orientar a lógica e o estilo de geração.

Exemplo de caso de uso:

Use o comando a seguir para gerar uma nova ação na integração de resposta do Google Chronicle que combina várias funções em uma única ação personalizada:

Create an action that combines the case tag action and case priority action. 
It should accept the same parameters as each original action and perform the 
same logic based on those parameters. Ensure the action returns a JSON result 
of the affected case in the following format:

{
  "case": case_id,
  "case_tag": tag,
  "priority": priority
}

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.