Administra el resumen de audio de tu notebook (API)

Después de crear tu cuaderno y agregarle fuentes de datos, puedes generar de forma programática un resumen de audio del cuaderno. A la vez, un cuaderno determinado solo puede tener 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 se diferencia de un podcast de las siguientes maneras:

  • Un resumen de audio debe estar asociado a un cuaderno al que se le hayan agregado fuentes de datos. Por otro lado, se puede generar un podcast sin un cuaderno de Gemini Notebook Enterprise, una licencia de Gemini Enterprise o un almacén de datos. Para crear un podcast, solo necesitas un proyecto de Google Cloud habilitado 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.

Usa el extremo multirregional de EE.UU.

Si tu suscripción a Gemini Notebook Enterprise se encuentra en la multirregión de EE.UU., puedes enviar las solicitudes de esta página al extremo multirregional de EE.UU., discoveryengine.us.rep.googleapis.com. Un extremo multirregional procesa tus solicitudes y finaliza TLS dentro de la multirregión, por lo que los datos de tu solicitud permanecen en EE.UU. mientras están en tránsito. El uso de este extremo no cambia la ubicación en la que se almacenan tus notebooks. Para obtener más información, consulta Descripción general de los extremos de API regionales y multirregionales en la guía de seguridad de Google Cloud.

Para usar el extremo multirregional de EE.UU., realiza los siguientes cambios en cada URL de solicitud de esta página:

  1. Reemplaza el host ENDPOINT_LOCATION-discoveryengine.googleapis.com por discoveryengine.us.rep.googleapis.com.

  2. Establece LOCATION en us.

El resto de cada solicitud permanece igual. Para obtener información sobre cómo elegir la multirregión de tu suscripción, consulta Obtén una suscripción. Para obtener la lista de extremos de servicio regionales y multirregionales, consulta Extremos de servicio regionales y multirregionales en la guía de la nube privada virtual.

Crear un resumen de audio

Para generar un resumen de audio del contenido de tu cuaderno, llama al método notebooks.audioOverviews.create. Como solo puedes tener un resumen de audio por notebook, este método solo tiene éxito 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 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 proyecto de Google Cloud .
  • LOCATION: 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 la que quieres basarte para generar el resumen de audio. sourceIdsfield es un array opcional. Si no especificas ningún ID de fuente, se usarán todas las fuentes del cuaderno. 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 recibir 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 Studio de tu cuaderno, haz clic en Cargar para cargar la conversación. La carga del resumen tarda unos minutos.

    En Studio, 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.

Cómo borrar un resumen de audio

Para borrar un resumen de audio existente, llama al método 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" \

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 proyecto de Google Cloud .
  • LOCATION: 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.