Configurar um repositório de dados do Bitly

Pré-lançamento público: os recursos de pesquisa e ações federadas estão no pré-lançamento público. Esse recurso está sujeito aos "Termos das soluções pré-GA" na seção Termos gerais de serviço dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Nesta página, descrevemos como criar um repositório de dados e conectar o Bitly ao Gemini Enterprise.

Antes de começar

Antes de configurar a conexão do Bitly, faça o seguinte:

1. Conceda o papel de editor do Discovery Engine (roles/discoveryengine.editor). Esse papel é necessário para que o usuário crie o repositório de dados. Para conceder esse papel:
   1. No Google Cloud console, acesse a página IAM.

      Acessar IAM

   2. Localize a conta de usuário e clique em editar Editar.
   3. Conceda o papel Discovery Engine Editor ao usuário. Para mais informações, consulte Papéis e permissões do IAM.

Observação:o Bitly usa o OAuth gerenciado pelo Google. Não é necessário criar seu próprio aplicativo OAuth nem fornecer um ID do cliente e uma chave secreta do cliente. Você autoriza o conector com sua conta do Bitly ao ativá-lo no app.

Criar o repositório de dados do Bitly

Para criar o repositório de dados do Bitly, siga estas etapas:

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

   Gemini Enterprise

2. Selecione ou crie um Google Cloud projeto.

3. No menu de navegação, selecione Repositório de dados.

4. Clique em Criar repositório de dados.

5. Na seção Origem, pesquise Bitly e clique em Selecionar.

6. Na seção Dados:

   1. Na seção Entidades para pesquisar, escolha quais entidades o Gemini Enterprise deve verificar. Para o Bitly, selecione Bitlinks.

7. Clique em Continuar.

8. Se o fluxo de criação do repositório de dados mostrar uma seção Opções avançadas, você poderá marcar a caixa de seleção Ativar endereços IP estáticos nela. Isso garante que o repositório de dados use um conjunto fixo de endereços IP para tráfego de saída, adequado para a lista de permissões no sistema de origem. Para mais informações, consulte Configurar a saída de IP estático.

9. Na seção Configuração:

   1. Na lista Multirregional, selecione o local do conector de dados.
   2. No campo Nome do conector de dados, insira um nome para o conector.
   3. Se você selecionou us ou eu como local, configure as Definições de criptografia:
      • Opcional: se você não tiver configurado chaves de região única, clique em Acessar a página de configurações para fazer isso. Para mais informações, consulte Registrar uma chave de região única para conectores de terceiros.
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

10. Clique em Continuar.

11. Na seção Faturamento, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte Verificar o status de faturamento dos seus projetos e Licenças.

12. Clique em Criar. O Gemini Enterprise cria e exibe os repositórios de dados na página Repositórios de dados.

Na página Repositórios de dados, clique no nome da repositório de dados para conferir o status. Depois que o estado do repositório de dados mudar de Criação para Ativo, o repositório de dados do Bitly estará pronto para uso.

Depois de criar o repositório de dados, conecte-o a um app atual ou crie um novo app e conecte-o ao novo app. Autorize o Gemini Enterprise a acessar o Bitly antes de executar qualquer consulta.

Tratamento de dados e execução de consultas

Esta seção descreve como o Gemini Enterprise gerencia sua consulta e as implicações de privacidade do uso do repositório de dados federado.

Execução da consulta

Depois de autorizar o Bitly e enviar uma consulta de pesquisa para o Gemini Enterprise:

• O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API do Bitly.
• O Gemini Enterprise combina os resultados com os de outras fontes de dados conectadas e mostra um resultado da pesquisa abrangente.

Processamento de dados

Ao usar a pesquisa federada de terceiros, as seguintes regras de tratamento de dados são aplicadas:

• Sua string de consulta é enviada para o back-end de pesquisa de terceiros (API do Bitly).
• Esses terceiros podem associar consultas à sua identidade.
• Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.
• Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema.

Observação:para melhorar a acurácia, um LLM pode reescrever sua consulta antes de enviá-la ao Bitly. Essa consulta reescrita pode incorporar informações do histórico de consultas da sua sessão. Como resultado, partes do seu histórico de consultas também podem ser incluídas na consulta enviada à API do Bitly.

A seguir

• Para fornecer uma interface do usuário para consultar seus dados do Bitly, crie um app e conecte-o ao repositório de dados do Bitly.
• Para ver como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa.
• Para ativar alertas para o repositório de dados, consulte Configurar alertas para repositórios de dados de terceiros.