O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Personalizar e implantar um modelo do Google

Os modelos fornecidos pelo Google no Application Design Center permitem que você comece com arquiteturas pré-configuradas que seguem as práticas recomendadas do Google Cloud . Neste guia de início rápido, você vai copiar o modelo RAG de IA generativa com Cloud SQL, personalizar os componentes dele e implantar um aplicativo de teste usando etapas que se aplicam a qualquer modelo.

A imagem a seguir mostra os componentes e as conexões do modelo de RAG de IA generativa com o Cloud SQL na tela de design:

Um aplicativo de RAG de IA generativa na tela de design.

Antes de começar

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.
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.
Configure o App Design Center no seu projeto.

Funções exigidas

Peça ao administrador para conceder a você os papéis listados na tabela a seguir:

Tarefa	Funções exigidas
Copiar, criar e editar modelos	Administrador do Application Design Center (`roles/designcenter.admin`) ou Usuário do Application Design Center (`roles/designcenter.user`)
Implantar aplicativos e configurações	Administrador do aplicativo (`roles/designcenter.applicationAdmin`) ou Editor do aplicativo (`roles/designcenter.applicationEditor`)
Criar contas de serviço durante a implantação	Criar contas de serviço (`roles/iam.serviceAccountCreator`) no projeto
Conceder acesso à conta de serviço ao seu projeto	Administrador do IAM do projeto (`roles/resourcemanager.projectIamAdmin`) no projeto

Para mais informações sobre papéis, consulte Controle de acesso com o IAM.

Prepare o ambiente

Use uma das opções a seguir para concluir este guia de início rápido.

Use a tela de design no console do Google Cloud .

Instale a CLI do Google Cloud.

Observação: se você já instalou a CLI gcloud, execute gcloud components update para verificar se você tem a versão mais recente.
Configure a CLI gcloud para usar sua identidade federada.

Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.
Para inicializar a CLI gcloud, execute o seguinte comando:
```
gcloud init
```

Copiar o modelo e criar um rascunho de aplicativo

Copie o modelo do Google e configure um rascunho de aplicativo.

Tela de design

No console do Google Cloud , acesse a página Modelos do Google.

Acessar os modelos do Google
Clique em Visualizar e personalizar no card de modelo RAG de IA generativa com Cloud SQL.

O modelo é aberto na tela de design.
Clique em Duplicar e personalizar.
Na caixa de diálogo Criar um novo modelo, insira os seguintes detalhes:
1. Preencha o campo Código do modelo com quickstart-custom-gen-ai-rag.
2. No campo Nome do modelo, insira Quickstart custom Generative AI RAG.
3. No campo Descrição, use A custom template copied from the Generative AI RAG with Cloud SQL template..
4. Clique em Criar modelo.
O modelo é copiado para seu espaço e exibido na tela de design.
Na tela de design, clique em Configurar um app.
Clique em Criar aplicativo e insira os seguintes detalhes:
1. No campo Nome, use quickstart-custom-gen-ai-rag-test.
2. No campo Nome de exibição, insira Quickstart custom Generative AI RAG test.
3. Na lista Região, selecione us-central1 (Iowa).
4. Na lista Ambiente, selecione Test.
5. Na lista Gravidade, selecione Low.
Clique em Criar aplicativo.

O sistema cria o rascunho do aplicativo.

CLI da gcloud

Filtre os modelos compartilhados no catálogo do Google para encontrar o URI de revisão do modelo gen-ai-rag-with-sql.
```
gcloud design-center spaces shared-templates list \
  --google-catalog \
  --location=LOCATION \
  --filter="displayName:gen-ai-rag-cloud-sql"
```
Substitua:
- LOCATION: o local do espaço. Por exemplo, us-central1.
Identifique o URI da revisão na saída.

Crie um rascunho de aplicativo com base nessa revisão de modelo.

gcloud design-center spaces applications create quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT \
  --source-shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI \
  --display-name="Quickstart custom Generative AI RAG test" \
  --environment-type=test \
  --criticality-type=low \
  --scope-type=regional \
  --deployment-region=LOCATION

Substitua:

SPACE: o ID do espaço. Por exemplo, default-space.
PROJECT: o ID do projeto.
SHARED_TEMPLATE_REVISION_URI: o URI de revisão do modelo. Por exemplo, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/sharedTemplates/f8ddfbd3-6393-4a1e-942c-aaa7292fa30c/revisions/r-28.

Configurar componentes

Configure os parâmetros de componente necessários no rascunho do aplicativo. Para mais informações sobre parâmetros de componentes, consulte Recursos compatíveis.

Tela de design

Na tela de design, clique em frontend-service e faça o seguinte na área Configuração:
1. No campo Nome do serviço, insira custom-rag-frontend.
2. Clique em Salvar.
Na tela de design, clique em retrieval-service e faça o seguinte na área Configuração:
1. No campo Nome do serviço, insira custom-retrieval-service.
2. Clique em Salvar.
Na tela de design, clique em database-postgresql e faça o seguinte na área Configuração:
1. No campo Nome, use custom-rag-database.
2. Clique em Salvar.
Na tela de design, clique em vertex-ai e faça o seguinte na área Configuração:
1. Na lista ID do projeto, verifique se o projeto está selecionado.
2. Clique em Salvar.
Na tela de design, clique em secret-manager e faça o seguinte na área Configuração:
1. No campo Nome, use db-ai-secret.
2. Clique em Salvar.

A tela mostra uma marca de seleção verde em cada componente para indicar que todos os parâmetros necessários foram configurados.

CLI da gcloud

Descreva o aplicativo para identificar os parâmetros do componente.

gcloud design-center spaces applications describe quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT \
  --format='yaml(name,componentParameters)'

A saída mostra os parâmetros de cada componente.

Receba uma lista de URIs de componentes.

gcloud design-center spaces applications describe quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT \
  --format='value(serializedApplicationTemplate.components.uri)'

Crie arquivos JSON de configuração no diretório de trabalho.

Criar custom-frontend.json.

{
   "component": "FRONTEND_COMPONENT_URI",
   "parameters": [
      {
         "key": "service_name",
         "value": "custom-rag-frontend"
      },
      {
         "key": "PROJECT",
         "value": "PROJECT"
      },
      {
         "key": "location",
         "value": "LOCATION"
      }
   ]
}

Criar custom-retrieval.json.

{
   "component": "RETRIEVAL_COMPONENT_URI",
   "parameters": [
      {
         "key": "service_name",
         "value": "custom-retrieval-service"
      },
      {
         "key": "project_id",
         "value": "PROJECT"
      },
      {
         "key": "location",
         "value": "LOCATION"
      }
   ]
}

Criar custom-database.json.

{
   "component": "DATABASE_COMPONENT_URI",
   "parameters": [
      {
         "key": "name",
         "value": "custom-rag-database"
      },
      {
         "key": "project_id",
         "value": "PROJECT"
      },
      {
         "key": "database_version",
         "value": "POSTGRES_15"
      },
      {
         "key": "region",
         "value": "us-central1"
      },
      {
         "key": "zone",
         "value": "us-central1-a"
      }
   ]
}

Criar custom-secmanager.json.

{
"component": "SECRET_MANAGER_COMPONENT_URI",
"parameters": [
   {
      "key": "name",
      "value": "db-ai-secret"
   },
   {
      "key": "project_id",
      "value": "PROJECT"
   }
]
}

Criar custom-vertex.json.

{
"component": "VERTEX_AI_COMPONENT_URI",
"parameters": [
   {
      "key": "project_id",
      "value": "PROJECT"
   }
]
}

Substitua:

FRONTEND_COMPONENT_URI: o URI do componente de front-end. Por exemplo, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/frontend-service.
RETRIEVAL_COMPONENT_URI: o URI do componente de recuperação. Por exemplo, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/retrieval-service.
DATABASE_COMPONENT_URI: o URI do componente do banco de dados. Por exemplo, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/database-postgresql
SECRET_MANAGER_COMPONENT_URI: o URI do componente do Secret Manager. Por exemplo, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/secret-manager.
VERTEX_AI_COMPONENT_URI: o URI do componente da Vertex AI. Por exemplo, projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/applicationTemplates/gen-ai-rag-cloud-sql/components/vertex-ai.
PROJECT: o ID do projeto.

Atualize a configuração do aplicativo com os arquivos de parâmetro JSON.

gcloud design-center spaces applications update quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT \
  --component-parameters=./custom-frontend.json \
  --component-parameters=./custom-retrieval.json \
  --component-parameters=./custom-database.json \
  --component-parameters=./custom-secmanager.json \
  --component-parameters=./custom-vertex.json

Implantar o aplicativo

Implante o aplicativo configurado.

Tela de design

Clique em Implantar.
Na área Selecionar conta de serviço, faça o seguinte:
1. Selecione Criar uma nova conta de serviço.
2. Clique em Proceed.
Clique em Implantar.

Após alguns minutos, o aplicativo é implantado e os recursos são criados.

CLI da gcloud

Visualizar a implantação e criar automaticamente uma conta de serviço de pré-lançamento.

gcloud design-center spaces applications preview quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT \
  --create-sa

Implante o aplicativo e crie automaticamente uma conta de serviço de implantação.

gcloud design-center spaces applications deploy quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT \
  --create-sa \
  --async

Copie o ID da operação.

Acompanhe o status da implantação.

gcloud design-center operations describe operation-OPERATION_ID \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT

Substitua:

OPERATION_ID: o ID da operação.

Opcional: monitorar a implantação

Depois de implantar o aplicativo, é possível visualizar a telemetria e monitorar o desempenho:

No console do Google Cloud , acesse a página Monitoramento de aplicativos:
Acesse Monitoramento de aplicativos.

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
Na coluna Nome, clique no aplicativo que você implantou.

A página mostra informações de monitoramento do aplicativo e dos serviços e cargas de trabalho dele.
Analisar painéis predefinidos. Para mais informações, consulte Visão geral do monitoramento de aplicativos.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, exclua o projeto do Google Cloud e os recursos.

Excluir o aplicativo implantado

Tela de design

No menu de navegação, clique em Aplicativos.

Acesse Aplicativos
Clique em Guia de início rápido: teste personalizado de RAG de IA generativa.
Clique em Ações e selecione Excluir aplicativo.
No campo Excluir, insira quickstart-custom-gen-ai-rag-test.
Clique em Excluir.

CLI da gcloud

Exclua o aplicativo usando a CLI.

gcloud design-center spaces applications delete quickstart-custom-gen-ai-rag-test \
  --space=SPACE \
  --location=LOCATION \
  --project=PROJECT

Excluir o projeto

No console Google Cloud , acesse a página Gerenciar recursos.
Acessar "Gerenciar recursos"
Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir.
No prompt, digite o ID do projeto e clique em Encerrar.

A seguir

Confira os principais conceitos e benefícios na visão geral do App Design Center.
Comece a usar arquiteturas pré-configuradas criando com base em modelos do Google.
Defina suas próprias configurações criando modelos de aplicativo.