Guia do programador de filtragem conversacional

Segue-se um guia do programador sobre como integrar a filtragem de produtos conversacional na sua API.

Experiência do administrador

Faça a gestão das perguntas generativas e da filtragem de produtos conversacional diretamente na API ou na consola de pesquisa para comércio e configure-a nas secções Qualidade dos dados e Avaliar da consola de pesquisa para comércio.

Cloud Console

A consola permite que os retalhistas geram perguntas numa experiência de filtragem de produtos conversacional. Saiba mais sobre a utilização de perguntas generativas na filtragem de produtos conversacional.

Passos para usar o serviço de perguntas generativas

1. Satisfazer os requisitos de dados.

2. Configure substituições manuais de perguntas.

3. Ative a funcionalidade.

4. Pré-visualize e teste.

Requisitos de dados

Para saber se os seus dados de pesquisa estão prontos para a filtragem de produtos conversacional, na consola, em Filtragem de produtos conversacional e navegação ou em Qualidade dos dados > Conversação, aceda ao separador Verificações de cobertura.

Para ativar a filtragem de produtos conversacional, tem de cumprir determinados requisitos de dados.

São eles:

• 1000 consultas por dia: depois de atingir este primeiro limite, é gerado um plano de conversação que avalia as suas entradas e saídas:
• Entradas: quantidade de filtros em eventos
• Resultados: cobertura conversacional
• Cobertura de conversação de 25%: calculada pelos modelos do Vertex AI Search para comércio, a cobertura de conversação refere-se à percentagem de consultas que têm uma pergunta. 25% (por volume) das consultas ponderadas por frequência devem ter, pelo menos, uma primeira pergunta que corresponda.

Se ainda não tiver uma cobertura conversacional de 25%, mas tiver o primeiro pré-requisito de 1000 consultas por dia, as verificações de bloqueio e consultoria começam a ser aplicadas às suas saídas e entradas, respetivamente. Aqui, a Pesquisa do Vertex AI para comércio começa a calcular a percentagem em que os filtros aplicados por eventos do utilizador têm de aumentar para atingir o limite de cobertura conversacional de 25%. Quanto mais filtros forem carregados, maior é a cobertura alcançada.

Para ver a sua disponibilidade para conversas:

1. Aceda ao separador Conversa na página Qualidade dos dados na consola de pesquisa para comércio. Isto fornece-lhe uma verificação crítica para saber se um mínimo de 25% das consultas de pesquisa têm, pelo menos, uma pergunta de seguimento, bem como verificações consultivas sobre a percentagem de eventos de utilizador com filtros válidos necessária para atingir esse objetivo de cobertura conversacional.

Figura 4. Verificação da capacidade de conversa.

1. Se passar na verificação crítica, com eventos de utilizadores suficientes com filtros válidos, avance para o passo seguinte.

2. Para controlar a forma como as perguntas generativas são apresentadas, aceda à página de navegação e filtragem de produtos conversacional na consola do Vertex AI Search for commerce.

Controlos de perguntas generativas

A IA generativa escreve uma pergunta para cada atributo indexável no catálogo, usando os nomes e os valores dos atributos para atributos do sistema e personalizados. Estas perguntas são geradas por um MDG e visam melhorar a experiência de pesquisa. Por exemplo, para o tipo de mobiliário, os valores podem ser interior ou exterior. A IA sintetiza uma pergunta sobre o tipo de mobiliário que procura.

Cada faceta tem uma pergunta gerada. Com base nos eventos de utilizadores históricos e na interação com as facetas dos dados de eventos de pesquisa anteriores, as perguntas são ordenadas pela frequência esperada de apresentação da pergunta. A IA analisa primeiro as perguntas na parte superior e, em seguida, encontra o que é relevante por atributo. A lista de perguntas é gerada uma vez. Se for adicionado um novo atributo, este é refletido na lista em duas horas.

1. Aceda à página Pesquisa e navegação conversacionais na consola de pesquisa para comércio.
   
   Aceda à página de pesquisa e navegação conversacional.

2. No separador Gerir perguntas geradas pela IA, veja todas as perguntas ordenadas pela frequência de utilização, na frequência ponderada por consultas, ou seja, a frequência com que são apresentadas com consultas comuns. A classificação usa o campo de frequência na configuração GenerativeQuestionConfig. Este campo é responsável por ordenar as perguntas geradas pela IA pela frequência com que são usadas.

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

4. Selecione a caixa para ativar a visibilidade das perguntas para 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 estes passos:

1. Selecione ou desmarque as caixas junto às perguntas que quer incluir ou excluir na conversa.

2. Clique no botão Permitir na conversa ou Não permitir na conversa apresentado na parte superior da lista. Em alternativa, para editar uma pergunta individual, clique em e desmarque ou volte a marcar a caixa junto a Permitido na conversa no painel apresentado:

Figura 5. Edite cada pergunta gerada pela IA.

Use perguntas generativas na filtragem de produtos conversacional

A API de serviço de perguntas generativas oferece controlos para mitigar potenciais inconsistências no resultado do MDG. Estas podem ser geridas a partir da consola. Aqui, os retalhistas também podem configurar a filtragem de produtos conversacional ativando/desativando o respetivo estado e definindo o número mínimo de produtos necessários para a acionar.

Pode definir as perguntas, especificando a pergunta em si, as potenciais respostas e se a pergunta é permitida na conversa. As perguntas individuais podem ser geradas por um MDG ou substituídas pelo retalhista. A consola suporta a revisão de perguntas geradas pela IA, o que permite aos retalhistas substituí-las ou ativar/desativar o respetivo estado de conversação. As perguntas também podem ser editadas em massa.

Edite perguntas individuais

Também pode usar controlos para organizar as perguntas individuais. Recomendamos que o faça antes de ativar a filtragem de produtos conversacional.

Para cada pergunta, existem duas opções. Clique em na última coluna para aceder às perguntas visíveis no painel de utilizadores:

1. Desative uma pergunta para todas as consultas: a pergunta está ativada por predefinição. Desmarque (ou marque novamente) a caixa junto a Permitido na conversa. Esta opção ignora a pergunta. Um retalhista pode optar por desativar uma pergunta completamente se não estiver relacionada com os atributos consultados ou se puder ser mal interpretada como imprópria de alguma forma (uma pergunta como "Que tamanho de vestido procura?" pode ser percebida como uma intromissão no peso de um comprador).
2. Reescrever uma pergunta: no painel, pode ver a pergunta gerada pela IA, a que atributo está anexada e os valores que o atributo tem. Clique no lápis para a reescrever.

Ative a filtragem conversacional

Depois de editar as perguntas de IA generativa na consola, tem tudo pronto para ativar a filtragem de produtos conversacional.

Para ativar a filtragem de produtos conversacional, aceda à filtragem de produtos conversacional e à página de navegação na consola do Search for commerce.

1. Aceda à página Pesquisa e navegação conversacionais na consola de pesquisa para comércio.
   
   Aceda à página de pesquisa e navegação conversacional.

2. Considere a quantidade mínima de produtos no seu catálogo que quer que sejam devolvidos na pesquisa antes de serem geradas perguntas. Este número pode ser superior, mas nunca inferior a 2. Uma linha por página é, muitas vezes, a quantidade certa para acionar uma conversa.

3. Configure o número e mude o interruptor para Ativado. Se menos produtos corresponderem ao número, são filtrados.

Figura 6. Ative o interruptor para ativar a pesquisa conversacional.

Nota: se a IA generativa estiver ativada e o MDG relacionar uma pergunta gerada pela IA com qualquer valor de atributo relacionado, pode aparecer uma pergunta de IA.

Esta página faculta informações sobre o estado das suas verificações de bloqueio e de aviso. Se tiver consultas de pesquisa suficientes com pelo menos uma pergunta de seguimento, o seu site está agora ativado para a pesquisa conversacional.

Avalie e teste

A opção Avaliar permite-lhe pré-visualizar a experiência de publicação executando uma pesquisa de teste e testando as suas perguntas em relação às facetas apresentadas. Esta parte da consola oferece-lhe uma pré-visualização da sua experiência de publicação com a filtragem de produtos conversacional.

Para avaliar e testar, siga estes passos. Na secção Avaliar dos separadores Pesquisar ou Procurar na página Avaliar da consola de pesquisa de comércio.

1. Aceda à página Avaliar na consola de pesquisa para comércio.
   
   Aceda à página Avaliar

2. Clique em Pesquisar ou Procurar.

3. No campo Avaliação da pesquisa, introduza uma consulta de teste que faça sentido com base no catálogo que carregou para pesquisa, como sapatos se o seu catálogo consistir em artigos de vestuário.

4. Clique em Pré-visualização da pesquisa para ver os resultados da pesquisa.

Figura 7. Pré-visualize os resultados.

Se tiver a filtragem de produtos conversacional ativada, as perguntas generativas estão ativadas.

API Generative Question

Esta secção descreve como usar a API de perguntas generativas para integrar a API de conversação na sua IU, gerir as perguntas generativas e publicar a funcionalidade no seu site.

Integração da API

Objetos:

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

O essencial para integrar esta funcionalidade é definir o recurso question. Isto inclui a própria pergunta e se a pergunta é permitida na conversa. A pergunta é gerada por predefinição por um MDG, mas pode ser substituída pelo administrador.

Ative a filtragem de produtos conversacional

Objeto:

• GenerativeQuestionsFeatureConfig

Este objeto é um ficheiro de configuração de controlo para ativar a funcionalidade de perguntas generativas de modo a gerir a experiência de publicação geral da filtragem de produtos conversacional. GenerativeQuestionsFeatureConfig usa um método GET para obter informações de atributos e se os atributos são indexáveis ou não a partir do catálogo associado ao projeto.

O interruptor feature_enabled determina se as perguntas são usadas no momento da publicação. Gere os botões de ativação/desativação de nível superior na consola.

Nota: não pode ativar esta funcionalidade até que os requisitos de dados sejam cumpridos. Se os requisitos de dados não forem cumpridos, a API aciona um erro de validação. A validação dos requisitos de dados é visível na consola de pesquisa de comércio, que, nos bastidores, chama a API de configuração conversacional.

Ative a funcionalidade

// 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	de string	O nome do recurso do catálogo afetado ao nível do projeto. Formato: projects/{project}/locations/{location}/catalogs/{catalog}.
feature_enabled	booleano	Ativa ou desativa as perguntas. Campo opcional. Não pode ser ativada até serem cumpridos os requisitos de dados. Se tentar, é apresentado um erro.
minimum_products	Integer32	Número mínimo de produtos na resposta para acionar perguntas de seguimento. Tem de ter um valor igual ou superior a 0.

Faça a gestão das perguntas generativas

Objeto:

• GenerativeQuestionConfig

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

Campos (controlam os comportamentos da conversa realçada)
catálogo	de string	Usado para identificar que conjunto de atributos (e, por extensão, perguntas) está disponível. Estes valores estão todos definidos no catálogo. Campo obrigatório.
atributo	de string	Aspeto ao qual uma pergunta está associada. Campo obrigatório.
generated_question	de string	A pergunta predefinida gerada pelo MDI/CE. Apenas saída.
final_question	de string	A pergunta que é feita. 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	flutuante	A proporção da frequência com que uma pergunta foi feita. Apenas saída.
allowed_in_conversation	booleano	Se a pergunta é feita no momento da publicação. Este campo é opcional.

Experiência de publicação

A filtragem de produtos conversacional baseia-se na interação com o utilizador através de uma conversa contínua de várias interações. Por isso, é necessária, pelo menos, uma segunda resposta para que a filtragem de produtos conversacional funcione. O utilizador recebe uma pergunta de seguimento e respostas sugeridas na resposta, e pode responder a esta pergunta de seguimento introduzindo a sua resposta ou clicando numa resposta sugerida (opção de escolha múltipla).

A opção de escolha múltipla funciona nos bastidores como uma faceta (um filtro de tipo de evento), que restringe a consulta através da filtragem. Em segundo plano, quando o utilizador clica numa resposta de escolha múltipla, é aplicado um filtro à consulta. A aplicação de um filtro através da escolha múltipla conversacional é idêntica à aplicação do mesmo filtro através de mosaicos ou facetas dinâmicas.

Serviço ativado pela funcionalidade

O serviço de perguntas generativas (service GenerativeQuestionService{...}) é usado para gerir perguntas geradas por MDIs. O respetivo objeto principal é o catálogo, de onde obtém informações para devolver perguntas para um determinado catálogo. O serviço é usado para gerir o estado geral da funcionalidade de perguntas generativas, fazer alterações individuais ou em lote e ativar ou desativar perguntas. Os requisitos de dados têm de ser cumpridos para interagir com a API Service, e as perguntas têm de ser inicializadas antes de poderem ser geridas.

O serviço interage com os ficheiros de configuração ao nível da funcionalidade e da pergunta com dois conjuntos de controladores:

• Controladores GenerativeQuestionsFeatureConfig (ao nível da funcionalidade):

  1. Atualizar: permite alterar os produtos mínimos e ativar campos.
  2. Get devolve um objeto.

• Handlers de configuração de GenerativeQuestion (ao nível da pergunta):

  1. List: devolve todas as perguntas para um determinado catálogo.
  2. Atualizar: realiza a gestão de perguntas individuais.
  3. A atualização em lote permite gerir perguntas agrupadas.

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

Uma pergunta de seguimento é gerada pelo modelo de MDL/CE e pode ser substituída. As perguntas são apresentadas com base na probabilidade de serem usadas pelos clientes através da chamada do histórico de eventos de pesquisa. Se não existir um histórico de eventos de pesquisa, a alternativa é usar os registos de pesquisa de comércio.

São geradas perguntas diferentes com base na consulta anterior. Não existem pesos fixos. A IA que gera as perguntas do MDG aprende com as consultas e altera a ponderação para cada consulta, de modo que "camisa", por exemplo, pondera muito a categoria, mas "camisa vermelha XL" pondera a categoria, o tamanho e a cor.

Configure a experiência de publicação

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

A API de configuração ConversationalFilteringSpec para a funcionalidade baseia-se na API Conversacional. Pode chamar ambas as APIs em paralelo ou nesta ordem:

1. API Conversational
2. API Search

• ConversationalFilteringSpec: este campo opcional foi adicionado ao ConversationalSearchRequest, mas é obrigatório se quiser usar a funcionalidade de filtragem conversacional. O campo reutiliza os campos SearchRequest, a consulta e o filtro. Também inclui um campo para ativar uma pergunta de seguimento apresentada ao utilizador após uma consulta inicial e um `conversation_id` para manter o estado da conversa entre o cliente e o servidor.
• ConversationalFilteringResult: um ficheiro proto contém informações adicionais que têm de ser devolvidas para o fluxo de CRS conversacional em ConversationalSearchResponse. Isto inclui um conversation_id, refined_query, additional_filters, follow_up_question e suggested_answers.

Percurso do utilizador através da API de fluxo de conversação

O utilizador inicia uma pesquisa com uma consulta inicial e define a flag mode como CONVERSATIONAL_FILTER_ONLY. Em seguida, o utilizador seleciona uma resposta, que é enviada de volta para a API através do campo user_answer.

A API Conversational fornece o campo additional_filter na resposta. O utilizador tem de aplicar estes filtros ao pedido de seguimento da API Search. Os resultados da pesquisa baseiam-se na entrada do utilizador e fornecem uma nova pergunta de seguimento, pedindo uma consulta de seguimento e continuando a conversa em várias interações até o utilizador encontrar o que procura no Website do retalhista.

Nota: as interfaces de filtragem de produtos conversacionais interagem com duas APIs, que incluem a API Google Search e a API Google Conversational. A API Search destina-se a obter os resultados da pesquisa e a API Conversational destina-se a obter a resposta conversacional. A API Conversational não devolve resultados da pesquisa.

Partindo do princípio de que a filtragem de produtos conversacional está ativada no Website, o percurso do utilizador e a interação subsequente com o Vertex AI Search para comércio seguem este caminho:

• Passo 1. A primeira consulta é feita pelo utilizador à API Google Search e à API Conversational. A API Search devolve apenas resultados da pesquisa. A API de conversação devolve as respostas sugeridas e as perguntas de seguimento. Chame a API Search para a mesma consulta ou page_category e obtenha os resultados da pesquisa.
• Passo 2. A conversa de seguimento pedida é enviada para a pesquisa conversacional. Chame a API Conversacional com o modo de filtragem de conversas correto.
• Passo 3. Resposta inicial da pesquisa apenas com resultados da pesquisa. A API de conversação refina a consulta devolvendo as respostas sugeridas e as perguntas de seguimento.
• Seleção do utilizador: o utilizador seleciona uma opção múltipla.
  • O filtro de respostas selecionado é enviado para a API de conversação.
  • As APIs Conversation e Search são executadas com o filtro aplicado.

A primeira consulta é do utilizador que inicia a conversa

A primeira consulta ocorre quando o utilizador inicia uma conversa no Vertex AI Search para comércio e procura dress na caixa de pesquisa.

Nota: existem dois pontos finais da API diferentes. A API Search principal tem de ser usada para obter resultados da pesquisa e a nova API Conversational tem de ser usada para obter a experiência conversacional. A API Conversational não devolve resultados da pesquisa.

Envie um pedido para a API Search criando o seguinte pedido de pesquisa definindo dress como a consulta (ou qualquer que seja a consulta real):

Pedido de API de pesquisa

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

Não existe nenhuma alteração no pedido da API Search como parte da filtragem de produtos conversacional.

Envie um pedido para a API Conversational fazendo o seguinte:

• Crie um pedido 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 conversacional. Se estiver definido como DISABLED, não é fornecida nenhuma pergunta de seguimento.

• Preencha SearchParams no pedido de pesquisa conversacional. Os parâmetros de pesquisa devem ser os mesmos que os da chamada da API Search.

Pedido de API de conversação

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

A sua resposta da API Conversational tem o seguinte aspeto:

Pedido de API de conversação

{
  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 deve fazer com a resposta:

• conversation_id: este ID pode ser armazenado no armazenamento da sessão do navegador e pode ser usado para continuar a pesquisa conversacional com o servidor. Uma vez que um comprador pode ter vários separadores abertos com mais do que uma conversa, o conversation_id é usado para acompanhar as conversas.
• refined_query: identifica a consulta atual. Tem de usar esta resposta para chamar a API Search e obter os resultados dos produtos.
• followup_question: identifica a pergunta a apresentar ao utilizador.
• suggested_answers: uma lista ordenada das respostas de escolha múltipla que devem ser apresentadas aos utilizadores. Se quiser mostrar menos respostas, mostre apenas os primeiros N resultados. A lista é ordenada pela ordem em que os resultados devem ser apresentados.

Envie a consulta inicial do utilizador com a conversa ativada

Pedido de API de conversação

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

A pesquisa devolve parâmetros de conversa

Resposta da API de conversação

{
  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 com ConversationalFilteringResult, que é um proto que contém informações adicionais devolvidas do fluxo de conversa. O campo conversational_filtering_result em ConversationalSearchResponse fornece dados suplementares que são essenciais para a renderização da IU no lado do cliente. O campo conversational_filtering_result usa mensagens aninhadas, como SuggestedAnswer e AdditionalFilter, para estruturar os dados devolvidos de uma forma clara e compreensível. Esta estrutura hierárquica garante que as informações trocadas entre o cliente e o servidor estão bem definidas e são interpretáveis.
• As respostas sugeridas são ordenadas pelos valores de facetas no catálogo que foram mais frequentemente usados nos eventos do utilizador como filtros para todas as consultas. A ordenação usa o campo engagement_rate na pergunta de seguimento gerada pelo serviço ConversationalSearch. Este campo capta a taxa de interação histórica que o filtro mostra a partir dos eventos de pesquisa do retalhista enviados para o servidor.
• Todos os outros campos permanecem inalterados quando a conversa é usada.

O que fazer com o resultado inicial da pesquisa de conversa

• No lado do cliente, os programadores devem armazenar o conversation_id no armazenamento de sessão do navegador para que possa ser usado para continuar a pesquisa conversacional com o servidor.
• Isto é usado para acompanhar a conversa em curso, uma vez que um comprador pode ter vários separadores abertos com várias conversas em execução.

refined_query indica ao retalhista qual é a consulta atual.

• Isto deve ser usado se o retalhista quiser mostrar a consulta atual ao utilizador.

followup_question indica ao retalhista que pergunta apresentar ao utilizador

suggested_answers.

• Esta é uma lista ordenada das respostas de escolha múltipla que devem ser apresentadas aos utilizadores.
• Se quiser apresentar menos do que a lista completa, apresente apenas os primeiros N resultados
• Esta lista está ordenada e, por isso, tem de ser apresentada pela ordem correta. Por outras palavras, o primeiro resultado a ser apresentado é o primeiro da lista.

A filtragem de produtos conversacional apresenta estas opções para uma interação conversacional contínua, o que leva a um refinamento mais rápido da pesquisa:

Seleção do utilizador

Quando são apresentados resultados da pesquisa ao utilizador, este pode selecionar uma opção de escolha múltipla.

Este exemplo de código demonstra que o utilizador selecionou a resposta de escolha múltipla amarelo e que é enviado um novo pedido de conversa para a API Search enviando novamente a consulta juntamente com o filtro de utilizador correto aplicado.

Pedido de API de pesquisa

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

Para enviar um pedido para a API Conversacional:

1. Restaure o conversation_id a partir do armazenamento da sessão.
2. Definir mode como CONVERSATIONAL_FILTER_ONLY.
3. Defina user_answer para o que o utilizador selecionar.

Pedido de API de conversação

{
  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 tem o seguinte aspeto:

Resposta da API de conversação

{
  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 deve fazer com a resposta:

• A resposta da Google é basicamente idêntica à resposta à primeira consulta, exceto que o campo additional_filter pode ser usado para selecionar a caixa de filtro para color = yellow e deve ser adicionado a quaisquer outros filtros que o utilizador tenha selecionado.
• O additional_filter também deve ser adicionado ao evento de campo de filtro enviado à Google para esta consulta de seguimento e o pedido de pesquisa de seguimento. Deve ser aplicada no pedido de pesquisa para obter produtos de pesquisa e também deve ser aplicada no pedido de pesquisa conversacional para obter a conversa de seguimento.
• O refined_query deve ser enviado para a API Search para obter produtos mais relevantes.