Las versiones nuevas se lanzan por varios motivos, por ejemplo, para mejorar la exactitud, aumentar la disponibilidad y admitir elementos de documentos nuevos, como marcas de selección.
Dado que Document AI cuenta con la tecnología de la IA generativa, las versiones futuras usarán nuevos modelos de base para que puedas beneficiarte de las mejoras de la IA generativa.
A medida que mejoramos los modelos de base, los modelos de base anteriores quedan obsoletos. Del mismo modo, las versiones del procesador dejan de estar disponibles seis meses después del lanzamiento de las versiones nuevas.
Un procesador puede tener una de las siguientes versiones:
- Versión estable
- Versión candidata para lanzamiento (RC)
- Versión personalizada y su versión básica asociada
En esta página, se describe cómo se controlan las versiones de los procesadores y cómo ver y seleccionar una versión en particular.

Descripción general de las versiones de procesadores
Existen dos categorías de versiones de procesadores:
- Las versiones de Google son estables (para casos de uso de producción) o versiones candidatas (experimentales con la funcionalidad más reciente).
- Tú creas las versiones de usuario para personalizar las predicciones de tus documentos, y estas tienen IDs de versión alfanuméricos.
Versiones de Google
Cada versión de Google se identifica con un ID de versión, por ejemplo, pretrained-TYPE-vX.X-YYYY-MM-DD.
Cada versión del procesador que ofrece Google se denomina Google Stable o Google Versión candidata (RC).
Versiones estables de Google
Las versiones estables son de calidad de producción y están listas para usarse.
- Google prioriza la estabilidad del comportamiento del procesador, pero sigue incluyendo correcciones esenciales.
- Las versiones estables anteriores de Google dejan de estar disponibles seis meses después de que se lanza la versión estable más reciente, como se muestra en la siguiente figura.

Versiones candidatas para lanzamiento (RC) de Google
Las versiones candidatas son experimentales y se actualizan frecuentemente con las funciones más recientes. Estas no son versiones con calidad de producción, y su estabilidad puede variar.
Versiones personalizadas
Las versiones personalizadas son las versiones del procesador que puedes crear en función de tus
documentos para personalizar las predicciones.
Las versiones personalizadas tienen un Type, que muestra el tipo de modelo que se usa para las predicciones.
Si creas una versión con un modelo de base (ya sea creando una versión o
ajustando), el tipo es IA generativa. Si creas una versión del procesador
entrenando un modelo personalizado más pequeño (basado en un modelo o una plantilla), el
tipo es Personalizado. Si creas versiones del procesador, tú decides el nombre y el ID.
Versiones de base
Si creas una versión del procesador, la "versión base" muestra qué versión de Google potencia tu versión de usuario personalizada. La versión base dicta el ciclo de vida de tu versión de usuario. Debes tomar decisiones sobre cómo administrar el ciclo de vida de tu versión de usuario personalizada.
Versiones estables disponibles del procesador
Puedes revisar las versiones estables disponibles para los diferentes tipos de procesadores en las siguientes tablas.
| Extractor personalizado | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-foundation-model-v1.5-2025-05-05 |
5 de mayo de 2025 | No aplicable |
pretrained-foundation-model-v1.5-pro-2025-06-20 |
20 de junio de 2025 | No aplicable |
pretrained-foundation-model-v3.1-lite-2026-10-08 |
8 de octubre de 2026 | No aplicable |
| Analizador de formularios | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-form-parser-v1.0-2020-09-23 |
23 de septiembre de 2020 | No aplicable |
pretrained-form-parser-v2.0-2022-11-10 |
10 de noviembre de 2022 | No aplicable |
| Analizador de diseño | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-layout-parser-v1.0-2024-06-03 |
3 de junio de 2024 | No aplicable |
| Analizador de resúmenes de cuenta bancaria | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-bankstatement-v1.0-2021-08-08 |
8 de agosto de 2021 | No aplicable |
pretrained-bankstatement-v1.1-2021-08-13 |
13 agosto de 2021 | No aplicable |
pretrained-bankstatement-v2.0-2021-12-10 |
10 de diciembre de 2021 | No aplicable |
pretrained-bankstatement-v3.0-2022-05-16 |
16 de mayo de 2022 | No aplicable |
pretrained-bankstatement-v5.0-2023-12-06 |
6 de diciembre de 2023 | No aplicable |
| Analizador W2 | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-w2-v1.0-2020-10-01 |
1 de octubre de 2020 | 31 de marzo de 2024 |
pretrained-w2-v1.1-2022-01-27 |
27 de enero de 2022 | 31 de marzo de 2024 |
pretrained-w2-v1.2-2022-01-28 |
28 de enero de 2022 | No aplicable |
pretrained-w2-v2.1-2022-06-08 |
8 de junio de 2022 | No aplicable |
| Analizador de revisión de documentos de identidad | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-id-proofing-v1.0-2022-10-03 |
3 de octubre de 2022 | No aplicable |
| Analizador de comprobantes de pago | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-paystub-v1.0-2021-03-19 |
19 de marzo de 2021 | No aplicable |
pretrained-paystub-v1.1-2021-08-13 |
13 agosto de 2021 | No aplicable |
pretrained-paystub-v1.2-2021-12-10 |
10 de diciembre de 2021 | No aplicable |
pretrained-paystub-v2.0-2022-07-22 |
22 de julio de 2022 | No aplicable |
pretrained-paystub-v3.0-2023-12-06 |
6 de diciembre de 2023 | No aplicable |
| Analizador de licencias de conducir de EE.UU. | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-us-driver-license-v1.0-2021-06-14 |
14 de junio de 2021 | No aplicable |
| Analizador de gastos | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-expense-v1.1-2021-04-09 |
9 de abril de 2024 | No aplicable |
pretrained-expense-v1.4-2022-11-18 |
18 de noviembre de 2022 | No aplicable |
pretrained-expense-v1.4.2-2024-09-12 |
12 de septiembre de 2024 | No aplicable |
| Analizador de facturas | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-invoice-v1.1-2021-04-09 |
9 de abril de 2024 | No aplicable |
pretrained-invoice-v1.2-2022-02-18 |
18 de febrero de 2022 | No aplicable |
pretrained-invoice-v1.3-2022-07-15 |
15 de julio de 2022 | No aplicable |
pretrained-invoice-v2.0-2023-12-06 |
6 de diciembre de 2023 | No aplicable |
| Enterprise Document OCR (reconocimiento óptico de caracteres) | Fecha de lanzamiento | Fecha de baja |
|---|---|---|
pretrained-ocr-v1.2-2022-11-10 |
10 de noviembre de 2022 | No aplicable |
pretrained-ocr-v2.0-2023-06-02 |
2 de junio de 2023 | No aplicable |
pretrained-ocr-v2.1-2024-08-07 |
7 de agosto de 2024 | No aplicable |

Ciclo de vida de la versión del procesador
En cuanto esté disponible una nueva versión de Google, deberías crear y evaluar nuevas versiones de usuario con la nueva versión base. Luego, implementa la versión nueva y anula la implementación (o borra) las versiones de usuario anteriores que usen la versión estable anterior como base. Las versiones estables se descontinúan después de que se lanza una nueva. Google te avisará con al menos seis meses de anticipación cuando esto ocurra.
¿Qué sucede cuando se deja de usar una versión base?
Las versiones de usuario que dependen de versiones base anteriores dejan de mostrar predicciones cuando se deja de admitir la versión base.
¿Cómo se seleccionan las versiones del procesador para tus solicitudes?
Cuando llamas a un extremo de procesador sin especificar la versión del procesador, se usa la versión predeterminada. Cuando cambia la versión predeterminada del procesador, es posible que debas actualizar el código.
| Extremo usado | Experiencia |
|---|---|
| Si no especificas un ID de versión del procesador | Solicitudes procesadas con una nueva versión predeterminada del procesador Si tu versión predeterminada del procesador queda obsoleta, la versión predeterminada se actualiza a la versión estable de Google más reciente cuando la versión predeterminada anterior queda obsoleta. |
| Si especificas el ID de la versión del procesador | La respuesta falla si llamas a un extremo de procesador y especificas un ID de versión que se haya retirado. |
Ejemplo de baja de una versión personalizada
Considera la siguiente situación, en la que se describe la secuencia de eventos en la baja de una versión personalizada:
Como desarrollador, usas un extractor personalizado para obtener datos de documentos. Dada la complejidad y el volumen de los documentos que procesas, ajustas el modelo de base para crear una versión llamada
fine-tune-A. Estableces la versiónfine-tune-Acomo la versión predeterminada para tu procesador y la usas para procesar documentos. La versión base que potencia el modelofine-tune-Aes la versión establepretrained-foundation-model-v1.0-2023-08-22 (v1.0).Google publicó una nueva versión estable llamada
pretrained-foundation-model-v1.2-2024-05-10 (v1.2)y anunció que la versión establev1.0dejará de estar disponible el 9 de abril de 2025.Como conservaste los documentos de entrenamiento y prueba en el conjunto de datos de tu procesador, ajustas otra versión según la versión estable más reciente de Google,
v1.2, y la nombrasfine-tune-B. Después de evaluar su rendimiento, establece la versiónfine-tune-Bcomo la nueva versión predeterminada para tu procesador y retira la versiónfine-tune-A. Tu nueva versión ahora usa la versión estable de Google más reciente que se admite.
Por otro lado, si no hubieras creado y evaluado la versión personalizada de fine-tune-B,
Google habría actualizado la versión predeterminada de tu procesador a
v1.2 el 9 de abril de 2025. Como llamas al extremo del procesador y no especificas una versión del procesador, la nueva versión v1.2 se usa como la nueva versión predeterminada para procesar tus solicitudes.
Recursos de baja y migración
Para ver los analizadores y procesadores obsoletos, puedes consultar Bajas de Document AI.
Consulta los siguientes recursos para las migraciones:
Para crear y entrenar un nuevo analizador de gastos, puedes consultar enriquece el procesador previamente entrenado.
Para crear y ajustar un nuevo procesador de Extractor personalizado, consulta Extractor personalizado con IA generativa.
Selecciona una versión del procesador
Existen tres maneras de especificar qué versión del procesador usar para el procesamiento en línea y por lotes:
Si no especificas una versión, se usa la predeterminada del procesador.
- Ejemplo:
projects/my-proj/locations/us/processors/my-processor:process
- Ejemplo:
Si especificas una versión, se usará esa versión específica. Si la versión específica no existe, la solicitud falla con un error.
- Ejemplo:
projects/my-proj/locations/us/processors/my-processor/processorVersions/pretrained-invoice-v1.2-2022-02-18:process
- Ejemplo:
Si especificas un canal, se usa la versión más reciente de ese canal. (Opciones:
stable,rc)- Ejemplo:
projects/my-proj/locations/us/processors/my-processor/processorVersions/stable:process
- Ejemplo:
Ver versión disponible
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador cuyos detalles deseas ver.
Selecciona la pestaña Administrar versiones (o Implementar y usar), que mostrará todas las versiones disponibles del procesador.
REST
En este ejemplo, se muestra cómo enumerar las versiones disponibles para tu
procesador con el método processorVersions.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación del procesador, por ejemplo:
us- Estados Unidoseu: Unión Europea
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PROCESSOR_ID: Es el ID de tu procesador personalizado.
Método HTTP y URL:
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions" | Select-Object -Expand Content
La respuesta contiene una lista de
ProcessorVersions,
que incluye información sobre cada versión del procesador, como su
name, state y otros detalles.
{
"processorVersions": [
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",
"displayName": "Google Release Candidate",
"state": "DEPLOYED",
"createTime": "2022-09-13T23:39:12.156648Z",
"googleManaged": true
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.0-2020-09-23",
"displayName": "Google Stable",
"state": "DEPLOYED",
"createTime": "2022-09-12T23:35:09.829557Z",
"googleManaged": true,
"deprecationInfo": {
"deprecationTime": "1970-01-01T00:00:00Z"
}
}
]
}
C#
Para obtener más información, consulta la documentación de referencia de la API de Document AI para C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Consulta los detalles de una versión
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador cuyos detalles deseas ver.
Selecciona la pestaña Administrar versiones (o Implementar y usar), que mostrará todas las versiones disponibles del procesador y sus detalles.
REST
En este ejemplo, se muestra cómo obtener detalles sobre una versión de un procesador
con el método
processorVersions.get.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación del procesador, por ejemplo:
us- Estados Unidoseu: Unión Europea
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PROCESSOR_ID: Es el ID de tu procesador personalizado.
- PROCESSOR_VERSION: Es el identificador de la versión del procesador. Consulta Selecciona una versión del procesador para obtener más información. Por ejemplo:
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
Método HTTP y URL:
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION" | Select-Object -Expand Content
La respuesta es un objeto
ProcessorVersion,
que contiene información sobre la versión del procesador, como su
name, state y otros detalles.
{
"name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",
"displayName": "Google Release Candidate",
"state": "DEPLOYED",
"createTime": "2022-09-13T23:39:12.156648Z",
"googleManaged": true
}
C#
Para obtener más información, consulta la documentación de referencia de la API de Document AI para C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cambia la versión predeterminada
La versión predeterminada de un procesador indica la versión que se usa para procesar documentos cuando no especificas una versión en particular. Cuando creas un procesador, la versión predeterminada inicial es la última versión del canal estable.
Si cambias la versión predeterminada, las solicitudes entrantes se procesan con la versión recién seleccionada. Si cambias la versión predeterminada mientras el procesador está en medio de una solicitud, esta seguirá usando la versión seleccionada anteriormente.
Para cambiar la versión predeterminada, haz lo siguiente:
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador cuyos detalles deseas ver.
En la pestaña Administrar versiones (o Implementar y usar) del procesador, en el menú desplegable Versión predeterminada, elige una versión del procesador que quieras usar como la versión predeterminada.
REST
En este ejemplo, se muestra cómo establecer la versión predeterminada del procesador
con el método
processors.setDefaultProcessorVersion.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación del procesador, por ejemplo:
us- Estados Unidoseu: Unión Europea
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PROCESSOR_ID: Es el ID de tu procesador personalizado.
- PROCESSOR_VERSION: Es el identificador de la versión del procesador. Consulta Selecciona una versión del procesador para obtener más información. Por ejemplo:
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
Método HTTP y URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion
Cuerpo JSON de la solicitud:
{
"defaultProcessorVersion": "PROCESSOR_VERSION"
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion" | Select-Object -Expand Content
La respuesta es una operación de larga duración. Para sondear la operación de larga duración, llama a operations.get
El SetDefaultProcessorVersionMetadata en la respuesta indica el estado de la operación.
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.SetDefaultProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-03-02T22:52:49.957096Z",
"updateTime": "2022-03-02T22:52:50.175976Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.SetDefaultProcessorVersionResponse"
}
}
C#
Para obtener más información, consulta la documentación de referencia de la API de Document AI para C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Implementa una versión del procesador
Después de crear una nueva versión del procesador con Document AI, deberás implementarla antes de poder procesar documentos con esta versión.
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador cuyos detalles deseas ver.
En la pestaña Administrar versiones (o Implementar y usar) del procesador, selecciona la casilla de verificación junto a la versión del procesador que deseas implementar.
Haz clic en Implementar y, luego, vuelve a hacer clic en Implementar en la ventana de diálogo. Este proceso tarda unos minutos.
REST
En este ejemplo, se muestra cómo implementar una versión de procesador para tu
procesador con el método
processorVersions.deploy.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación del procesador, por ejemplo:
us- Estados Unidoseu: Unión Europea
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PROCESSOR_ID: Es el ID de tu procesador personalizado.
- PROCESSOR_VERSION: Es el identificador de la versión del procesador.
Método HTTP y URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy" | Select-Object -Expand Content
La respuesta es una operación de larga duración. Para sondear la operación de larga duración, llama a operations.get
El DeployProcessorVersionMetadata en la respuesta indica el estado de la operación.
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.DeployProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-08-29T16:27:00.195539Z",
"updateTime": "2022-08-29T16:32:01.963962Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.DeployProcessorVersionResponse"
}
}
C#
Para obtener más información, consulta la documentación de referencia de la API de Document AI para C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Anula la implementación de una versión del procesador
Después de crear una versión nueva del procesador con Document AI y de implementarla, puedes anular la implementación si no quieres que la versión del procesador pueda controlar las solicitudes de procesamiento.
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador cuyos detalles deseas ver.
En la pestaña Administrar versiones (o Implementar y usar) del procesador, selecciona la casilla de verificación junto a la versión del procesador cuya implementación deseas anular.
Haz clic en Anular la implementación y, luego, vuelve a hacer clic en Anular la implementación en la ventana de diálogo. Este proceso tarda unos minutos.
REST
En este ejemplo, se muestra cómo anular la implementación de una versión del procesador con el método
processorVersions.undeploy.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación del procesador, por ejemplo:
us- Estados Unidoseu: Unión Europea
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PROCESSOR_ID: Es el ID de tu procesador personalizado.
- PROCESSOR_VERSION: Es el identificador de la versión del procesador.
Método HTTP y URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy" | Select-Object -Expand Content
La respuesta es una operación de larga duración. Para sondear la operación de larga duración, llama a operations.get
El UndeployProcessorVersionMetadata en la respuesta indica el estado de la operación.
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.UndeployProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-08-29T16:27:00.195539Z",
"updateTime": "2022-08-29T16:32:01.963962Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.UndeployProcessorVersionResponse"
}
}
C#
Para obtener más información, consulta la documentación de referencia de la API de Document AI para C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Borra una versión del procesador
Después de crear una nueva versión del procesador con Document AI, puedes borrarla si ya no la necesitas.
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador cuyos detalles deseas ver.
En la pestaña Administrar versiones (o Implementar y usar) del procesador, haz clic en el menú de acciones junto a la versión del procesador que deseas borrar.
Haz clic en Borrar y, luego, vuelve a hacer clic en Borrar en la ventana de diálogo.
REST
En este ejemplo, se muestra cómo borrar una versión de procesador para tu procesador con el método
processorVersions.delete.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: Es la ubicación del procesador, por ejemplo:
us- Estados Unidoseu: Unión Europea
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PROCESSOR_ID: Es el ID de tu procesador personalizado.
- PROCESSOR_VERSION: Es el identificador de la versión del procesador.
Método HTTP y URL:
DELETE https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION" | Select-Object -Expand Content
La respuesta es una operación de larga duración. Para sondear la operación de larga duración, llama a operations.get
El DeleteProcessorVersionMetadata en la respuesta indica el estado de la operación.
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.DeleteProcessorVersionMetadata",
"commonMetadata": {
"state": "SUCCEEDED",
"createTime": "2022-08-29T16:27:00.195539Z",
"updateTime": "2022-08-29T16:32:01.963962Z",
"resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.protobuf.Empty"
}
}
C#
Para obtener más información, consulta la documentación de referencia de la API de Document AI para C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener más información, consulta la documentación de referencia de la API de Document AI para Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Importa una versión del procesador
Después de crear un procesador nuevo con Document AI, puedes importar una versión del procesador del mismo proyecto o de uno diferente.
La destination project es donde comienzas la importación y donde la versión del procesador está disponible después de la importación.
La source project es donde reside la versión del procesador de origen.
Los procesadores de origen o destino deben cumplir con los siguientes requisitos para la importación:
- Los tipos de procesadores deben coincidir. Ejemplos:
CUSTOM_EXTRACTION_PROCESSORoINVOICE_PROCESSOR - Los esquemas de procesador no deben entrar en conflicto.
- El procesador de destino puede tener conjuntos de datos y versiones existentes.
- El procesador de destino debe estar en el estado
ENABLED. - La versión del procesador de origen debe estar en uno de los siguientes estados:
DEPLOYEDDEPLOYINGUNDEPLOYEDUNDEPLOYING
Debes otorgar el permiso de editor de Document AI al agente de servicio principal de Document AI del proyecto de destino en el proyecto de origen para evitar un error de permiso denegado.
Para las versiones de procesador basadas en Gemini 1.5 y versiones posteriores, como
los extractores personalizados
pretrained-foundation-model-v1.2-2024-05-10, puedes importar versiones de procesador
ajustadas.
Completa los siguientes pasos para configurar el permiso antes de importar una versión del procesador:
Console
Busca Agente del servicio principal de Document AI y completa el número de tu proyecto de destino. El agente de servicio principal de Document AI tiene el formato de una dirección de correo electrónico. Por ejemplo:
service-123@gcp-sa-prod-dai-core..Abre la página IAM en la consola de Google Cloud .
Selecciona tu proyecto de origen.
Haz clic en Otorgar acceso.
Agrega el agente de servicio principal de DocumentAI del proyecto de destino como una principal nueva y asigna el rol de editor de Document AI.
gcloud
Usa el siguiente comando gcloud para otorgar los permisos necesarios:
gcloud projects add-iam-policy-binding SOURCE_PROJECT \ --member=serviceAccount:service-DESTINATION_PROJECT NUMBER@gcp-sa-prod-dai-core. \ --role=roles/documentai.editor
Ingresa los siguientes valores:
SOURCE_PROJECT: Es el número o el ID del proyecto de origen.DESTINATION_PROJECT NUMBER: Es el número del proyecto de destino.
Después de actualizar los permisos, sigue estos pasos para importar una versión del procesador:
Console
En la consola de Google Cloud , en la sección Document AI, ve a la página Procesadores.
En la lista de procesadores, haz clic en el nombre del procesador al que deseas importar una versión como procesador de destino.
Ve a la pestaña Administrar versiones (o Implementar y usar) y haz clic en Importar.
Elige el proyecto, el procesador y la versión del procesador como la versión del procesador de origen en la ventana.
Haz clic en el botón IMPORT en la ventana para que comience la operación de importación.
REST
En este ejemplo, se muestra cómo usar el método
processorVersions.importProcessorVersion
para importar una versión del procesador.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- Proyecto de destino
- DESTINATION_PROJECT_ID: Es el ID del proyecto de Google Cloud de destino.
- DESTINATION_LOCATION: Es la ubicación del procesador de destino.
- DESTINATION_PROCESSOR_ID: Es el ID del procesador de destino.
- Proyecto de origen
- SOURCE_PROJECT_ID: Es el ID del proyecto de origen de Google Cloud .
- SOURCE_LOCATION: Es la ubicación del procesador de origen.
- SOURCE_PROCESSOR_ID: Es el ID del procesador de origen.
- SOURCE_PROCESSOR_VERSION: Es la versión del procesador de origen que se importará.
Método HTTP y URL:
POST https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion
Cuerpo JSON de la solicitud:
{
"processorVersionSource": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/processors/SOURCE_PROCESSOR_ID/processorVersions/SOURCE_PROCESSOR_VERSION"
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/operations/OPERATION_ID"
}
Si importas a través de un perímetro de Controles del servicio de nube privada virtual (VPC-SC), revisa la configuración de las políticas de entrada y salida y configura un perímetro de Controles del servicio de VPC. Luego, establece las siguientes reglas.
Proporciona los siguientes valores para ingress:
DESTINATION_PROJECT: Es el número del proyecto de destino.SOURCE_PROJECT: Es el número del proyecto de origen.
- ingressFrom:
identities:
- ANY_SERVICE_ACCOUNT
sources:
- resource: DESTINATION_PROJECT
ingressTo:
operations:
- serviceName: aiplatform.googleapis.com
methodSelectors:
- method: all actions
- serviceName: documentai.googleapis.com
methodSelectors:
- method: all actions
resources:
- projects/SOURCE_PROJECT
Proporciona los siguientes valores para la salida:
- egressTo:
operations:
- serviceName: storage.googleapis.com
methodSelectors:
- method: google.storage.objects.create
- method: google.storage.buckets.testIamPermissions
resources:
- projects/DESTINATION_PROJECT
egressFrom:
identities:
- ANY_SERVICE_ACCOUNT
Configura un perímetro de destino de VPC con los siguientes valores.
- egressTo:
operations:
- serviceName: aiplatform.googleapis.com
methodSelectors:
- method: all actions
- serviceName: documentai.googleapis.com
methodSelectors:
- method: all actions
- serviceName: storage.googleapis.com
methodSelectors:
- method: google.storage.buckets.testIamPermissions
- method: google.storage.objects.get
- method: google.storage.objects.create
resources:
- projects/SOURCE_PROJECT
egressFrom:
identities:
- ANY_SERVICE_ACCOUNT
sourceRestriction: DISABLED
Próximos pasos
- Obtén información para configurar Document AI.
- Revisa la lista de procesadores.