Gestire l'overview 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 notebook può avere un solo riassunto audio alla volta. Questa pagina descrive come creare ed eliminare overview audio.

Differenza tra un'overview audio e un podcast

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

  • Un'overview audio deve essere associata a un notebook a cui sono state aggiunte origini dati. D'altra parte, è possibile generare un podcast senza un notebook Gemini Notebook Enterprise, una licenza Gemini Enterprise o un datastore. Per creare un podcast, devi solo avere un progetto Google Cloud abilitato e il ruolo Podcast API User.
  • Per creare un'overview audio, chiama il metodo notebooks.audioOverview. Per creare un podcast, chiama il metodo podcasts, un'API autonoma.

Utilizza l'endpoint multiregionale Stati Uniti

Se il tuo abbonamento a Gemini Notebook Enterprise si trova nella multi-regione Stati Uniti, puoi inviare le richieste in questa pagina all'endpoint multi-regionale Stati Uniti, discoveryengine.us.rep.googleapis.com. Un endpoint multiregionale elabora le tue richieste e termina TLS all'interno della multi-regione, in modo che i dati delle richieste rimangano negli Stati Uniti mentre sono in transito. L'utilizzo di questo endpoint non modifica la posizione in cui sono archiviati i tuoi notebook. Per saperne di più, consulta la panoramica degli endpoint API regionali e multiregionali nella guida alla sicurezza di Google Cloud.

Per utilizzare l'endpoint multiregionale degli Stati Uniti, apporta le seguenti modifiche a ogni URL di richiesta in questa pagina:

  1. Sostituisci l'host ENDPOINT_LOCATION-discoveryengine.googleapis.com con discoveryengine.us.rep.googleapis.com.

  2. Imposta LOCATION su us.

Il resto di ogni richiesta rimane invariato. Per scoprire come scegliere la località multiregionale dell'abbonamento, consulta Ottieni un abbonamento. Per l'elenco degli endpoint di servizio regionali e multiregionali, consulta Endpoint di servizio regionali e multiregionali nella guida di Virtual Private Cloud.

Crea un'overview audio

Per generare un'overview audio per i contenuti del tuo 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 località multiregionale 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 progetto Google Cloud .
  • 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 della fonte in base alla quale vuoi generare l'overview audio. sourceIdsfield è un array facoltativo. Se non specifichi alcun ID origine, vengono utilizzate tutte le origini nel notebook. Per informazioni sull'ID origine, consulta Aggiungi e gestisci origini dati in un notebook (API).
  • EPISODE_FOCUS: una stringa che descrive quali argomenti o contenuti devono essere evidenziati nell'overview audio.
  • LANGUAGE_CODE: il codice lingua in cui è stato richiesto l'overview 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'overview audio richiede alcuni minuti.

Verifica un'overview audio generata

Per verificare l'overview audio generata, segui questi passaggi:

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

  2. In Studio del notebook, fai clic su Carica per caricare la conversazione. Il caricamento della panoramica 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.

Elimina 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 località multiregionale 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 progetto Google Cloud .
  • 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.