Visão geral

Neste laboratório, você vai aprender a inspecionar as classificações de segurança retornadas pela API Gemini da Agent Platform e a definir um limite de segurança para filtrar respostas.

Objetivos de aprendizagem

1. Chamar a API Gemini da Agent Platform e inspecionar as classificações de segurança das respostas
2. Definir um limite para filtrar as classificações de segurança de acordo com suas necessidades

Configuração e requisitos

Para cada laboratório, você recebe um novo projeto do Google Cloud e um conjunto de recursos por um determinado período sem custo financeiro.

1. Faça login no Google Skills usando uma janela anônima.

2. Confira o tempo de acesso do laboratório (por exemplo, 1:15:00) e finalize todas as atividades nesse prazo.
   Não é possível pausar o laboratório. Você pode reiniciar o desafio, mas vai precisar refazer todas as etapas.

3. Quando tudo estiver pronto, clique em Começar o laboratório.

4. Anote as credenciais (Nome de usuário e Senha). É com elas que você vai fazer login no Console do Google Cloud.

5. Clique em Abrir Console do Google.

6. Clique em Usar outra conta, depois copie e cole as credenciais deste laboratório nos locais indicados.
   Se você usar outras credenciais, vai receber mensagens de erro ou cobranças.

7. Aceite os termos e pule a página de recursos de recuperação.

Tarefa 1: iniciar a instância do Agent Platform Workbench

1. No console do Google Cloud, selecione o Menu de navegação () e, em seguida, Vertex AI > Painel.

2. Selecione Ativar todas as APIs recomendadas.

3. No menu de navegação, clique em Workbench.

   Verifique se você está na visualização Instâncias do topo da página do Workbench.

4. Clique em Criar.

5. Configure a instância:

   • Nome: lab-workbench
   • Região: configure a região como
   • Zona: configure a zona como
   • Opções avançadas (opcional): se necessário, clique em "Opções avançadas" para personalizar mais (ex.: tipo de máquina, tamanho do disco).

6. Clique em Criar.

O processo vai levar alguns minutos, e uma marca de seleção verde vai aparecer ao lado do nome da instância quando ela estiver pronta.

7. Clique em ABRIR O JUPYTERLAB ao lado do nome da instância para iniciar a interface do ambiente. Uma nova guia será aberta no navegador.

Clique em Verificar meu progresso para conferir o objetivo. Criar uma instância do Agent Platform Workbench

Tarefa 2: clonar um repositório do curso na sua instância do Agent Platform Workbench

Para clonar o notebook na sua instância do JupyterLab:

1. No JupyterLab, abra uma nova janela do terminal.

2. No prompt da linha de comando, execute o seguinte:

3. Para confirmar que você clonou o repositório, clique duas vezes no diretório asl-ml-immersion e veja se o conteúdo aparece. Os arquivos de todos os laboratórios com notebooks do Jupyter deste curso estão nesse diretório.

Clique em Verificar meu progresso para conferir o objetivo. Clone o repositório do curso na sua instância do Agent Platform Notebooks

Tarefa 3: proteger-se com a API Gemini

1. Na interface do notebook, navegue até asl-ml-immersion > asl_core > notebooks > responsible_ai > safety > solutions e abra gemini_safety_ratings.ipynb.

2. Na caixa de diálogo "Selecionar kernel", escolha Python 3 (Local), se solicitado.

3. Na interface do notebook, clique em Editar > Limpar saídas de todas as células.

4. Leia as instruções com cuidado e execute o notebook.

Dica: para executar a célula atual, clique nela e pressione SHIFT+ENTER. Confira outros comandos de células na interface do notebook em Run.

Finalize o laboratório

Após concluir o laboratório, clique em Terminar o laboratório. O Google Skills remove os recursos usados e limpa a conta para você.

Você poderá classificar sua experiência neste laboratório. Basta selecionar o número de estrelas, digitar um comentário e clicar em Enviar.

O número de estrelas indica o seguinte:

• 1 estrela = muito insatisfeito
• 2 estrelas = insatisfeito
• 3 estrelas = neutro
• 4 estrelas = satisfeito
• 5 estrelas = muito satisfeito

Feche a caixa de diálogo se não quiser enviar feedback.

Para enviar seu feedback, fazer sugestões ou correções, use a guia Suporte.

Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos podem ser marcas registradas das empresas a que estão associados.