Guia para desenvolvedores sobre a filtragem conversacional

Confira a seguir um guia para desenvolvedores sobre como integrar a filtragem de produtos por conversa na sua API.

Atender aos requisitos mínimos de dados para ativar a filtragem conversacional

Para atender à cota de 25% necessária para ativar a filtragem de produtos por conversa, aumente o volume de eventos do usuário que contêm informações de filtro válidas. Quanto mais filtros você fizer upload nos eventos do usuário, maior será a cobertura da conversa.

Confira as etapas e a lógica específicas para aumentar a cobertura:

• Fazer upload de filtros em eventos do usuário. É necessário aumentar a entrada de filtros aplicados a eventos do usuário. Isso garante que, quando um usuário aplica um filtro como cor ou preço no seu site, essa ação seja capturada no campo de filtro do evento de usuário de pesquisa correspondente enviado para o AI Commerce Search.

• Estabeleça um ciclo de feedback. O LLM infere a popularidade da faceta com base nesses filtros. Ao incluir filtros correspondentes em eventos de pesquisa quando um atributo é marcado como dinamicamente facetável, você inicia o processo de aprendizado do modelo. O ideal é que a interface do usuário capture e transmita as seleções de filtro do usuário em solicitações e eventos de pesquisa para impulsionar esse refinamento contínuo do modelo.

• Monitore as verificações de consultoria sobre a qualidade de dados. Se você atingiu o limite inicial de 1.000 consultas por dia,mas não alcançou 25% de cobertura, a página Qualidade de dados no console (na guia Conversa) vai fornecer verificações consultivas específicas. Essas verificações calculam e mostram a porcentagem exata em que seus filtros aplicados de evento do usuário precisam aumentar para atingir a meta de cobertura.

• Verifique a configuração de atributos. Como o modelo usa os atributos que você está filtrando para gerar perguntas, verifique se eles estão configurados corretamente no catálogo como indexáveis e com facetas dinâmicas.

Experiência do administrador

Gerencie as perguntas generativas e a filtragem de produtos conversacionais diretamente na API ou no console do AI Commerce Search no Gemini Enterprise for Customer Experience e configure nas seções Qualidade de dados e Avaliar do console.

Console do Cloud

Com o console, os varejistas podem gerenciar perguntas generativas em uma experiência de filtragem conversacional de produtos. Saiba mais sobre como usar perguntas generativas na filtragem de produtos por conversa.

Etapas para usar o serviço de perguntas generativas

1. Atenda aos requisitos de dados.

2. Configure substituições manuais de perguntas.

3. Ative o recurso.

4. Visualizar e testar.

Requisitos de dados

Para saber se os dados de pesquisa estão prontos para a filtragem de produtos por conversa, no console, em Filtragem e navegação de produtos por conversa ou em Qualidade de dados > Conversa, acesse a guia Verificações de cobertura.

Para ativar a filtragem de produtos por conversa, você precisa atender a determinados requisitos de dados.

São eles:

• 1.000 consultas por dia: depois de atingir esse primeiro limite, um plano de conversa é gerado para avaliar suas entradas e saídas:
• Entradas: contagem de filtros em eventos
• Saídas: cobertura de conversas
• Cobertura de conversação de 25%: calculada por modelos de AI Commerce Search, a cobertura de conversação significa a porcentagem de consultas que têm uma pergunta. 25% (por volume) das consultas ponderadas por frequência precisam ter pelo menos uma pergunta inicial correspondente.

Se você ainda não tiver 25% de cobertura de conversa, mas tiver o primeiro pré-requisito de 1.000 consultas por dia, as verificações de bloqueio e de aviso vão começar a ser aplicadas às suas saídas e entradas, respectivamente. Nesse momento, a AI Commerce Search começa a calcular em quanto por cento os filtros aplicados aos eventos do usuário precisam aumentar para atingir o limite de 25% de cobertura de conversação. Quanto mais filtros forem enviados, maior será a cobertura alcançada.

Para conferir sua prontidão para conversas:

1. Acesse a guia Conversa na página Qualidade dos dados no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience. Isso fornece uma verificação crítica para saber se um mínimo de 25% das consultas de pesquisa tem pelo menos uma pergunta de acompanhamento, além de verificações consultivas sobre qual porcentagem de eventos do usuário com filtros válidos é necessária para atingir essa meta de cobertura de conversa.

Figura 1. Verificação de prontidão para pesquisa conversacional.

1. Se você passar na verificação crítica e tiver eventos de usuário suficientes com filtros válidos, avance para a próxima etapa.

2. Para controlar como as perguntas generativas são veiculadas, acesse a página de filtragem e navegação de produtos conversacionais no console da Pesquisa de comércio com IA.

Controles de perguntas generativas

A IA generativa escreve uma pergunta para cada atributo indexável no catálogo, usando nomes e valores de atributos do sistema e personalizados. Essas perguntas são geradas por um LLM e têm como objetivo melhorar a experiência de pesquisa. Por exemplo, para o tipo de móvel, os valores podem ser "interno" ou "externo". A IA sintetiza uma pergunta sobre o tipo de móvel que você está procurando.

Cada atributo tem uma pergunta gerada. Com base nos eventos históricos do usuário e no engajamento de facetas dos dados de eventos de pesquisa anteriores, as perguntas são classificadas pela frequência esperada de aparição. Primeiro, a IA analisa as perguntas na parte de cima e depois encontra o que é relevante por atributo. A lista de perguntas é gerada uma vez. Se um novo atributo for adicionado, ele vai aparecer na lista em duas horas.

1. Acesse a página Agente de compras no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
   
   Acesse a página "Pesquisa e busca conversacionais".

2. Na guia Gerenciar perguntas geradas com IA, confira todas as perguntas classificadas por frequência de uso, em frequência ponderada por consulta, ou seja, com que frequência elas são veiculadas com consultas comuns. O ranking usa o campo de frequência na configuração GenerativeQuestionConfig. Esse campo é responsável por classificar as perguntas geradas com IA de acordo com a frequência de uso.

3. Use a opção de filtro para filtrar as perguntas.

4. Marque a caixa para ativar a visibilidade das perguntas em cada atributo.

5. Clique em no final de cada linha para abrir um painel de edição para cada pergunta.

Para fazer edições em massa, siga estas etapas:

1. Marque ou desmarque as caixas ao lado das perguntas que você quer incluir ou excluir da conversa.

2. Clique no botão Permitir na conversa ou Não permitir na conversa que aparece na parte de cima da lista. Como alternativa, para editar uma pergunta específica, clique em e desmarque ou marque novamente a caixa ao lado de Permitido na conversa no painel que aparece:

Figura 2. Edite cada pergunta gerada com IA.

Usar perguntas generativas na filtragem conversacional de produtos

A API de serviço de perguntas generativas oferece controles para reduzir possíveis inconsistências na saída do LLM. Eles podem ser gerenciados no console. Aqui, os varejistas também podem configurar a filtragem conversacional de produtos ativando ou desativando o estado dela e definindo o número mínimo de produtos necessários para acioná-la.

Você pode definir as perguntas, especificando a pergunta em si, as respostas possíveis e se ela é permitida na conversa. As perguntas individuais podem ser geradas por um LLM ou substituídas pelo varejista. O console permite revisar as perguntas geradas com IA, permitindo que os varejistas as substituam ou alternem o status da conversa. As perguntas também podem ser editadas em massa.

Editar perguntas individuais

Você também pode usar controles para selecionar as perguntas individuais. Recomendamos fazer isso antes de ativar a filtragem conversacional de produtos.

Para cada pergunta, há duas opções. Clique em na última coluna para acessar o painel "Perguntas mostradas aos usuários":

1. Desativar uma pergunta para todas as consultas: a pergunta é ativada por padrão. Limpe (ou marque novamente) a caixa ao lado de Permitido na conversa. Essa opção pula a pergunta. Um varejista pode desativar uma pergunta completamente se ela não estiver relacionada aos atributos consultados ou puder ser interpretada como inadequada. Por exemplo, uma pergunta como Qual tamanho de vestido você está procurando? pode ser percebida como uma intromissão sobre o peso.
2. Reescrever uma pergunta: no painel, você pode ver a pergunta gerada com IA, a qual atributo ela está vinculada e quais valores o atributo tem. Clique no lápis para reescrever.

Ativar a filtragem conversacional

Depois de editar as perguntas de IA generativa no console, você pode ativar a filtragem conversacional de produtos.

Para ativar a filtragem conversacional de produtos, acesse a página Procurar e de filtragem de produtos conversacionais no console da AI Commerce Search no Gemini Enterprise for Customer Experience.

1. Acesse a página Agente de compras no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
   
   Acesse a página "Pesquisa e busca conversacionais".

2. Considere a quantidade mínima de produtos no catálogo que você quer que sejam retornados na pesquisa antes da geração de perguntas. Esse número pode ser maior, mas nunca menor que 2. Uma linha por página geralmente é a quantidade certa para iniciar uma conversa.

3. Configure o número e mude o botão para Ativado. Se houver menos produtos correspondentes, eles serão filtrados.

Figura 3. Mude a chave para Ativar pesquisa conversacional.

Observação: se a IA generativa estiver ativada e o LLM relacionar uma pergunta gerada por IA a qualquer valor de atributo relacionado, uma pergunta de IA poderá aparecer.

Esta página fornece informações sobre o status das suas verificações de bloqueio e de aviso. Se você tiver consultas de pesquisa suficientes com pelo menos uma pergunta complementar, seu site estará pronto para a pesquisa conversacional.

Avaliar e testar

Com a opção Avaliar, você pode visualizar a experiência de veiculação fazendo uma pesquisa de teste e testando suas perguntas em relação às facetas mostradas. Essa parte do console oferece uma prévia da sua experiência de exibição com a filtragem de produtos por conversa.

Para avaliar e testar, siga estas etapas. Na seção Avaliar das guias Pesquisar ou Navegar na página "Avaliar" do console da AI Commerce Search no Gemini Enterprise for Customer Experience.

1. Acesse a página Avaliar no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
   
   Acessar a página "Avaliar"

2. Clique em Pesquisar ou Procurar.

3. No campo Avaliação da pesquisa, insira uma consulta de teste que faça sentido com base no catálogo que você enviou para pesquisa, como sapatos se o catálogo consistir em itens de vestuário.

4. Clique em Visualização da pesquisa para conferir os resultados da pesquisa.

Figura 4. Visualizar resultados.

Se você tiver a filtragem conversacional de produtos ativada, as perguntas generativas também estarão.

API Generative Question

Nesta seção, descrevemos como usar a API de perguntas generativas para integrar a API Conversational à sua interface da Web, gerenciar as perguntas generativas e veicular a filtragem de produtos conversacionais no seu site.

Integração de API

Objetos:

• GenerativeQuestionsFeatureConfig
• GenerativeQuestionConfig
• Serviço GenerativeQuestions
  • UpdateGenerativeQuestionsFeatureConfiguration
  • UpdateGenerativeQuestionConfig
  • ListGenerativeQuestionConfigs
  • GetGenerativeQuestionFeatureConfig
  • BatchUpdateGenerativeQuestionConfigs

O principal para integrar a filtragem de produtos conversacional é definir o recurso question. Isso inclui a pergunta em si e se ela é permitida na conversa. Por padrão, a pergunta é gerada por um LLM, mas pode ser substituída pelo administrador.

Ativar a filtragem conversacional de produtos

Objeto:

• GenerativeQuestionsFeatureConfig

Esse objeto é um arquivo de configuração de controle para ativar a filtragem de produtos conversacionais em perguntas generativas e gerenciar a experiência geral de veiculação. O GenerativeQuestionsFeatureConfig usa um método GET para receber informações de atributos e saber se eles são indexáveis ou não no catálogo associado ao projeto.

A chave feature_enabled determina se as perguntas são usadas no momento da veiculação. Ele gerencia as alternâncias de nível superior no console.

Observação: não é possível ativar a filtragem de produtos por conversa até que os requisitos de dados sejam atendidos. Se os requisitos de dados não forem atendidos, a API vai acionar um erro de validação. A validação dos requisitos de dados fica visível no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience, que, por baixo dos panos, chama a API Conversational Configuration.

Ativar o recurso

// Configuration for overall generative question feature state.
message GenerativeQuestionsFeatureConfig {
...

// Resource name of the affected catalog.
// Format: projects/{project}/locations/{location}/catalogs/{catalog}
string catalog = 1 [(google.api.field_behavior) = REQUIRED];

// Determines whether questions are used at serving time.
// Note: You cannot enable this until initial data requirements are
// satisfied.
bool feature_enabled = 2 [(google.api.field_behavior) = OPTIONAL];

// Minimum number of products in the response to trigger follow-up questions.
// Value must be 0 or positive.
int32 minimum_products = 3 [(google.api.field_behavior) = OPTIONAL];
}

Campos relevantes para a conversa
catálogo	string	O nome do recurso do catálogo afetado no nível do projeto. Formato: projects/{project}/locations/{location}/catalogs/{catalog}.
feature_enabled	booleano	Ativa ou desativa as perguntas. Campo opcional. Ele só pode ser ativado quando os requisitos de dados são atendidos. Se tentado, ele gera um erro.
minimum_products	Integer32	Número mínimo de produtos na resposta para acionar perguntas de acompanhamento. Precisa ter um valor igual ou maior que 0.

Gerenciar as perguntas generativas

Objeto:

• GenerativeQuestionConfig

Uma pergunta pode ser ativada para conversa com o campo booleano allowed_in_conversation. Ele controla a configuração de uma única pergunta gerada.

Campos (controlam os comportamentos da conversa em destaque)
catálogo	string	Usado para identificar qual conjunto de atributos (e, por extensão, perguntas) está disponível. Todos esses valores são definidos no catálogo. Campo obrigatório.
facet	string	Aspecto a que uma pergunta está associada. Campo obrigatório.
generated_question	string	A pergunta padrão gerada pelo LLM. Apenas saída.
final_question	string	A pergunta feita. Ele pode ter um comprimento máximo de 300 bytes. Campo opcional.
example_values	String repetida	Valores que podem ser usados para responder à pergunta. Apenas saída.
frequência	float	A proporção de frequência com que uma pergunta foi feita. Apenas saída.
allowed_in_conversation	booleano	Se a pergunta é feita no momento da veiculação. Este campo é opcional.

Experiência de veiculação

A filtragem conversacional de produtos se baseia em uma conversa contínua de várias rodadas com o usuário. Portanto, é necessária pelo menos uma segunda resposta para que a filtragem conversacional de produtos funcione. O usuário recebe uma pergunta de acompanhamento e respostas sugeridas na resposta. Ele pode responder a essa pergunta digitando a resposta ou clicando em uma opção sugerida (múltipla escolha).

A opção de múltipla escolha funciona nos bastidores como uma faceta (um filtro de tipo de evento), que restringe a consulta usando a filtragem. Em segundo plano, quando o usuário clica em uma resposta de múltipla escolha, um filtro é aplicado à consulta. Aplicar um filtro usando a múltipla escolha conversacional é idêntico a aplicar o mesmo filtro usando facetas ou blocos dinâmicos.

Serviço ativado pela filtragem conversacional de produtos

O serviço de perguntas generativas (service GenerativeQuestionService{...}) é usado para gerenciar perguntas geradas por LLMs. O objeto principal é o catálogo, de onde ele extrai informações para retornar perguntas sobre um determinado catálogo. O serviço é usado para gerenciar o estado geral das perguntas generativas, fazer mudanças individuais ou em lote e ativar ou desativar perguntas. Os requisitos de dados precisam ser atendidos para interagir com a API Service, e as perguntas precisam ser inicializadas antes de serem gerenciadas.

O serviço interage com os arquivos de configuração no nível do recurso e da pergunta com dois conjuntos de manipuladores:

• GenerativeQuestionsFeatureConfig manipuladores (no nível do recurso):

  1. Atualizar: permite mudar o número mínimo de produtos e ativar campos.
  2. Get: retorna um objeto.

• Processadores de configuração do GenerativeQuestion (nível de pergunta):

  1. List: retorna todas as perguntas de um determinado catálogo.
  2. Update: realiza o gerenciamento de perguntas individuais.
  3. A atualização em lote realiza o gerenciamento de perguntas agrupadas.

O serviço retorna uma pergunta semanticamente adequada com base na consulta inicial.

Uma pergunta complementar é gerada pelo modelo de LLM e pode ser substituída. As perguntas são mostradas com base na probabilidade de serem usadas pelos clientes ao chamar o histórico de eventos de pesquisa. Se não houver um histórico de eventos de pesquisa, o fallback será nos registros de pesquisa de comércio.

Perguntas diferentes são geradas com base na consulta anterior. Não há pesos fixos. A IA que gera as perguntas do LLM aprende com as consultas e muda a ponderação de cada uma delas. Por exemplo, "camiseta" pesa muito na categoria, mas "camiseta vermelha GG" pesa na categoria, no tamanho e na cor.

Configurar a experiência de exibição

Configure a experiência de exibição integrando a API de configuração de filtragem de conversas com a API Search.

A API de configuração ConversationalFilteringSpec do recurso fica acima da API Conversational. É possível chamar as duas APIs em paralelo ou nesta ordem:

1. API Conversational
2. API Search

• ConversationalFilteringSpec: esse campo opcional foi adicionado ao ConversationalSearchRequest, mas é obrigatório se você quiser usar a filtragem de produtos por conversa. O campo reutiliza os campos SearchRequest, consulta e filtro. Ele também inclui um campo para ativar uma pergunta de acompanhamento feita ao usuário após uma consulta inicial e um conversation_id para manter o estado da conversa entre o cliente e o servidor.
• ConversationalFilteringResult: um arquivo proto contém informações extras necessárias para serem retornadas no fluxo de CRS conversacional em ConversationalSearchResponse. Isso inclui um conversation_id, refined_query, additional_filters, follow_up_question e suggested_answers.

Jornada do usuário na API de conversação

O usuário inicia uma pesquisa com uma consulta inicial e define a flag mode como CONVERSATIONAL_FILTER_ONLY. Em seguida, o usuário seleciona uma resposta, que é enviada de volta à API usando o campo user_answer.

A API Conversational fornece o campo additional_filter na resposta. O usuário precisa aplicar esses filtros à solicitação de acompanhamento da API Search. Os resultados da pesquisa são baseados na entrada do usuário e fornecem uma nova pergunta de acompanhamento, solicitando uma consulta de acompanhamento e continuando a conversa em várias etapas até que o usuário encontre o que está procurando no site do varejista.

Observação: as interfaces de filtragem de produtos por conversa interagem com duas APIs, incluindo a de pesquisa e a de conversa. A API Search busca os resultados da pesquisa, e a API Conversational busca a resposta da conversa. A API Conversational não retorna resultados da pesquisa.

Supondo que a filtragem conversacional de produtos esteja ativada no site, a jornada do usuário e a interação subsequente com o AI Commerce Search seguem este caminho:

• Etapa 1. A primeira consulta é feita pelo usuário para as APIs Search e Conversational. A API Search só retorna resultados da pesquisa. A API Conversational retorna as respostas sugeridas e as perguntas de acompanhamento. Chame a API Search para a mesma consulta ou page_category e extraia os resultados da pesquisa. A conversa complementar solicitada é enviada para a pesquisa conversacional. Chame a API Conversational com o modo de filtragem de conversa correto.

• Etapa 2. Resposta inicial da pesquisa com apenas resultados da pesquisa. A API Conversational refina a consulta retornando as respostas sugeridas e as perguntas de acompanhamento. O usuário final seleciona múltipla escolha:

  • O filtro de resposta selecionado é enviado à API Conversacional.
  • As APIs Conversation e Search são executadas com o filtro aplicado.

Consulta inicial do usuário

A primeira consulta é quando o usuário inicia uma conversa no AI Commerce Search e procura dress na caixa de pesquisa.

• Ação do usuário: o usuário final pesquisa vestido.
• Sua implementação: faça duas chamadas de API.
• Solicitação de API Conversacional:
  • query: "dress"
  • conversational_search_spec:
    • mode: "CONVERSATIONAL_FILTER_ONLY". Este é o parâmetro principal.
• Solicitação de API Search:
  • query: vestido
• Resposta da API de conversação:
  • conversation_id: "c15..." Armazene essa variável.
  • followup_question: a pergunta Qual é a cor? é gerada.
  • suggested_answers: [ {name: "colors", value: "yellow"}, {name: "colors", value: "blue"}, ... ]
• Ação: mostre followup_question e suggested_answers ao usuário.

Observação: há dois endpoints de API diferentes. A API Search principal precisa ser usada para buscar resultados da pesquisa, e a API Conversational para buscar a experiência de conversa. A API Conversational não retorna resultados da pesquisa.

Enviar solicitação para a API Search

Envie uma solicitação à API Search criando a seguinte solicitação de pesquisa definindo dress como a consulta (ou qualquer que seja a consulta real):

Solicitação da API Search

{
  query: "dress",
  Search_params : {
    "filter": string,
    "canonicalFilter": string,
    "sortBy": string,
    "boostSpec": {
       object (BoostSpec)
    }
  }
}

Não há mudanças na solicitação de API Search como parte da filtragem conversacional de produtos.

Enviar solicitação para a API Conversational

Envie uma solicitação para a API Conversational fazendo o seguinte:

• Crie uma solicitação de pesquisa conversacional definindo dress como a consulta (ou qualquer que seja a consulta real).

• Defina mode como CONVERSATIONAL_FILTER_ONLY para receber uma resposta de conversa. Se estiver definido como DISABLED, nenhuma pergunta complementar será fornecida.

• Preencha SearchParams na solicitação de pesquisa conversacional. Os parâmetros de pesquisa precisam ser os mesmos da chamada de API Search.

Solicitação de API de conversa

{
  "query": "dress",
  "conversational_search_spec":  {
    "mode": "CONVERSATIONAL_FILTER_ONLY"
  }
}

Resposta da API de conversa

A resposta da API Conversational será parecida com esta:

Solicitação de API de conversa

{
  conversation_id: "c154d073-87f5-4edb-accd-587eabe014ff"
  refined_query: "dress"
  conversational_filtering_result: {
    followup_question{
      followup_question: "What is the color?"
      suggested_answers {
        product_attribute_value {
          name: "colors",
          value: "yellow"
        }
      }
    suggested_answers {
      product_attribute_value {
        name: "colors",
        value: "blue"
      }
    }
    suggested_answers {
      product_attribute_value {
        name: "colors",
        value: "red"
      }
    }
   }
  }
}

O que fazer com a resposta:

• conversation_id: esse ID pode ser armazenado no armazenamento de sessão do navegador e usado para continuar a pesquisa conversacional com o servidor. Como um comprador pode ter várias guias abertas com mais de uma conversa, o conversation_id é usado para rastrear as conversas.
• refined_query: identifica a consulta atual. Você precisa usar essa resposta para chamar a API Search e buscar os resultados do produto.
• followup_question: identifica a pergunta a ser mostrada ao usuário.
• suggested_answers: uma lista ordenada das respostas de múltipla escolha que devem ser mostradas aos usuários. Se você quiser mostrar menos respostas, mostre apenas os primeiros N resultados. A lista é classificada na ordem em que os resultados devem ser mostrados.

A consulta inicial tem a conversa ativada.

Solicitação de API de conversa

{
  "query": "dress",
  "conversational_search_spec":  {
    "mode": "CONVERSATIONAL_FILTER_ONLY"
  }
}

A Pesquisa lida com respostas de múltipla escolha

• Ação do usuário: clica em amarelo.
• Sua implementação: faça duas novas chamadas de API.
• Solicitação de API Conversacional:
  • query: vestido
  • conversation_id: "c15..." Use o ID armazenado.
  • user_answer: { selected_answer: { product_attribute_value: { name: "colors", value: "yellow" } } }
• Solicitação de API Search:
  • query: vestido.
• Resposta da API de conversação:
  • additional_filter: { product_attribute_value: { name: "colors", value: "yellow" } }
  • followup_question: Qual é a ocasião?
• Ação: use additional_filter para atualizar a interface da Web, como marcar a caixa de filtro amarela e mostrar a nova pergunta.

Resposta da API de conversa

{
  conversation_id: "c154d073-87f5-4edb-accd-587eabe014ff"
  refined_query: "dress"
  conversational_filtering_result: {
    followup_question{
      followup_question: "What is the color?"
      suggested_answers {
        product_attribute_value {
          name: "colors",
          value: "yellow"
        }
      }
    suggested_answers {
      product_attribute_value {
        name: "colors",
        value: "blue"
      }
    }
    suggested_answers {
      product_attribute_value {
        name: "colors",
        value: "red"
      }
    }
   }
  }
}

• conversational_filtering_result é um campo relacionado a ConversationalFilteringResult, que é um proto que contém informações extras retornadas do fluxo de conversa. O campo conversational_filtering_result em ConversationalSearchResponse fornece dados complementares cruciais para a renderização da interface do usuário. O campo conversational_filtering_result usa mensagens aninhadas, como SuggestedAnswer e AdditionalFilter, para estruturar os dados retornados de maneira clara e compreensível. Essa estrutura hierárquica garante que as informações trocadas entre o cliente e o servidor sejam bem definidas e interpretáveis.
• As respostas sugeridas são classificadas de acordo com os valores de faceta no catálogo que foram mais usados nos eventos do usuário como filtros para todas as consultas. A classificação usa o campo engagement_rate na pergunta complementar gerada pelo serviço ConversationalSearch. Esse campo captura a taxa de engajamento histórica que o filtro mostra dos eventos de pesquisa do varejista enviados ao servidor.
• Todos os outros campos permanecem inalterados quando a conversa é usada.

O que fazer com o retorno inicial da pesquisa conversacional

• No lado do cliente, os desenvolvedores precisam armazenar o conversation_id no armazenamento de sessão do navegador para que ele possa ser usado para continuar a pesquisa conversacional com o servidor.
• Usado para acompanhar a conversa em andamento, já que um comprador pode ter várias guias abertas com várias conversas em andamento.

refined_query informa ao varejista qual é a consulta atual.

• Isso deve ser usado se o varejista quiser mostrar a consulta atual ao usuário.

followup_question informa ao varejista qual pergunta mostrar ao usuário.

suggested_answers.

• Esta é uma lista ordenada das respostas de múltipla escolha que devem ser mostradas aos usuários.
• Se quiser mostrar menos itens do que a lista completa, mostre apenas os primeiros N resultados.
• Essa lista é classificada, então precisa ser mostrada na ordem correta. Em outras palavras, o primeiro resultado a aparecer é o primeiro da lista.

A filtragem conversacional de produtos oferece estas opções para manter a conversa contínua, o que leva a um refinamento de pesquisa mais rápido:

Quando os resultados da pesquisa são mostrados ao usuário, ele pode selecionar uma opção de múltipla escolha.

Este exemplo de código demonstra que o usuário selecionou a resposta de múltipla escolha amarelo,e uma nova solicitação de conversa é enviada à API Search ao enviar a consulta novamente com o filtro de usuário correto aplicado.

Solicitação da API Search

{
  query: "dress",
  "search_params": {
    "boost_spec": {},
    "canonical_filter": "",
    "filter": "colors: ANY("yellow")"
    "sort_by": ""
  }
}

Para enviar uma solicitação à API Conversational:

1. Restaure o conversation_id do armazenamento de sessão.
2. Defina mode como CONVERSATIONAL_FILTER_ONLY.
3. Defina user_answer para o que o usuário selecionar.

Solicitação de API de conversa

{
  query: "dress"
  conversation_id: "c154d073-87f5-4edb-accd-587eabe014ff"
  conversational_search_spec {
    "mode": "CONVERSATIONAL_FILTER_ONLY"
    user_answer {
      selected_answer {
        product_attribute_value {
          name: "colors"
          value: "yellow"
        }
      }
    }
  }
}

A resposta da API Conversational será semelhante a esta:

Resposta da API de conversa

{
  conversation_id: "c154d073-87f5-4edb-accd-587eabe014ff"
  refined_query: "dress"
  conversational_filtering_result {
    additional_filter {
      product_attribute_value {
        name: "colors",
        value: "yellow"
      }
    }
    followup_question{
    followup_question: "What is the occasion?"
    suggested_answers {
      product_attribute_value {
        name: "attribute.occasion",
        value: "wedding"
      }
    }
    suggested_answers {
      product_attribute_value {
        name: "attribute.occasion",
        value: "party"
      }
    }
  }
 }
}

O que fazer com a resposta:

• A resposta do Google é basicamente idêntica à resposta da primeira consulta, exceto que o campo additional_filter pode ser usado para marcar a caixa de filtro de color = yellow e deve ser adicionado a qualquer outro filtro selecionado pelo usuário.
• O additional_filter também precisa ser adicionado ao evento de campo de filtro enviado ao Google para essa consulta de acompanhamento e a solicitação de pesquisa de acompanhamento. Ela precisa ser aplicada na solicitação de pesquisa para buscar produtos e também na solicitação de pesquisa conversacional para buscar a conversa de acompanhamento.
• O refined_query precisa ser enviado à API Search para buscar produtos mais relevantes.

Implementar filtros de produto

Esta seção serve como um guia para os usuários implementarem a filtragem conversacional de produtos no nível da API. O estado inicial (neutro) é uma página de destino, provavelmente com uma barra de pesquisa, recomendações ou campanhas de marketing, dependendo do seu aplicativo AI Commerce Search. Nenhuma chamada foi feita para a API Search ou Conversation.

Estado inicial

Esta é a página de destino da interface do usuário, das recomendações ou das campanhas. Nenhuma chamada de API Search for Conversational foi feita ainda.

O usuário insere uma consulta

Insira uma consulta, como batom,para fazer chamadas paralelas às APIs Search e Conversation.

A pesquisa e a conversa atendem à primeira pergunta

As respostas da API aparecem, incluindo uma pergunta inicial e um conjunto de opções de resposta. As respostas das APIs Conversacional e Search à consulta inicial do usuário são assíncronas, respectivamente.

O usuário seleciona uma resposta ou um filtro apresentado

O usuário seleciona uma resposta ou um filtro apresentado.

Em seguida, a seleção do usuário emite uma segunda chamada para as duas APIs com a faceta de filtro ou a resposta do usuário.

As APIs fazem perguntas complementares

As APIs Search e Conversation respondem de forma assíncrona para atender a outra pergunta e apresentar opções de resposta.

O usuário vê a próxima pergunta e um conjunto de opções de resposta.

Casos extremos

Há alguns outros cenários possíveis cobertos pela implementação.

O usuário insere uma nova consulta

Se o usuário estiver no meio da inserção de um filtro de conversa para uma consulta, como batom,a interface da Web já terá sido preenchida com a resposta inicial da API. No entanto, quando o usuário insere uma nova consulta, como protetor solar, uma nova conversa é iniciada. Se isso acontecer, a implementação da API vai reverter para uma nova consulta, mas com um campo conversation_id vazio. Essa nova consulta gera uma nova resposta e, por sua vez, preenche novamente a interface da Web com uma nova resposta.

O usuário desmarca um filtro de refinamento ou uma pergunta respondida anteriormente

Se o usuário estiver em uma interface que já foi preenchida com a resposta de uma consulta anterior, mas desmarcar o filtro de refinamento ou a resposta selecionada, uma nova sessão de conversa será iniciada com filtros searchParam. Isso acontece porque o usuário está saindo do fluxo de conversa atual.