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 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 de visualização ou entre em contato com o administrador do sistema.

Observação:esse recurso 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 podem ser gerenciados na página do Gerenciador de pré-lançamento público na plataforma Google SecOps.

Este documento descreve 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 novas ações fornecendo uma descrição em linguagem natural dos seus requisitos.

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 criação de comandos.
5. Clique em Gerar com o Gemini.
6. Revise 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 manualmente o código diretamente 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 dar instruções mais específicas e gere a ação novamente.
   • Descartar: saia da página ou selecione outro item. Uma caixa de diálogo de confirmação aparece 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 ação para usar em um playbook.
10. Defina a opção como Ativada 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 seu 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 documentação da API, exemplos de API ou exemplos de uso específicos no seu comando.
• Faça referência a recursos de integração atuais: você pode fazer referência a 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 respostas do Google Chronicle que combina várias funções atuais 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.