Ajustar um modelo

Nesta página, mostramos como interagir com a Gemini Enterprise Agent Platform para ajustar um modelo usando o painel lateral no Colab Enterprise.

Para acessar Google Cloud serviços e APIs executando código no seu notebook do Colab Enterprise, use as credenciais associadas à sua Conta do Google. Para saber mais, consulte Acessar Google Cloud serviços e APIs.

O painel lateral é outra maneira de interagir com a Agent Platform para ajustar modelos sem sair da interface do Colab Enterprise.

O painel lateral aparece à direita de um notebook aberto.

Ajuste de modelos na Agent Platform

O ajuste de modelos é uma maneira eficaz de personalizar modelos grandes para suas tarefas. Essa é uma etapa fundamental para melhorar a qualidade e a eficiência do modelo. O ajuste de modelos oferece os seguintes benefícios:

  • Qualidade mais alta para suas tarefas específicas
  • Maior robustez de modelo
  • Menor latência e custo de inferência devido a comandos mais curtos

Para uma visão geral do ajuste de modelos da Agent Platform para Gemini, consulte Introdução ao ajuste.

Antes de começar

  1. Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

  2. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Agent Platform, Dataform, and Compute Engine 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

  5. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Agent Platform, Dataform, and Compute Engine 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

    8.

Funções exigidas

Para receber as permissões necessárias para usar o painel lateral em um notebook do Colab Enterprise, peça que o administrador conceda a você os seguintes papéis do IAM 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 usando personalizados papéis ou outros predefinidos papéis.

Ajustar um modelo

É possível ajustar um modelo na Agent Platform usando o painel lateral no Colab Enterprise.

  1. No Google Cloud console do, acesse a página Meus notebooks do Colab Enterprise.

    Acessar Meus notebooks

  2. No menu Região, selecione a região que contém o notebook.

  3. Clique no notebook que você quer abrir. Crie um notebook se ainda não tiver feito isso, crie um notebook.

  4. À direita do notebook, no painel lateral, clique no botão  Ajuste.

    O painel lateral expande a guia Ajuste.

  5. Clique no botão Ajustar um modelo do Gemini.

    O Colab Enterprise adiciona células de código ao notebook para ajustar um modelo do Gemini.

  6. No notebook, encontre a célula de código que armazena valores de parâmetro. Você vai usar esses parâmetros para interagir com a Agent Platform.

  7. Atualize os valores dos seguintes parâmetros:

    • PROJECT_ID: o ID do projeto em que o notebook está.
    • REGION: a região em que o notebook está.
    • TUNED_MODEL_DISPLAY_NAME: o nome do seu modelo ajustado.

  8. Na próxima célula de código, atualize os parâmetros de ajuste do modelo:

    • source_model: o modelo do Gemini que você quer usar, por exemplo, gemini-2.0-flash-001.
    • train_dataset: o URL do conjunto de dados de treinamento.
    • validation_dataset: o URL do conjunto de dados de validação.
    • Ajuste os parâmetros restantes conforme necessário.

  9. Execute as células de código que o painel lateral adicionou ao notebook.

  10. Depois que a última célula de código for executada, clique no botão  Ver job de ajuste que aparece.

  11. O painel lateral mostra informações sobre o job de ajuste do modelo.

    • A guia Monitorar mostra as métricas de ajuste quando as métricas estão prontas.
    • A guia Conjunto de dados mostra um resumo e as métricas sobre o seu conjunto de dados depois que ele é processado.
    • A guia Detalhes mostra informações sobre o job de ajuste, como o método de ajuste e o modelo de base (modelo de origem) que você usou.

  12. Depois que o job de ajuste for concluído, você poderá acessar diretamente a guia Detalhes do ajuste em uma página em que é possível testar o modelo. Clique em Testar.

    O Google Cloud console do é aberto na página Chat de texto da Agent Platform, em que é possível testar o modelo.

Ver detalhes de um job de ajuste

É possível conferir os detalhes de um job de ajuste, mesmo que você não tenha criado e executado o job de ajuste no Colab Enterprise. É possível conferir os detalhes de um job de ajuste usando o painel lateral no Colab Enterprise.

  1. No Google Cloud console do, acesse a página Meus notebooks do Colab Enterprise.

    Acessar Meus notebooks

  2. No menu Região, selecione a região que contém o notebook.

  3. Clique no notebook que você quer abrir. Crie um notebook se ainda não tiver feito isso, crie um notebook.

  4. À direita do notebook, no painel lateral, clique no botão  Ajuste.

    O painel lateral expande a guia Ajuste.

  5. Clique no botão Ver detalhes do job de ajuste.

    O Colab Enterprise adiciona células de código ao notebook para receber os detalhes de um job de ajuste.

  6. No notebook, encontre a célula de código que armazena valores de parâmetro. Você vai usar esses parâmetros para interagir com a Agent Platform.

  7. Atualize os valores dos seguintes parâmetros:

    • PROJECT_ID: o ID do projeto em que o notebook está.
    • REGION: a região em que o notebook está.
    • TUNING_JOB_ID: o ID do job de ajuste da Agent Platform.

  8. Execute as células de código que o painel lateral adicionou ao notebook.

  9. Depois que a última célula de código for executada, clique no botão  Ver job de ajuste que aparece.

  10. O painel lateral mostra informações sobre o job de ajuste do modelo.

    • A guia Monitorar mostra as métricas de ajuste quando as métricas estão prontas.
    • A guia Conjunto de dados mostra um resumo e as métricas sobre o seu conjunto de dados depois que ele é processado.
    • A guia Detalhes mostra informações sobre o job de ajuste, como o método de ajuste e o modelo de base (modelo de origem) que você usou.

A seguir