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 de audio del notebook. En un momento dado, un notebook determinado puede tener solo un resumen de audio. En esta página, se describe cómo crear y borrar resúmenes de audio.

Diferencia entre un resumen de audio y un podcast

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

  • Un resumen de 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 de audio, llama al método notebooks.audioOverview. Para crear un podcast, llama al método podcasts, una API independiente.

Crea un resumen de audio

Para generar un resumen de audio del contenido de tu notebook, llama al notebooks.audioOverviews.create método. Debido a que solo puedes tener un resumen de audio por notebook, este método solo se realiza correctamente si el notebook no tiene un resumen de 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 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 región múltiple 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 de audio. El campo 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 de audio.
  • LANGUAGE_CODE: Es el código de idioma en el que se solicitó el resumen de 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 de 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 de audio tarda unos minutos.

Verifica un resumen de audio generado

Para verificar el resumen de 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 de audio con tareas como cambiar la velocidad de reproducción y descargar o borrar el archivo de resumen de audio.

Borra un resumen de audio

Para borrar un resumen de 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 región múltiple 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.