Configurar preços configuráveis para a pesquisa personalizada

A Pesquisa de agentes oferece dois modelos de preços para a pesquisa personalizada: um modelo geral baseado no consumo e um modelo de preços configurável.

Nesta página, descrevemos os modelos de preços e como ativar um modelo configurável.

Observação: o preço configurável só se aplica a apps e repositórios de dados do Agent Search. Se você estiver criando um repositório de dados para usar com um app Gemini Enterprise, selecione o modelo Sistema de preços geral. Para saber como selecionar o preço geral, consulte Ativar o preço configurável para um repositório de dados.

Modelos de preços

O Agent Search para pesquisa personalizada oferece suporte a dois modelos de preços:

• Geral: um modelo de pagamento por uso baseado no consumo (padrão).

• Configurável: um modelo de preços mistos que permite desagrupar recursos e criar um pacote de assinatura mais alinhado aos seus casos de uso específicos. Com esse modelo de preços, você paga apenas pelos recursos de que precisa. Ele oferece duas assinaturas e complementos opcionais. Depois de ativar esse modelo de preços no nível do projeto, você pode selecionar preços configuráveis para seus apps e repositórios de dados.

Antes de ativar os preços configuráveis, saiba o seguinte:

• O faturamento do pacote de assinatura começa imediatamente após a ativação.
• É necessário inscrever individualmente cada app e repositório de dados que você quer incluir na assinatura. Os recursos não inscritos são cobrados com a tarifa padrão de pagamento por uso.
• Se você criar um repositório de dados do Gemini Enterprise no console de aplicativos de IA, selecione o modelo de preços geral para receber a cobrança correta.

Componentes de preços configuráveis

O modelo de preços configurável oferece duas assinaturas e diferentes complementos de recursos.

Pacote de assinatura

O pacote de assinatura tem duas assinaturas:

• Armazenamento do seu índice, medido em GiB, para dados estruturados, não estruturados e de sites.
• Consulta de pesquisa para recursos padrão de pesquisa e filtragem de palavras-chave, medida em QPM (consultas por minuto).

Cálculo de uso

O tamanho do armazenamento dos repositórios de dados em que os preços configuráveis se aplicam é somado e comparado ao limite da assinatura de armazenamento. Se o uso por hora for maior que o limite definido, a parte excedente será cobrada de acordo com o modelo geral de preços.

Da mesma forma, as unidades de consulta de pesquisa (QPM) dos apps em que os preços configuráveis se aplicam são somadas e comparadas ao limite de QPM da assinatura. Se o uso por minuto for maior que o limite definido, a parte excedente será cobrada de acordo com o modelo geral de preços.

Quando o limite é modificado, o uso é comparado ao novo limite para excedente.

Complementos de recursos

Você pode ativar recursos avançados usando complementos.

Complemento de armazenamento

Para o complemento de incorporação semântica, o faturamento ocorre quando os documentos são importados para o repositório de dados.

Complemento	Descrição
Incorporação semântica	Permite a criação e manutenção dos embeddings de vetor dos seus documentos, o que é necessário antes de usar o complemento de consulta semântica nas suas consultas de pesquisa.

Complementos de solicitação de pesquisa

O faturamento desses complementos ocorre quando esses recursos são aplicados a uma chamada de API search.

Importante: os complementos de solicitação de pesquisa são aplicados por padrão sempre que são relevantes para uma solicitação. Por exemplo, o complemento de consulta semântica é aplicado automaticamente quando os pré-requisitos são atendidos (o complemento de incorporação semântica está ativado no repositório de dados ou os embeddings estão disponíveis), mesmo que você não o solicite explicitamente. Quando o preço configurável está ativado, cada complemento aplicado a uma solicitação é faturado pela SKU correspondente. Para evitar cobranças por um complemento que você não quer, é necessário desativá-lo explicitamente. Consulte Como controlar quais complementos se aplicam a uma solicitação de pesquisa.

Complemento	Descrição
Consulta semântica	Ativa recursos de pesquisa semântica para processar consultas mais longas e complexas usando embeddings. O complemento de incorporação semântica no nível do repositório de dados é um pré-requisito. Aplicado por padrão quando o pré-requisito é atendido, a menos que seja desativado na solicitação.
KPI e personalização	Permite a reclassificação e a personalização com base em eventos do usuário para otimizar os KPIs específicos da sua empresa. Você recebe uma cobrança se a qualidade de dados atender ao nível de personalização e o pipeline de treinamento estiver pronto.
Visão geral criada por IA	Ativa recursos generativos, como resumos generativos e perguntas complementares. O complemento de consulta semântica é um pré-requisito.

Sobre o controle de quais complementos se aplicam a uma solicitação de pesquisa

Como os complementos de solicitação de pesquisa são aplicados por padrão quando são relevantes, você recebe cobranças por eles com preços configuráveis, a menos que os desative.

Há duas maneiras de desativar os cookies:

• Se você estiver usando o widget para hospedar o app, poderá desativar os complementos no nível do widget usando a configuração da interface. Para informações gerais sobre o widget, consulte Adicionar o widget de pesquisa a uma página da Web. Para informações sobre como configurar as definições do widget, consulte Configurar resultados para o widget de pesquisa.

• No nível de cada solicitação, definindo disableSemanticAddOn, disableKpiPersonalizationAddOn e disableGenerativeAnswerAddOn ao fazer uma solicitação de pesquisa usando o método engines.servingConfigs.search.

Para instruções sobre como desativar complementos, consulte Gerenciar preços configuráveis para complementos de consulta de pesquisa.

Detalhes do preço

Para mais informações sobre preços, incluindo um exemplo, consulte Preços configuráveis do Agent Search.

Ativar preços configuráveis para o projeto

Nesta seção, descrevemos como configurar o modelo de preços no nível do projeto. Para usar preços configuráveis em um app ou repositório de dados específico, primeiro ative-os para o projeto.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do Identity and Access Management (IAM):

Você precisa deste papel:	Ou todas estas permissões:
Administrador do Discovery Engine (roles/discoveryengine.admin)	discoveryengine.projects.update

Você pode pedir ao administrador para conceder a você esses papéis do Identity and Access Management. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos do Agent Search. Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Console

Para ativar os preços configuráveis usando o console do Google Cloud , siga estas etapas:

1. No console Google Cloud , acesse a página Faturamento.

   Aplicativos de IA

2. Na página Faturamento, selecione Preços configuráveis.

3. Em Preços configuráveis para todo o projeto, insira o Limite de assinatura de QPM. O mínimo é 1.000 QPM/mês.

4. Em Preços configuráveis em todo o projeto, insira o Limite de assinatura de armazenamento. O mínimo é de 50 GiB/mês.

5. Clique em Salvar configurações do projeto.

Ativar preços configuráveis para um app

Nesta seção, descrevemos como configurar o modelo de preços no nível do app. Para usar preços configuráveis em um app específico, primeiro ative-os para o projeto. Se você não configurar o preço configurável para o app, ele vai usar o modelo de preços gerais em vez de ser coberto pelo preço da assinatura.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do Identity and Access Management (IAM):

Você precisa de pelo menos um destes papéis:	Ou todas estas permissões:
Administrador do Discovery Engine (roles/discoveryengine.admin) Editor do Discovery Engine (roles/discoveryengine.editor)	discoveryengine.engines.create discoveryengine.engines.update discoveryengine.engines.delete

Você pode pedir ao administrador para conceder a você esses papéis do Identity and Access Management. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos do Agent Search. Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Console

Para ativar os preços configuráveis em um app usando o console do Google Cloud , siga estas etapas:

1. No console Google Cloud , acesse a página Apps.

   Aplicativos de IA

2. Na página Apps, clique no app que você quer modificar.

3. No menu principal, clique em Faturamento e selecione Preços configuráveis.

4. Clique em Salvar.

Ativar preços configuráveis para um repositório de dados

Nesta seção, descrevemos como configurar o modelo de preços no nível do repositório de dados. Para usar preços configuráveis em um repositório de dados individual, primeiro ative-os para o projeto. Se você não configurar o preço configurável para o repositório de dados, ele vai usar o modelo de preços gerais em vez de ser coberto pelo preço da assinatura.

Importante: se o repositório de dados selecionado for usado com um app Gemini Enterprise, não ative o preço configurável para ele.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do Identity and Access Management (IAM):

Você precisa de pelo menos um destes papéis:	Ou todas estas permissões:
Administrador do Discovery Engine (roles/discoveryengine.admin) Editor do Discovery Engine (roles/discoveryengine.editor)	discoveryengine.dataStores.create discoveryengine.dataStores.update discoveryengine.dataStores.delete

Você pode pedir ao administrador para conceder a você esses papéis do Identity and Access Management. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos do Agent Search. Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Console

Para ativar os preços configuráveis em um repositório de dados usando o console do Google Cloud , siga estas etapas:

1. No console do Google Cloud , acesse a página Repositórios de dados.

   Aplicativos de IA

2. Na página Repositórios de dados, clique no repositório de dados que você quer modificar.

3. Se o repositório de dados estiver conectado a algum app, verifique se o preço configurável está ativado.

   Um app com preço geral não pode se conectar a um repositório de dados com preço configurável.

4. Clique em Faturamento e selecione Preços configuráveis.

5. Opcional: selecione Complemento semântico (embedding). Esse é um pré-requisito para a veiculação de pesquisa para consultas semânticas e o Modo IA.

6. Clique em Salvar.

Gerenciar preços configuráveis para complementos de consulta de pesquisa

Não são necessários papéis ou permissões especiais para essa tarefa.

Console, somente widget

Se você estiver usando o widget para hospedar seu app e quiser economizar dinheiro limitando os complementos usados pelo widget, faça o seguinte:

1. No console Google Cloud , acesse a página Aplicativos de IA.

   Aplicativos de IA

2. Na página Apps, clique no app que você quer modificar.

3. Clique em Configurations.

4. Para evitar o complemento de visão geral criada por IA, defina Tipo de pesquisa como Pesquisa.

5. Na guia Interface, selecione os complementos que você quer. Para apps do tipo de pesquisa Pesquisa, o complemento de consulta semântica pode ser desativado. O complemento de consulta semântica está sempre ativado para os tipos de pesquisa Pesquisar com uma resposta e Pesquisar com acompanhamentos.

   

6. Clique em Salvar e publicar.

REST, por solicitação de pesquisa

Observação: este recurso é um serviço em pré-lançamento, sujeito aos Termos das Ofertas de pré-GA dos Termos específicos de serviço do GCP. Os produtos e recursos pré-GA podem ter suporte limitado, e as mudanças neles podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições da fase de lançamento. Além disso, ao usar esse recurso, você concorda com os Termos e condições de IA generativa em pré-lançamento ("Termos de Pré-lançamento"). Para esse recurso, é possível processar dados pessoais conforme descrito no Adendo sobre tratamento de dados do Cloud, sujeito às restrições e obrigações aplicáveis no Contrato (conforme definido nos Termos de Pré-lançamento).

Quando você desativa um complemento em uma solicitação de pesquisa, o Agent Search não o aplica a essa solicitação, e você não recebe cobranças por isso. Se você omitir a configuração ou deixar um campo sem definir, o complemento correspondente será aplicado por padrão quando for aplicável.

Para desativar os complementos de solicitação de pesquisa em uma solicitação de pesquisa, faça o seguinte:

1. Para cada consulta, use um comando com uma sintaxe como esta:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
     -d '{
           "query": "QUERY",
           "searchAddonSpec": {
             "disableSemanticAddOn": BOOL_DISABLE_SEMANTIC,
             "disableKpiPersonalizationAddOn": BOOL_DISABLE_KPI,
             "disableGenerativeAnswerAddOn": BOOL_DISABLE_GEN_ANSWER
           }
         }'
   

   Substitua:

   • PROJECT_ID: o ID do seu projeto do Google Cloud .
   • APP_ID: o ID do app Agent Search que você quer consultar.
   • QUERY: o texto da consulta a ser pesquisado.

   Para desativar os complementos, adicione-os ao objeto searchAddonSpec:

   • BOOL_DISABLE_SEMANTIC: para desativar o complemento semântico, defina disableSemanticAddOn como true.

   • BOOL_DISABLE_KPI: para desativar o complemento de KPI e personalização, defina disableKpiPersonalizationAddOn como true.

   • BOOL_DISABLE_GEN_ANSWER: para desativar o complemento de resposta gerada (visão geral criada por IA), defina disableGenerativeAnswerAddOn como true.

   Exemplo de comando e resultado

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/default_search:search" \
     -d '{
           "query": "BigQuery data platform",
           "searchAddonSpec": {
             "disableSemanticAddOn": true,
             "disableKpiPersonalizationAddOn": true,
             "disableGenerativeAnswerAddOn": true
           }
         }'
         
   
   {
     "results": [
       {
         "id": "9ec41e0a58436ad16f355cf5a9a21078",
         "document": {
           "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/9ec41e0a58436ad16f355cf5a9a21078",
           "id": "9ec41e0a58436ad16f355cf5a9a21078",
           "derivedStructData": {
             "link": "gs://my-bucket/bq-directory/DiagramAboutBigQuery.png",
             "can_fetch_raw_content": "true",
             "image": {
               "thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAhQAAAKx...4x73uMevakHOVSQi/gUVbCto1KDKawAAAABJRU5ErkJggg=="
             },
             "title": "BigQueryIllustrated"
           }
         },
         "rankSignals": {
           "keywordSimilarityScore": 0.548946,
           "topicalityRank": 1,
           "documentAge": 495935.8,
           "boostingFactor": 0,
           "defaultRank": 1
         }
       },
       {
         "id": "c0119791c13a516312bbaad4cffae9f5",
         "document": {
           "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/c0119791c13a516312bbaad4cffae9f5",
           "id": "c0119791c13a516312bbaad4cffae9f5",
           "derivedStructData": {
             "can_fetch_raw_content": "true",
             "link": "gs://my-bucket/bq-directory/AboutBigQuery.pdf",
             "title": "AllAboutBigQuery",
             "image": {
               "thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASM ... /062/5c0fGHTW4xm0c5qpsvbIj2v+OW72uPiFpX1x/Xdz/f8BOQGtH50KK50AAAAASUVORK5CYII="
             }
           }
         },
         "rankSignals": {
           "keywordSimilarityScore": 0.37348458,
           "topicalityRank": 2,
           "documentAge": 495935.8,
           "boostingFactor": 0,
           "defaultRank": 2
         }
       }
     ],
     "totalSize": 2,
     "attributionToken": "hwL0BgEKCwjYoqrTBh...x0X3NlYXJjaA",
     "guidedSearchResult": {},
     "summary": {},
     "queryExpansionInfo": {},
     "semanticState": "DISABLED"
   }
     

Para mais informações sobre como enviar uma solicitação de pesquisa, consulte Receber resultados da pesquisa.

Modificar os limites de assinatura

Se você ativou os preços configuráveis para o projeto, ajuste os limites de assinatura conforme necessário. Os aumentos entram em vigor imediatamente, enquanto as reduções entram em vigor no início do próximo ciclo de faturamento.

Para modificar os limites de assinatura, faça o seguinte:

1. Aguarde algumas semanas após a ativação para que os dados de consumo sejam acumulados.

   Se você acha que os limites estão muito altos, verifique o consumo antes do fim do próximo ciclo de faturamento mensal.

2. No console Google Cloud , acesse a página Faturamento.

   Aplicativos de IA

3. Na página Faturamento, clique em Consumo e analise os dados de consumo.

4. Clique em Assinaturas e aumente ou diminua os valores dos limites em todo o projeto conforme necessário.

5. Clique em Salvar configurações do projeto.

   Depois de mudar um limite de assinatura, aguarde até duas horas antes de fazer outra mudança. Uma solicitação para mudar o limite dentro desse período pode falhar.

   Se você estiver diminuindo os limites, os valores mais baixos não vão aparecer na página Assinaturas até o início do próximo ciclo de faturamento.

Mudar o modelo de preços para preços gerais

É possível mudar apps e repositórios de dados individuais para usar preços gerais em vez de preços configuráveis. Se preferir, desative os preços configuráveis para um projeto inteiro.

Antes de mudar o modelo de preços de um app, verifique se os repositórios de dados conectados a ele usam preços gerais. Isso acontece porque um app que usa preços gerais não pode se conectar a um repositório de dados que usa preços configuráveis.

Antes de redefinir um projeto para o modelo de preços geral, verifique se todos os apps e repositórios de dados no projeto estão usando esse modelo.

Ativar os preços gerais para um repositório de dados

Nesta seção, descrevemos como definir o modelo de preços de um repositório de dados como "geral", que é o modelo padrão.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do Identity and Access Management (IAM):

Você precisa de pelo menos um destes papéis:	Ou todas estas permissões:
Administrador do Discovery Engine (roles/discoveryengine.admin) Editor do Discovery Engine (roles/discoveryengine.editor)	discoveryengine.dataStores.create discoveryengine.dataStores.update discoveryengine.dataStores.delete

Você pode pedir ao administrador para conceder a você esses papéis do Identity and Access Management. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos do Agent Search. Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Console

Para ativar os preços gerais de um repositório de dados usando o console do Google Cloud , siga estas etapas:

1. No console do Google Cloud , acesse a página Repositórios de dados.

   Aplicativos de IA

2. Na página Repositórios de dados, clique no repositório de dados que você quer modificar.

3. Clique em Faturamento e selecione Preços gerais.

4. Clique em Salvar.

Ativar preços gerais para um app

Nesta seção, descrevemos como definir o modelo de preços de um app como geral, que é o modelo padrão.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do Identity and Access Management (IAM):

Você precisa de pelo menos um destes papéis:	Ou todas estas permissões:
Administrador do Discovery Engine (roles/discoveryengine.admin) Editor do Discovery Engine (roles/discoveryengine.editor)	discoveryengine.engines.create discoveryengine.engines.update discoveryengine.engines.delete

Você pode pedir ao administrador para conceder a você esses papéis do Identity and Access Management. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos do Agent Search. Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Console

Para ativar os preços gerais de um app usando o Google Cloud console, siga estas etapas:

1. No console Google Cloud , acesse a página Apps.

   Aplicativos de IA

2. Se algum dos repositórios de dados conectados ao app usar preços configuráveis, ative os preços gerais para esses repositórios.

   Um app com preço geral não pode se conectar a um repositório de dados com preço configurável.

3. Na página Apps, clique no app que você quer modificar.

4. No menu principal, clique em Faturamento e selecione Preços gerais.

5. Clique em Salvar.

Desativar os preços configuráveis para o projeto

Antes de desativar os preços configuráveis para seu projeto, verifique se todos os apps e repositórios de dados no projeto usam preços gerais. Consulte Ativar o preço geral para um repositório de dados e Ativar o preço geral para um app.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do Identity and Access Management (IAM):

Você precisa de pelo menos um destes papéis:	Ou todas estas permissões:
Administrador do Discovery Engine (roles/discoveryengine.admin)	discoveryengine.projects.update

Você pode pedir ao administrador para conceder a você esses papéis do Identity and Access Management. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos do Agent Search. Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Console

Para desativar os preços configuráveis em um projeto, siga estas etapas:

1. No console Google Cloud , acesse a página Faturamento.

   Aplicativos de IA

2. Na página Faturamento, selecione Preços gerais.

3. Clique em Salvar configurações do projeto.