Gerenciar o resumo em áudio do notebook (API)

Depois de criar o notebook e adicionar fontes de dados a ele, você pode gerar programaticamente uma visão geral em áudio do notebook. Um notebook específico pode ter apenas uma visão geral em áudio por vez. Esta página descreve como criar e excluir visões gerais em áudio.

Diferença entre uma visão geral em áudio e um podcast

Um Resumo em Áudio é diferente de um podcast das seguintes maneiras:

  • Um resumo em áudio precisa estar associado a um notebook com fontes de dados adicionadas. Por outro lado, um podcast pode ser gerado sem um notebook do NotebookLM Enterprise, uma licença do Gemini Enterprise ou um repositório de dados. Para criar um podcast, você só precisa de um projeto Google Cloud ativado e da função de usuário da API Podcast.
  • Para criar um Resumo em Áudio, chame o método notebooks.audioOverview. Para criar um podcast, chame o método podcasts, uma API independente.

Criar um Resumo em Áudio

Para gerar um resumo em áudio do conteúdo do seu notebook, chame o método notebooks.audioOverviews.create. Como só é possível ter um resumo em áudio por notebook, esse método só será bem-sucedido se o notebook não tiver um resumo em áudio.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

Substitua:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_NUMBER: o número do seu projeto Google Cloud .
  • LOCATION: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte Locais.
  • NOTEBOOK_ID: o identificador exclusivo do notebook.
  • SOURCE_ID: o ID da fonte com base na qual você quer gerar a visão geral em áudio. O sourceIdsfield é uma matriz opcional. Se você não especificar nenhum ID de origem, todas as origens no notebook serão usadas. Para informações sobre o ID da fonte, consulte Adicionar e gerenciar fontes de dados em um notebook (API).
  • EPISODE_FOCUS: uma string que descreve quais tópicos ou conteúdo precisam ser destacados na visão geral em áudio.
  • LANGUAGE_CODE: o código do idioma em que a visão geral do áudio foi solicitada.

Se a solicitação for bem-sucedida, você vai receber uma resposta JSON semelhante à seguinte. Essa resposta mostra que a geração do resumo em áudio está em andamento.

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

A geração de um resumo em áudio leva alguns minutos.

Verificar um Resumo em Áudio gerado

Para verificar a visão geral em áudio gerada, faça o seguinte:

  1. Abra o notebook. Para mais informações, consulte Acessar o notebook criado.

  2. No Studio do notebook, clique em Carregar para abrir a conversa. Isso leva alguns instantes.

    No studio, você pode gerenciar o Resumo em áudio com tarefas como mudar a velocidade de reprodução e baixar ou excluir o arquivo.

Excluir um Resumo em Áudio

Para excluir uma visão geral em áudio, chame o método notebooks.audioOverviews.delete.

REST

curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

Substitua:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_NUMBER: o número do seu projeto Google Cloud .
  • LOCATION: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte Locais.
  • NOTEBOOK_ID: o identificador exclusivo do notebook.

Se a solicitação for bem-sucedida, você vai receber um JSON vazio.