Configurar o Canvas

Nesta página, descrevemos como os administradores podem configurar e configurar o Canvas no Gemini Enterprise para os usuários.

O Canvas está em disponibilidade geral nas regiões global, dos EUA e da UE. Ele está disponível para usuários das edições Gemini Enterprise Business, Standard e Plus.

Antes de começar

A tela fica desativada por padrão. Você pode revisar e testar o Canvas antes de ativá-lo para os usuários.

Para ativar o Canvas para seus usuários, conclua a seguinte configuração:

• Ative a alternância de recursos
• Adicionar permissões do Canvas a uma função personalizada do IAM

Ativar o Canvas no app Gemini Enterprise

Para que os usuários acessem o recurso Canvas, um administrador do Gemini Enterprise precisa ativar a opção Ativar o Canvas nas configurações de gerenciamento de recursos do app da Web. Para mais informações, consulte Gerenciar recursos do app da web.

Adicionar permissões do Canvas a um papel personalizado do IAM

Confira se os usuários têm as permissões necessárias para o Canvas:

• Papéis predefinidos: os usuários que acessam o Gemini Enterprise com papéis padrão, como roles/discoveryengine.user, não precisam fazer mudanças, já que as permissões necessárias estão incluídas nos papéis predefinidos.

• Papéis personalizados: para usuários que acessam o Gemini Enterprise usando papéis personalizados do IAM, adicione as permissões immersiveArtifacts ao papel personalizado. Sem essas permissões, os usuários não podem usar o Canvas. O Canvas exige as seguintes permissões:

  • discoveryengine.immersiveArtifacts.create
  • discoveryengine.immersiveArtifacts.delete
  • discoveryengine.immersiveArtifacts.export
  • discoveryengine.immersiveArtifacts.get
  • discoveryengine.immersiveArtifacts.list
  • discoveryengine.immersiveArtifacts.navigate
  • discoveryengine.immersiveArtifacts.update

  Como as permissões necessárias para o Canvas estão em prévia, não é possível adicioná-las usando o console Google Cloud . Em vez disso, use a CLI gcloud. Por exemplo, para adicionar essas permissões a um papel personalizado para envolvidos no projeto, execute o seguinte comando:

  gcloud iam roles update ROLE_ID \
    --project=PROJECT_ID \
    --add-permissions=discoveryengine.immersiveArtifacts.create,discoveryengine.immersiveArtifacts.delete,discoveryengine.immersiveArtifacts.export,discoveryengine.immersiveArtifacts.get,discoveryengine.immersiveArtifacts.list,discoveryengine.immersiveArtifacts.navigate,discoveryengine.immersiveArtifacts.update
  

  Observação: como essas permissões estão em prévia, você vai receber um aviso esperado da CLI gcloud informando que elas estão na fase de lançamento alpha e podem ser instáveis para uso em papéis personalizados. Esse aviso é esperado e não impede que as permissões sejam aplicadas.

  Para mais informações sobre como gerenciar papéis do IAM do Gemini Enterprise, consulte Controle de acesso com o IAM.

Limitações

A tela não está disponível no app para dispositivos móveis, apenas no app da Web.

Consumo de cota

As consultas do Canvas e as consultas de chat regulares do app Gemini Enterprise são contadas da mesma forma e compartilham a mesma cota.

O app Gemini Enterprise mostra a mensagem de erro Limite de uso atingido quando você conversa com o assistente ou usa os recursos do Gemini Enterprise em qualquer um dos seguintes cenários:

• Seu projeto atingiu o limite mensal de gastos.
• Seu projeto exceder o limite de cota agrupada para um recurso específico e o administrador do Gemini Enterprise não tiver ativado os excedentes.

Esse erro afeta apenas o recurso que atingiu o limite. Você pode continuar usando outros recursos que têm cota restante.