Receber snippets e conteúdo extraído

A Pesquisa de agentes pode fornecer snippets de pesquisa, respostas extrativas e segmentos extrativos com cada resposta de pesquisa para melhorar seus resultados.

  • Snippets: um snippet é um breve trecho de texto do documento de resultado da pesquisa que fornece uma prévia do conteúdo de um resultado de pesquisa. Ele inclui o destaque de correspondência que pode ser renderizado na sua UI. Os snippets geralmente são exibidos abaixo de cada resultado da pesquisa para ajudar os usuários finais a avaliar a relevância e a utilidade desse resultado. Os snippets estão disponíveis para repositórios de dados com dados não estruturados e dados de sites (pesquisa básica de sites e indexação avançada de sites).

  • Respostas extrativas: uma resposta extrativa é um texto literal retornado com cada resultado da pesquisa. Ele é extraído diretamente do documento original. As respostas extrativas geralmente são exibidas na parte de cima das páginas da Web para fornecer ao usuário final uma resposta breve que seja contextualmente relevante para a consulta. As respostas extrativas estão disponíveis para repositórios de dados com dados não estruturados e com indexação avançada de sites.

  • Segmentos extrativos: um segmento extrativo é um texto literal retornado com cada resultado da pesquisa. Um segmento extrativo geralmente é mais detalhado do que uma resposta extrativa. Os segmentos extrativos podem ser exibidos como uma resposta a uma consulta e podem ser usados para realizar tarefas de pós-processamento e como entrada para modelos de linguagem grandes gerarem respostas ou novos textos. Os segmentos extrativos estão disponíveis para repositórios de dados com dados não estruturados e com indexação avançada de sites.

Exemplos

Os exemplos a seguir ajudam a ilustrar as diferenças entre snippets, respostas extrativas e segmentos extrativos.

Consulta : "o que é a Pesquisa de agentes?"

  • Snippet:

    Para ativar isso, estamos anunciando nossa nova Pesquisa de agentes, a maneira mais rápida para os desenvolvedores iniciarem a criação de apps generativos como bots, ...

  • Resposta extrativa:

    A Pesquisa de agentes permite que os desenvolvedores enviem rapidamente novas experiências, incluindo bots, interfaces de chat, mecanismos de pesquisa personalizados, assistentes digitais e muito mais. Os desenvolvedores têm acesso à API dos modelos de base do Google e podem usar modelos prontos para iniciar a criação de apps generativos em minutos ou horas.

  • Segmento extrativo:

    Empresas e governos também querem tornar as interações com clientes, parceiros e funcionários mais eficazes e úteis com essa nova tecnologia de IA. Para ativar isso, estamos anunciando nossa nova Pesquisa de agentes.

    A Pesquisa de agentes permite que os desenvolvedores enviem rapidamente novas experiências, incluindo bots, interfaces de chat, mecanismos de pesquisa personalizados, assistentes digitais e muito mais. Os desenvolvedores têm acesso à API dos modelos de base do Google e podem usar modelos prontos para iniciar a criação de apps generativos em minutos ou horas. Com a Pesquisa de agentes, os desenvolvedores também poderão:

    • Combinar dados organizacionais e técnicas de recuperação de informações para fornecer respostas relevantes.
    • Pesquisar e responder com mais do que apenas texto.
    • Combinar conversas naturais com fluxos estruturados.
    • Não apenas informar, mas também fazer transações.

Antes de começar

Dependendo do tipo de app que você tem, conclua os seguintes pré-requisitos:

Snippets

Os snippets são pequenos trechos extraídos literalmente de cada documento de resultado da pesquisa. Eles incluem o destaque de correspondência em tags HTML em negrito para renderizar prévias dos resultados da pesquisa em uma UI. Normalmente, os snippets são renderizados como texto de prévia abaixo de um resultado da pesquisa para ajudar os usuários finais a decidir se clicar nesse resultado será útil.

Os snippets estão disponíveis para pesquisa não estruturada e de sites.

Receber snippets

Para receber snippets:

  1. Envie uma solicitação de pesquisa que inclua ContentSearchSpec.SnippetSpec e defina returnSnippet como verdadeiro.

    O exemplo a seguir de SnippetSpec especifica que um snippet pode ser retornado para cada resultado da pesquisa.

    "contentSearchSpec":
{
  "snippetSpec":
  {
    "returnSnippet": true
  }
}
    • returnSnippet: se definido como true, retorna um snippet.

  2. Receba snippets da resposta da pesquisa. Os snippets são retornados com cada resultado da pesquisa em derivedStructData.snippets.

    Neste exemplo de um documento retornado como um dos resultados em uma resposta de pesquisa, um snippet com destaque de correspondência em negrito está incluído no resultado:

    {
  "id": "54321",
  "document": {
    "name": "projects/123/locations/global/collections/default_collection/dataStores/example-datastore/branches/0/documents/54321",
    "id": "54321",
    "derivedStructData": {
      "link": "gs://cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs/2008_google_annual_report.pdf",
      "snippets": [
        {
          "snippet": "Google Chrome. Google Chrome is an open-source browser that combines a minimal design with technologies to make the web faster, safer, and easier to navigate.",
          "snippet_status": "SUCCESS"
        }
      ]
    }
  }
}
    • snippet: contém um snippet gerado para o resultado da pesquisa de documentos. O destaque de correspondência está incluído em tags HTML em negrito.
    • snippet_status: se um snippet for gerado, esse campo será retornado como SUCCESS. Se nenhum snippet for gerado, esse campo será retornado como NO_SNIPPET_AVAILABLE.

Respostas extrativas

Uma resposta extrativa é uma seção de texto derivada literalmente de um documento. Quando um documento é retornado como um resultado da pesquisa em uma resposta de pesquisa, uma resposta extrativa relevante pode ser retornada com esse resultado.

Uma resposta extrativa pode ser um texto, como um parágrafo, uma tabela ou uma lista com marcadores, extraído do documento de resultado da pesquisa. As respostas extrativas são mais curtas do que os segmentos extrativos.

As respostas extrativas podem ser usadas como uma alternativa a respostas resumidas em casos em que respostas literais e precisas são preferíveis a resumos reformulados.

As respostas extrativas estão disponíveis para repositórios de dados com dados não estruturados e com indexação avançada de sites.

Receber respostas extrativas

Para receber respostas extrativas:

  1. Envie uma solicitação de pesquisa que use ContentSearchSpec.extractiveContentSpec para especificar maxExtractiveAnswerCount.

    O exemplo a seguir de extractiveContentSpec especifica que uma resposta pode ser retornada para cada resultado da pesquisa.

    "contentSearchSpec":
{
  "extractiveContentSpec": {
    "maxExtractiveAnswerCount": 1
  }
}
    • maxExtractiveAnswerCount: o número de respostas extrativas a serem retornadas para cada resultado da pesquisa. O valor padrão é 0 e o máximo é 5.

  2. Receba respostas extrativas da resposta da pesquisa. As respostas extrativas são retornadas com cada resultado da pesquisa em extractive_answers.

    Neste exemplo de um documento retornado como um dos resultados em uma resposta de pesquisa, uma resposta extrativa foi incluída no resultado:

    {
  "id": "54321",
  "document": {
    "name": "projects/123/locations/global/collections/default_collection/dataStores/example-datastore/branches/0/documents/54321",
    "id": "54321",
    "derivedStructData": {
      "extractive_answers": [
        {
          "pageNumber": "2",
          "content": "Google saw growth throughout the year both in our domestic business and internationally, both on Google owned sites and on the Google Network. Specifically, revenues from Google owned sites increased 101% on a year over year basis, from $792 million to $1.6 billion."
        }
      ],
      "link": "gs://cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs/2004Q4_earnings_google.pdf"
    }
}
}
    • pageNumber: se os números de página puderem ser extraídos do documento, esse campo indicará de onde a resposta foi extraída.
    • content: o conteúdo da resposta extrativa.

Segmentos extrativos

Um segmento extrativo é uma seção de texto extraída literalmente de um documento de resultado da pesquisa. Os segmentos extrativos são semelhantes às respostas extrativas, mas geralmente são mais completos e detalhados. Normalmente, os segmentos extrativos são usados como entrada para seus próprios LLMs gerarem respostas ou novos textos.

Os segmentos extrativos podem ser vários parágrafos, incluindo texto formatado, como tabelas e listas com marcadores.

Os segmentos extrativos estão disponíveis para repositórios de dados com dados não estruturados e com indexação avançada de sites.

Opções de segmentos extrativos

As seguintes opções estão disponíveis para segmentos extrativos:

  • Número de segmentos: é possível especificar até 10 segmentos extrativos a serem retornados para cada resultado da pesquisa.

  • Pontuações de relevância: as pontuações de relevância são baseadas na similaridade da consulta ao segmento extraído. É possível especificar que os segmentos extrativos sejam retornados com pontuações de relevância. As pontuações variam de -1,0 (menos relevante) a 1,0 (mais relevante). Ativar as pontuações de relevância pode aumentar a latência.

  • Segmentos adjacentes: é possível definir numPreviousSegments e numNextSegments para receber até três segmentos imediatamente antes e depois do segmento relevante. Os segmentos adjacentes podem adicionar contexto e precisão ao segmento relevante.

    Ativar segmentos adjacentes pode aumentar a latência.

Receber segmentos extrativos

As etapas a seguir mostram como receber segmentos extrativos para dados não estruturados. Siga etapas semelhantes para receber segmentos extrativos para dados de sites.

  1. Envie uma solicitação de pesquisa que use ContentSearchSpec.extractiveContentSpec para especificar maxExtractiveSegmentCount.

    O exemplo a seguir de extractiveContentSpec especifica que um segmento pode ser retornado para cada resultado da pesquisa.

    "contentSearchSpec":
{
  "extractiveContentSpec": {
    "maxExtractiveSegmentCount": 1
  }
}
    • maxExtractiveSegmentCount: o número de segmentos extrativos a serem retornados para cada resultado da pesquisa. O valor padrão é 0 e o máximo é 10.

    Outras opções:

    • returnExtractiveSegmentScore: defina como true para retornar uma pontuação de relevância com cada segmento retornado.
    • numPreviousSegments: o número de segmentos adjacentes a serem retornados antes do segmento relevante. O valor padrão é 0 e o máximo é 3. O uso de segmentos adjacentes pode aumentar a latência.
    • numNextSegments: o número de segmentos adjacentes a serem retornados após o segmento relevante. O valor padrão é 0 e o máximo é 3. O uso de segmentos adjacentes pode aumentar a latência.

    Para mais informações sobre essas opções, consulte Opções de segmentos extrativos.

  2. Receba segmentos da resposta da pesquisa. Os segmentos são retornados com cada resultado da pesquisa em extractive_segments.

    Neste exemplo de um documento retornado como um dos resultados em uma resposta de pesquisa, um segmento foi incluído no resultado:

    {
  "id": "54321",
  "document": {
    "name": "projects/123/locations/global/collections/default_collection/dataStores/example-datastore/branches/0/documents/54321",
    "id": "54321",
    "derivedStructData": {
      "extractive_segments": [
        {
          "pageNumber": "2",
          "content": "Client\nGoogle Toolbar. Google Toolbar is a free application that adds a Google search box to web browsers (Internet\nExplorer and Firefox) and improves user web experience through features such as a pop-up blocker that blocks\npop-up advertising, an autofill feature that completes web forms with information saved on a user's computer, and\ncustomizable buttons that let users search their favorite web sites and stay updated on their favorite feeds.\n\nGoogle Chrome. Google Chrome is an open-source browser that combines a minimal design with\ntechnologies to make the web faster, safer, and easier to navigate.\nGoogle Pack. Google Pack is a free collection of safe, useful software programs from Google and other\ncompanies that improve the user experience online and on the desktop. It includes programs that help users\nbrowse the web faster, remove spyware and viruses.\n\nPicasa. Picasa is a free service that allows users to view, manage and share their photos. Picasa enables users\nto import, organize and edit their photos, and upload them to Picasa Web Albums where the photos can be shared\nwith others on the internet.\n\nGoogle Desktop. Google Desktop lets people perform a full-text search on the contents of their own\ncomputer, including email, files, instant messenger chats and web browser history. Users can view web pages they\nhave visited even when they are not online. Google Desktop also includes a customizable Sidebar that includes\nmodules for weather, stock tickers and news.\n\n5"
        }
      ],
      "link": "gs://cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs/2004Q4_earnings_google.pdf"
    }
}
}
    • pageNumber: se os números de página puderem ser extraídos do documento, esse campo indicará de onde a resposta foi extraída.
    • content: o conteúdo do segmento extrativo.

A seguir