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

Après avoir créé votre notebook et y avoir ajouté des sources de données, vous pouvez générer un résumé audio du notebook par programmation. Un notebook donné ne peut avoir 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 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 Gemini Notebook Enterprise, licence Gemini Enterprise ni data store. Pour créer un podcast, vous avez simplement besoin 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.

Utiliser le point de terminaison multirégional aux États-Unis

Si votre abonnement Gemini Notebook Enterprise se trouve dans l'emplacement multirégional US, vous pouvez envoyer les requêtes de cette page au point de terminaison multirégional US, discoveryengine.us.rep.googleapis.com. Un point de terminaison multirégional traite vos requêtes et met fin au protocole TLS dans la zone multirégionale. Ainsi, les données de votre requête restent aux États-Unis pendant leur transit. L'utilisation de ce point de terminaison ne modifie pas l'emplacement de stockage de vos notebooks. Pour en savoir plus, consultez la section Présentation des points de terminaison d'API régionaux et multirégionaux dans le guide de sécurité Google Cloud.

Pour utiliser le point de terminaison multirégional des États-Unis, apportez les modifications suivantes à chaque URL de requête sur cette page :

  1. Remplacez l'hôte ENDPOINT_LOCATION-discoveryengine.googleapis.com par discoveryengine.us.rep.googleapis.com.

  2. Définissez LOCATION sur us.

Le reste de chaque requête reste inchangé. Pour savoir comment choisir l'emplacement multirégional de votre abonnement, consultez Souscrire un abonnement. Pour obtenir la liste des points de terminaison de service régionaux et multirégionaux, consultez Points de terminaison de service régionaux et multirégionaux dans le guide cloud privé virtuel.

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. Comme vous ne pouvez avoir qu'un seul résumé audio par notebook, cette méthode ne réussit que si le notebook ne contient pas 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 : 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 projet Google Cloud .
  • LOCATION : emplacement géographique de votre data store, par exemple global. Pour plus d'informations, consultez la section 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. 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 avant 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 à celle-ci. 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 de la vue d'ensemble 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 et 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 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 : 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 projet Google Cloud .
  • LOCATION : emplacement géographique de votre data store, par exemple global. Pour plus d'informations, consultez la section Emplacements.
  • NOTEBOOK_ID : identifiant unique du notebook.

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