Gestire il riassunto audio del notebook (API)

Dopo aver creato il notebook e aggiunto le origini dati, puoi generare programmaticamente un riepilogo audio del notebook. In un determinato momento, un notebook può avere una sola panoramica audio. Questa pagina descrive come creare ed eliminare riassunti audio.

Differenza tra una panoramica audio e un podcast

Un'overview audio differisce da un podcast per i seguenti motivi:

  • Una panoramica audio deve essere associata a un notebook a cui sono state aggiunte origini dati. D'altra parte, un podcast può essere generato senza un notebook NotebookLM Enterprise, una licenza Gemini Enterprise o un datastore. Per creare un podcast, ti servono solo un progetto Google Cloud abilitato e il ruolo Utente API Podcast.
  • Per creare un riassunto audio, chiama il metodo notebooks.audioOverview. Per creare un podcast, chiama il metodo podcasts, un'API autonoma.

Crea un’overview audio

Per generare un riassunto audio dei contenuti del notebook, chiama il metodo notebooks.audioOverviews.create. Poiché puoi avere un solo riassunto audio per notebook, questo metodo ha esito positivo solo se il notebook non ha un riassunto audio esistente.

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"
  }

Sostituisci quanto segue:

  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
  • PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
  • LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.
  • NOTEBOOK_ID: l'identificatore univoco del blocco note.
  • SOURCE_ID: l'ID dell'origine in base alla quale vuoi generare la panoramica audio. sourceIdsfield è un array facoltativo; se non specifichi ID origine, vengono utilizzate tutte le origini del notebook. Per informazioni sull'ID origine, vedi Aggiungere e gestire origini dati in un blocco note (API).
  • EPISODE_FOCUS: una stringa che descrive quali argomenti o contenuti devono essere evidenziati nel riepilogo audio.
  • LANGUAGE_CODE: il codice lingua in cui è stata richiesta la panoramica audio.

Se la richiesta ha esito positivo, dovresti ricevere una risposta JSON simile alla seguente. Questa risposta mostra che la generazione dell'overview audio è in corso.

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

La generazione di un riassunto audio richiede alcuni minuti.

Verificare un riassunto audio generato

Per verificare l'overview audio generata:

  1. Apri il notebook. Per saperne di più, consulta Accedere al notebook creato.

  2. In Studio del notebook, fai clic su Carica per caricare la conversazione. Il caricamento della panoramica richiede qualche istante.

    Nello studio, puoi gestire l'overview audio con attività come la modifica della velocità di riproduzione e il download o l'eliminazione del file dell'overview audio.

Eliminare un overview audio

Per eliminare un'overview audio esistente, chiama il metodo 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" \

Sostituisci quanto segue:

  • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
    • us- per la multiregione Stati Uniti
    • eu- per la multiregione EU
    • global- per la località globale
    Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
  • PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
  • LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.
  • NOTEBOOK_ID: l'identificatore univoco del blocco note.

Se la richiesta riesce, dovresti ricevere un JSON vuoto.