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 comporter qu'une seule présentation audio à la fois. Cette page explique comment créer et supprimer des présentations audio.

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

Un résumé audio diffère d'un podcast de plusieurs façons :

• 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, il vous suffit d'un projet Google Cloudactivé 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 méthode notebooks.audioOverviews.create. É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 déjà de résumé audio.

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 : région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :
  • us- pour la multirégion des États-Unis
  • eu- pour la multirégion de l'UE
  • global- pour l'emplacement "Global"
  Pour en savoir plus, consultez Spécifier une multirégion pour votre datastore.
• PROJECT_NUMBER : numéro de votre projet Google Cloud .
• 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 l'aperçu audio. 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 contenus à mettre en avant dans l'aperçu audio.
• LANGUAGE_CODE : code de langue dans lequel l'aperçu 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 l'aperçu audio généré, procédez comme suit :

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

2. Dans l'onglet Studio de votre notebook, cliquez sur Charger pour charger la conversation. Le chargement de l'aperçu prend quelques instants.

   Dans le studio, vous pouvez gérer votre résumé audio en effectuant des 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 aperçu audio existant, appelez la méthode 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" \

Remplacez les éléments suivants :

• ENDPOINT_LOCATION : région multirégionale pour votre requête API. Attribuez l'une des valeurs suivantes :
  • us- pour la multirégion des États-Unis
  • eu- pour la multirégion de l'UE
  • global- pour l'emplacement "Global"
  Pour en savoir plus, consultez Spécifier une multirégion pour votre datastore.
• PROJECT_NUMBER : numéro de votre projet Google Cloud .
• 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.