Gerenciar o resumo em áudio do notebook (API)

Depois de criar o notebook e adicionar fontes de dados a ele, é possível gerar programaticamente um Resumo em Áudio do notebook. Um notebook pode ter apenas um Resumo em Áudio por vez. Esta página descreve como criar e excluir Resumos em Áudio.

Diferença entre um Resumo 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 a ele. Por outro lado, um podcast pode ser gerado sem um notebook do Gemini Notebook Enterprise, uma licença do Gemini Enterprise ou um repositório de dados. Para criar um podcast, tudo o que você precisa é de um projeto ativado Google Cloud 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 no notebook, chame o notebooks.audioOverviews.create método. Como você só pode 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. Especifique 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 Google Cloud projeto.
  • 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 o Resumo em Áudio. O sourceIdsfield é uma matriz opcional. Se você não especificar nenhum ID de origem, todas as fontes 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 no Resumo em Áudio.
  • LANGUAGE_CODE: o código do idioma em que o Resumo em Áudio foi solicitado.

Se a solicitação for bem-sucedida, você 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"
    }
  }

Leva alguns minutos para gerar um Resumo em Áudio.

Verificar um Resumo em Áudio gerado

Para verificar o Resumo em Áudio gerado, 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 carregar a conversa. Leva alguns instantes para carregar a visão geral.

    No estúdio, é possível gerenciar o Resumo em Áudio com tarefas como mudar a velocidade do vídeo e baixar ou excluir o arquivo do Resumo em Áudio.

Excluir um Resumo em Áudio

Para excluir um Resumo em Áudio, chame o notebooks.audioOverviews.delete método.

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. Especifique 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 Google Cloud projeto.
  • 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ê receberá um JSON vazio.