Execute execuções de blocos de notas com parâmetros

Execute execuções de blocos de notas com parâmetros

Os blocos de notas geridos do Vertex AI Workbench foram descontinuados. A 14 de abril de 2025, o apoio técnico dos blocos de notas geridos terminou e a capacidade de criar instâncias de blocos de notas geridos foi removida. As instâncias existentes vão continuar a funcionar até 30 de março de 2026, mas os patches, as atualizações e as atualizações não vão estar disponíveis. Para continuar a usar o Vertex AI Workbench, recomendamos que migre as suas instâncias de notebooks geridos para instâncias do Vertex AI Workbench.

As instâncias de blocos de notas geridos do Vertex AI Workbench permitem-lhe usar valores de parâmetros nas execuções do bloco de notas para especificar diferenças na forma como o código do ficheiro do bloco de notas é executado. Esta página descreve como configurar o ficheiro de bloco de notas para usar parâmetros e como executar execuções que especifiquem valores diferentes para os parâmetros do bloco de notas.

Use parâmetros para executar diferentes iterações do ficheiro de bloco de notas

Pode usar valores de parâmetros do bloco de notas nas suas execuções para executar o mesmo código do bloco de notas, especificando diferenças como as seguintes:

• Especifique um conjunto de dados diferente para usar ou um tamanho da amostra diferente do conjunto de dados.

• Especifique diferentes configurações do modelo, como a taxa de aprendizagem ou o tipo de otimizador.

• Executar modelos diferentes ou executar versões diferentes do mesmo modelo.

Como usar parâmetros na execução de um bloco de notas

O processo de execução de um bloco de notas com parâmetros tem dois passos principais:

1. Adicione a etiqueta parameters a uma das células do ficheiro do notebook. Embora não seja um requisito técnico, esta célula contém normalmente código que atribui valores às variáveis de parâmetros, embora não seja um requisito técnico. Se não atribuir valores de parâmetros diferentes na execução, a execução usa os valores de parâmetros no ficheiro do bloco de notas como valores predefinidos.

2. Crie uma execução para o ficheiro de bloco de notas que inclua novos valores para os parâmetros. Use o seguinte padrão para formatar os parâmetros e os respetivos valores: parameter1=value1,parameter2=value2. O formato requer vírgulas entre pares de parâmetro-valor, sem espaços e sem aspas. Quando a execução é realizada, o executor adiciona uma célula ao bloco de notas que atualiza os valores dos parâmetros diretamente após a célula etiquetada parameters.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Funções necessárias

Para garantir que a conta de serviço da sua instância tem as autorizações necessárias para interagir com o executor do Vertex AI Workbench, peça ao seu administrador para conceder à conta de serviço da sua instância as seguintes funções de IAM no projeto:

Importante: tem de conceder estas funções à conta de serviço da sua instância e não à sua conta de utilizador. Se não conceder as funções ao principal correto, podem ocorrer erros de autorização.
• Visualizador de blocos de notas (roles/notebooks.viewer)
• Utilizador do Vertex AI (roles/aiplatform.user)
• Administrador de armazenamento (roles/storage.admin)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

O administrador também pode conceder à conta de serviço da sua instância as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Abra o JupyterLab

Para abrir o JupyterLab e preparar um ficheiro de bloco de notas para execução, conclua os seguintes passos.

1. Abra o JupyterLab.

2. Carregue um ficheiro de notebook (ipynb), abra um ficheiro existente ou abra um novo ficheiro de notebook e adicione o código que quer executar ao novo notebook.

3. Certifique-se de que o código do ficheiro do bloco de notas cumpre os requisitos para usar o executor.

Adicione a etiqueta parameters a uma célula do notebook

1. Na interface do utilizador do JupyterLab da instância de blocos de notas geridos, abra o ficheiro de bloco de notas que quer executar.

2. Escreva código numa célula que atribua valores às variáveis de parâmetros. Estes são os valores que o ficheiro do bloco de notas usa se não atribuir valores de parâmetros diferentes na execução.

3. Certifique-se de que a célula de parâmetros ainda está selecionada e, em seguida, na barra lateral direita, clique no  Inspetor de propriedades.

4. No inspetor de propriedades, na secção Etiquetas de células, clique em Adicionar etiqueta, introduza parameters e, de seguida, prima Enter.

   Nota: se etiquetar mais do que uma célula com parameters, o executor adiciona apenas uma célula de parâmetros diretamente após a primeira célula com a etiqueta parameters.

Forneça valores de parâmetros para a sua execução

1. Na interface do utilizador do JupyterLab da instância de blocos de notas geridos, clique no botão Executor .

2. Na caixa de diálogo Enviar notebooks para o Executor, introduza um nome para a execução no campo Nome da execução.

3. Selecione um tipo de máquina e um tipo de acelerador.

4. Selecione um Ambiente.

5. No campo Tipo, selecione Execução única ou selecione Execuções recorrentes baseadas em agendamento e conclua a caixa de diálogo para agendar execuções.

6. Em Opções avançadas, selecione a Região onde quer executar o seu bloco de notas.

7. No campo Contentor do Cloud Storage, selecione um contentor do Cloud Storage disponível ou introduza um nome para um novo contentor e clique em Criar e selecionar. O executor armazena a saída do bloco de notas neste contentor do Cloud Storage.

8. Na secção Parametrização do bloco de notas e na caixa de texto Parâmetros de entrada, adicione parâmetros do bloco de notas separados por vírgulas, por exemplo optimizer=SGD,learning_rate=0.01. O formato requer que não existam espaços nem aspas.

9. Configure o resto da execução e, em seguida, clique em Enviar.

O que se segue?

• Saiba como executar código de bloco de notas no executor.