Gestire il riassunto audio del notebook (API)

Dopo aver creato il notebook e aver aggiunto le origini dati, puoi generare in modo programmatico un'overview audio del notebook. Un determinato notebook può avere una sola overview audio alla volta. Questa pagina descrive come creare ed eliminare le overview audio.

Differenza tra un'overview audio e un podcast

Un'overview audio è diversa da un podcast nei seguenti modi:

  • Un'overview 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 abilitato Google Cloud e il ruolo Utente API Podcast.
  • Per creare un'overview audio, chiama il metodo notebooks.audioOverview. Per creare un podcast, chiama il metodo podcasts, un'API autonoma.

Creare un'overview audio

Per generare un'overview audio per i contenuti del notebook, chiama il notebooks.audioOverviews.create metodo. Poiché puoi avere una sola overview audio per notebook, questo metodo ha esito positivo solo se il notebook non ha un'overview 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 multi-regione per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
  • LOCATION: la posizione geografica del datastore, ad esempio global. Per saperne di più, consulta Località.
  • NOTEBOOK_ID: l'identificatore univoco del notebook.
  • SOURCE_ID: l'ID dell'origine in base alla quale vuoi generare l'overview audio. Il sourceIdsfield è un array facoltativo; se non specifichi alcun ID origine, vengono utilizzate tutte le origini del notebook. Per informazioni sull'ID origine, vedi Aggiungere e gestire le origini dati in un notebook (API).
  • EPISODE_FOCUS: una stringa che descrive gli argomenti o i contenuti da evidenziare nell'overview audio.
  • LANGUAGE_CODE: il codice lingua in cui è stata richiesta l'overview audio.

Se la richiesta va a buon fine, dovresti ricevere una risposta JSON simile alla seguente. Questa risposta indica 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'overview audio richiede alcuni minuti.

Verificare un'overview audio generata

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 dell'overview richiede alcuni istanti.

    In 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 notebooks.audioOverviews.delete metodo.

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 multi-regione per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
  • LOCATION: la posizione geografica del datastore, ad esempio global. Per saperne di più, consulta Località.
  • NOTEBOOK_ID: l'identificatore univoco del notebook.

Se la richiesta va a buon fine, dovresti ricevere un JSON vuoto.