Administra el resumen de audio de tu notebook (API)

Después de crear tu notebook y agregarle fuentes de datos, puedes generar de forma programática un resumen en audio del notebook. En un momento dado, un notebook determinado puede tener solo un resumen en audio. En esta página, se describe cómo crear y borrar resúmenes en audio.

Diferencia entre un resumen en audio y un podcast

Un resumen en audio es diferente de un podcast de las siguientes maneras:

  • Un resumen en audio debe asociarse con un notebook al que se le agregaron fuentes de datos. Por otro lado, se puede generar un podcast sin un notebook de Gemini Notebook Enterprise, una licencia de Gemini Enterprise o un almacén de datos. Para crear un podcast, solo necesitas un proyecto habilitado Google Cloud y el rol de usuario de la API de Podcast.
  • Para crear un resumen en audio, llama al método notebooks.audioOverview. Para crear un podcast, llama al método podcasts, una API independiente.

Crea un resumen en audio

Para generar un resumen en audio del contenido de tu notebook, llama al notebooks.audioOverviews.create método. Debido a que solo puedes tener un resumen en audio por notebook, este método solo se realiza correctamente si el notebook no tiene un resumen en audio existente.

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

Reemplaza lo siguiente:

  • ENDPOINT_LOCATION: Es la multirregión para tu solicitud a la API. Especifica uno de los siguientes valores:
    • us para la multirregión de EE.UU.
    • eu para la multirregión de la UE
    • global para la ubicación global
    Para obtener más información, consulta Cómo especificar una multirregión para tu almacén de datos.
  • PROJECT_NUMBER: Es el número de tu Google Cloud proyecto.
  • LOCATION: Es la ubicación geográfica de tu almacén de datos, como global. Para obtener más información, consulta Ubicaciones.
  • NOTEBOOK_ID: Es el identificador único del notebook.
  • SOURCE_ID: Es el ID de la fuente en función de la cual deseas generar el resumen en audio. El sourceIdsfield es un array opcional. Si no especificas ningún ID de fuente, se usan todas las fuentes del notebook. Para obtener información sobre el ID de la fuente, consulta Agrega y administra fuentes de datos en un notebook (API).
  • EPISODE_FOCUS: Es una cadena que describe qué temas o contenido se deben destacar en el resumen en audio.
  • LANGUAGE_CODE: Es el código de idioma en el que se solicitó el resumen en audio.

Si la solicitud se realiza correctamente, deberías obtener una respuesta JSON similar a la siguiente. Esta respuesta muestra que la generación del resumen en audio está en curso.

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

La generación de un resumen en audio tarda unos minutos.

Verifica un resumen en audio generado

Para verificar el resumen en audio generado, haz lo siguiente:

  1. Abre tu notebook. Para obtener más información, consulta Accede al notebook creado.

  2. En el Studio de tu notebook, haz clic en Cargar para cargar la conversación. La carga del resumen tarda unos instantes.

    En el estudio, puedes administrar tu resumen en audio con tareas como cambiar la velocidad de reproducción y descargar o borrar el archivo de resumen en audio.

Borra un resumen en audio

Para borrar un resumen en audio existente, llama al notebooks.audioOverviews.delete método.

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

Reemplaza lo siguiente:

  • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
    • us para la multirregión de EE.UU.
    • eu para la multirregión de la UE
    • global para la ubicación global
    Para obtener más información, consulta Cómo especificar una multirregión para tu almacén de datos.
  • PROJECT_NUMBER: Es el número de tu Google Cloud proyecto.
  • LOCATION: Es la ubicación geográfica de tu almacén de datos, como global. Para obtener más información, consulta Ubicaciones.
  • NOTEBOOK_ID: Es el identificador único del notebook.

Si la solicitud se realiza correctamente, deberías obtener un JSON vacío.