Gérer le résumé audio de votre notebook (API)

Une fois que vous avez créé votre notebook et que vous y avez ajouté des sources de données, vous pouvez générer par programmation un résumé audio du notebook. Un notebook donné ne peut contenir qu'un seul résumé audio à la fois. Cette page explique comment créer et supprimer des résumés audio.

Différence entre un résumé audio et un podcast

Un résumé audio diffère d'un podcast des manières suivantes :

  • Un résumé audio doit être associé à un notebook auquel des sources de données ont été ajoutées. En revanche, un podcast peut être généré sans notebook NotebookLM Enterprise, sans licence Gemini Enterprise ni sans data store. Pour créer un podcast, vous n'avez besoin que d'un projet activé Google Cloud et du rôle Utilisateur de l'API Podcast.
  • Pour créer un résumé audio, appelez la méthode notebooks.audioOverview. Pour créer un podcast, appelez la méthode podcasts, une API autonome.

Créer un résumé audio

Pour générer un résumé audio du contenu de votre notebook, appelez la notebooks.audioOverviews.create méthode. Étant donné que vous ne pouvez avoir qu'un seul résumé audio par notebook, cette méthode ne fonctionne que si le notebook ne contient pas de résumé audio existant.

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

Remplacez les éléments suivants :

  • ENDPOINT_LOCATION : emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • PROJECT_NUMBER: numéro de votre Google Cloud projet.
  • LOCATION : emplacement géographique de votre data store, par exemple global. Pour en savoir plus, consultez Emplacements.
  • NOTEBOOK_ID : identifiant unique du notebook.
  • SOURCE_ID: ID de la source à partir de laquelle vous souhaitez générer le résumé audio. Le sourceIdsfield est un tableau facultatif. Si vous ne spécifiez aucun ID de source, toutes les sources du notebook sont utilisées. Pour en savoir plus sur l'ID de source, consultez Ajouter et gérer des sources de données dans un notebook (API).
  • EPISODE_FOCUS: chaîne décrivant les thèmes ou le contenu à mettre en évidence dans le résumé audio.
  • LANGUAGE_CODE: code de langue dans lequel le résumé audio a été demandé.

Si la requête aboutit, vous devriez obtenir une réponse JSON semblable à la suivante. Cette réponse indique que la génération du résumé audio est en cours.

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

La génération d'un résumé audio prend quelques minutes.

Vérifier un résumé audio généré

Pour vérifier le résumé audio généré, procédez comme suit :

  1. Ouvrez le notebook. Pour en savoir plus, consultez Accéder au notebook créé.

  2. Dans le Studio de votre notebook, cliquez sur Charger pour charger la conversation. Le chargement du résumé prend quelques instants.

    Dans le studio, vous pouvez gérer votre résumé audio à l'aide de tâches telles que la modification de la vitesse de lecture, le téléchargement ou la suppression du fichier de résumé audio.

Supprimer un résumé audio

Pour supprimer un résumé audio existant, appelez la notebooks.audioOverviews.delete méthode.

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

Remplacez les éléments suivants :

  • ENDPOINT_LOCATION : emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • PROJECT_NUMBER: numéro de votre Google Cloud projet.
  • LOCATION : emplacement géographique de votre data store, par exemple global. Pour en savoir plus, consultez Emplacements.
  • NOTEBOOK_ID : identifiant unique du notebook.

Si la requête aboutit, vous devriez obtenir un JSON vide.