Divisor personalizado
El divisor personalizado se diseñó para dividir documentos compuestos (documentos compuestos por varias clases) en varios documentos de una sola clase con la identificación de cada documento lógico. Por ejemplo, un paquete hipotecario contiene varias clases dentro de él, como la aplicación, la verificación de ingresos y el ID con foto. Los procesadores de divisores personalizados se pueden usar de inmediato o entrenar desde cero con tus propios documentos y clases personalizadas.
Descripción y uso del divisor
Puedes crear divisores personalizados que se adapten específicamente a tus documentos y que se entrenen y evalúen con tus datos, o bien implementar modelos entrenados previamente con IA generativa. Estos procesadores identifican clases de documentos a partir de un conjunto de clases definido por el usuario. Luego, puedes usar estos procesadores en tus documentos. Por lo general, usarías un divisor personalizado en archivos compuestos por diferentes tipos de documentos lógicos y, luego, usarías la identificación de clase de cada uno para pasar los documentos a un procesador de extracción adecuado para extraer las entidades.
Debido a que los modelos del AA no son perfectos y tienen una cierta tasa de error, y a que los errores en la división suelen ser muy problemáticos (una división incorrecta hace mal dos documentos y causa errores de extracción), se recomienda tener siempre un paso de revisión manual después de la predicción de división, pero antes de la división del archivo real. Según los requisitos empresariales, existen alternativas a la revisión manual en todo momento:
- Usa las puntuaciones de confianza en la predicción para decidir si omites la revisión manual (si es lo suficientemente alta). Ese umbral de puntuación de confianza debe determinarse en función de los datos históricos sobre las tasas de error en determinadas puntuaciones de confianza. Esta debería ser una decisión empresarial basada en la tolerancia del proceso empresarial para errores y el requisito de evitar la revisión manual.
- En algunos casos de uso, los documentos divididos se pueden enrutar directamente al extractor apropiado según la clase predicha. Luego, si la extracción está incompleta o tiene puntuaciones de confianza bajas, aísla los documentos divididos y activa el documento compuesto original y la decisión de división para que se revisen. Esto tiene requisitos de flujo de trabajo bastante complejos.
Versiones del modelo de divisor personalizado
Los siguientes modelos están disponibles para el divisor personalizado. Para cambiar las versiones del modelo, consulta Administra versiones de procesadores.
La versión 1.5 admite puntuaciones de confianza.
| Versión del modelo | Descripción | Canal de versiones | Fecha de lanzamiento |
|---|---|---|---|
pretrained-splitter-v1.5-2025-07-14 |
Es un modelo de GA potenciado por el LLM de Gemini 2.5 Flash. Este modelo entrenado previamente se puede usar sin entrenamiento previo. Admite la división y la clasificación sin ejemplos. | Estable | 14 de julio de 2025 |
pretrained-splitter-v1.6-2026-03-09 |
Es una versión candidata para lanzamiento potenciada por el LLM de Gemini 3.1 Flash. | Versión candidata para lanzamiento | 9 de marzo de 2026 |
pretrained-splitter-v1.6-pro-2026-03-09 |
Es una versión candidata para lanzamiento potenciada por el LLM de Gemini 3.1 Pro. | Versión candidata para lanzamiento | 9 de marzo de 2026 |
Para realizar una solicitud de aumento de cuota (QIR) para la cuota predeterminada de procesadores, sigue los pasos para solicitar un ajuste de cuota.
Elige una versión de separador personalizada
Cuando uses un divisor personalizado, entrena con tus propios datos o usa una versión entrenada previamente con IA generativa, como pretrained-splitter-v1.5-2025-07-14.
El proceso de entrenamiento puede tardar varias horas, pero te permite ajustar el modelo a las características específicas de tus datos. Las versiones entrenadas previamente se basan en los modelos de Gemini. Se pueden llevar a producción en menos tiempo o usar para iterar y probar rápidamente el esquema de etiquetado. No requieren un conjunto de datos de entrenamiento.
La siguiente guía se aplica a ambas versiones y, cuando los pasos varíen, se indicarán los diferentes pasos para cada una.
Crea un divisor personalizado en la consola de Google Cloud
En esta guía de inicio rápido, se describe cómo usar Document AI para crear y entrenar un divisor personalizado que divide y clasifique los documentos de adquisición. La mayor parte de la preparación del documento está lista, de modo que puedas enfocarte en crear un divisor personalizado.
El siguiente es un flujo de trabajo típico para crear y usar una versión base entrenada de un divisor personalizado:
- Crear un divisor personalizado en Document AI.
- Crear un conjunto de datos con un bucket de Cloud Storage vacío.
- Definir y crear el esquema del procesador (clases).
- Importar documentos.
- Asignar documentos a los conjuntos de entrenamiento y pruebas.
- Anotar los documentos de forma manual en Document AI Workbench o con tareas de etiquetado.
- Entrenar el procesador.
- Evaluar el procesador.
- Implementar el procesador.
- Probar el procesador.
- Usar el procesador en tus documentos.
El siguiente es un flujo de trabajo típico para crear y usar una versión previamente entrenada de un divisor personalizado:
- Crear un divisor personalizado en Document AI.
- Crear un conjunto de datos con un bucket de Cloud Storage vacío.
- Selecciona una versión del modelo entrenado previamente
- Definir y crear el esquema del procesador (clases).
- (Opcional) Importa documentos.
- (Opcional si deseas evaluar su rendimiento) Asigna documentos a los conjuntos de pruebas.
- (Opcional) Evalúa el procesador.
- Probar el procesador.
- Implementar el procesador.
- Usar el procesador en tus documentos.
Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:
Antes de comenzar
- Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Document AI, Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Document AI, Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Roles obligatorios
Para obtener los permisos que necesitas para crear un divisor personalizado, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
- Administrador de Document AI (
roles/documentai.admin) - Administrador de almacenamiento (
roles/storage.admin)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Crea un procesador
En la consola de Google Cloud , en la sección Document AI, ve a la página Workbench.
En Custom Document Splitter, selecciona
Crear procesador .
En el menú Crear procesador, ingresa un nombre para tu procesador, como
my-custom-document-splitter.
Selecciona la región más cercana a ti.
Selecciona Crear. Aparecerá la pestaña Processor Details.
Configura el conjunto de datos
Para entrenar este nuevo procesador, debes crear un conjunto de datos con datos de entrenamiento y de prueba a fin de ayudar al procesador a identificar los documentos que deseas dividir y clasificar.
Este conjunto de datos requiere una nueva ubicación para él. Puede ser un bucket de Cloud Storage vacío o una carpeta, o puedes permitir una ubicación administrada por Google (interna).
- Si deseas usar el almacenamiento administrado por Google, selecciona esa opción.
- Si deseas usar tu propio almacenamiento para usar claves de encriptación administradas por el cliente (CMEK), selecciona Especificaré mi propia ubicación de almacenamiento y sigue el procedimiento posterior.

Crea un bucket de Cloud Storage para el conjunto de datos
Ve a la pestaña
Entrenar del procesador.Selecciona Establecer la ubicación del conjunto de datos. Se te pedirá que selecciones o crees un bucket o una carpeta de Cloud Storage vacíos.

Selecciona Explorar para abrir la opción Seleccionar carpeta.
Haz clic en el ícono Crear un bucket nuevo y sigue las instrucciones para crear un bucket nuevo. Después de crear el bucket, aparecerá la página Seleccionar carpeta. Si deseas obtener más información para crear un bucket de Cloud Storage, consulta Buckets de Cloud Storage.
En la página Seleccionar carpeta de tu bucket, elige el botón Seleccionar en la parte inferior del diálogo.

Asegúrate de que la ruta de destino se propague con el nombre del bucket que seleccionaste. Seleccione Crear conjunto de datos. La creación del conjunto de datos puede tardar varios minutos.
(Opcional) Selecciona una versión del modelo entrenado previamente
Si decidiste usar un modelo entrenado previamente, primero debes seleccionarlo en la sección Implementación y uso. Puedes ignorar las secciones posteriores a la siguiente, "Define el esquema del procesador".
Navega a Implementación y uso.