Administrar las versiones de los procesadores
Las versiones nuevas se lanzan por diversos motivos, por ejemplo, para mejorar la precisión, aumentar la disponibilidad y admitir nuevos elementos de documentos, como las marcas de selección.
Dado que Document AI funciona con IA generativa, las versiones futuras usarán nuevos modelos base para que puedas aprovechar las mejoras de la IA generativa.
A medida que mejoramos los modelos de base, los modelos de base anteriores dejan de estar disponibles. 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:
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 del procesador
Existen dos categorías de versiones de procesador:
- Las versiones de Google son estables (para casos de uso de producción) o candidatas para el lanzamiento (experimentales con la funcionalidad más reciente).
- Tú creas las versiones del usuario para personalizar las predicciones de tus documentos, y 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 Release Candidate (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 del lanzamiento de la versión estable más reciente, como se muestra en la siguiente figura.
Versiones candidatas (RC) de Google
Las versiones candidatas son experimentales y se actualizan frecuentemente con las funciones más recientes. Estas no son versiones de 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 realizando un ajuste), el tipo es IA generativa.
Si creas una versión del procesador entrenando un modelo personalizado más pequeño (ya sea basado en un modelo o en una plantilla), el tipo será 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 impulsa tu versión personalizada del usuario. La versión base determina el ciclo de vida de tu versión del usuario. Debes tomar decisiones sobre cómo administrar el ciclo de vida de tu versión de usuario personalizada.
Versiones estables disponibles del procesador
Extractor personalizado | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-foundation-model-v1.3-2024-08-31 | 28 de mayo de 2024 | 24 de septiembre de 2025 |
pretrained-foundation-model-v1.2-2024-05-10 | 28 de mayo de 2024 | 24 de septiembre de 2025 |
Estado de cuenta | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-bankstatement-v3.0-2022-05-16 | 16 de mayo de 2022 | No aplicable |
pretrained-bankstatement-v2.0-2021-12-10 | 10 de diciembre de 2021 | No aplicable |
pretrained-bankstatement-v1.1-2021-08-13 | 13 agosto de 2021 | No aplicable |
pretrained-bankstatement-v1.0-2021-08-08 | 8 de agosto de 2021 | No aplicable |
Gasto | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-expense-v1.3-2022-07-15 | 15 de julio de 2022 | Se descontinuará en Estados Unidos (EE.UU.) y la Unión Europea (UE) a partir del 30 de abril de 2025. |
pretrained-expense-v1.2-2022-02-18 | 18 de febrero de 2022 | Se descontinuará en Estados Unidos (EE.UU.) y la Unión Europea (UE) a partir del 30 de abril de 2025. |
pretrained-expense-v1.1-2021-04-09 | 9 de abril de 2021 | No aplicable |
Verificación de identidad | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-id-proofing-v1.0-2022-10-03 | 3 de octubre de 2022 | No aplicable |
Factura | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-invoice-v1.3-2022-07-15 | 15 de julio de 2022 | No aplicable |
pretrained-invoice-v1.2-2022-02-18 | 18 de febrero de 2022 | No aplicable |
pretrained-invoice-v1.1-2021-04-09 | 9 de abril de 2021 | No aplicable |
Licencia 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 |
Pasaporte de EE.UU. | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-us-passport-v1.0-2021-06-14 | 14 de junio de 2021 | No aplicable |
Recibo de sueldo | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-paystub-v2.0-2022-07-22 | 22 de julio de 2022 | No aplicable |
pretrained-paystub-v1.2-2021-12-10 | 10 de diciembre de 2021 | No aplicable |
pretrained-paystub-v1.1-2021-08-13 | 13 agosto de 2021 | No aplicable |
pretrained-paystub-v1.0-2021-03-19 | 19 de marzo de 2021 | No aplicable |
W2 | Fecha de lanzamiento | Fecha de baja |
---|---|---|
pretrained-w2-v2.1-2022-06-08 | 8 de junio de 2022 | No aplicable |
pretrained-w2-v1.2-2022-01-28 | 28 de enero de 2022 | No aplicable |
pretrained-w2-v1.1-2022-01-27 | 27 de enero de 2022 | 31 de marzo de 2024 |
pretrained-w2-v1.0-2020-10-01 | 1 de octubre de 2020 | 31 de marzo de 2024 |
Ciclo de vida de la versión del procesador
En cuanto esté disponible una nueva versión de Google, debes crear y evaluar nuevas versiones para los usuarios con la nueva versión base. Luego, implementa la nueva versión y anula la implementación (o borra) de las versiones anteriores del usuario 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 notificará con al menos seis meses de anticipación cuando esto ocurra.
¿Qué sucede cuando se deja de usar una versión base?
Las versiones del usuario que dependen de versiones base anteriores dejan de devolver predicciones cuando la versión base deja de estar disponible.
¿Cómo se seleccionan las versiones del procesador para tus solicitudes?
Cuando llamas a un extremo del procesador sin especificar la versión del procesador, se usa la versión predeterminada del procesador. Cuando cambia la versión predeterminada del procesador, es posible que debas actualizar el código.
Extremo utilizado | 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 está obsoleta, la versión predeterminada se actualizará a la versión estable de Google lanzada más recientemente cuando la versión predeterminada anterior quede obsoleta. |
Si especificas el ID de versión del procesador | La respuesta falla si llamas a un extremo del procesador y especificas un ID de versión que dejó de estar disponible. |
Ejemplo de baja de una versión personalizada
Considera la siguiente situación que describe la secuencia de eventos en una baja de versión personalizada:
Como desarrollador, usas un extractor personalizado para obtener datos de documentos. Dada la complejidad y la cantidad de documentos que procesas, ajustas el modelo fundamental para crear una versión llamada
fine-tune-A
. Estableces la versiónfine-tune-A
como la versión predeterminada de tu procesador y la usas para procesar documentos. La versión base que impulsa el modelofine-tune-A
es 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.0
quedará obsoleta el 9 de abril de 2025.Como conservaste los documentos de entrenamiento y prueba en el conjunto de datos de tu procesador, ajusta otra versión basada en la versión estable más reciente de Google,
v1.2
, y nómbralafine-tune-B
. Después de evaluar su rendimiento, establece la versiónfine-tune-B
como la nueva versión predeterminada de tu procesador y retira la versiónfine-tune-A
. Tu nueva versión ahora usa la versión estable de Google más reciente compatible.
Por otro lado, si no hubieras creado ni 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 los analizadores y procesadores que dejaron de estar disponibles, puedes consultar Document AI deprecations.
Consulta los siguientes recursos para las migraciones:
Para crear y entrenar un nuevo Expense Parser, puedes consultar uptrain pretrained processor.
Para crear y ajustar un nuevo procesador de Custom Extractor, puedes consultar Custom Extractor con IA generativa.
Selecciona una versión del procesador
Existen tres formas de especificar qué versión del procesador se usará para el procesamiento en línea y por lotes:
Si no especificas una versión, se usará 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 usará 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 la 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 (Manage Versions) o Implementar y usar (Deploy & Use), en la que se mostrarán todas las versiones del procesador disponibles.
REST
En este ejemplo, se muestra cómo enumerar las versiones del procesador 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: La ubicación de tu procesador, por ejemplo:
us
: Estados Unidoseu
: Unión Europea
- PROJECT_ID: El ID de tu 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 C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cómo ver detalles sobre 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), en la que se mostrarán todas las versiones del procesador disponibles y sus detalles.
REST
En este ejemplo, se muestra cómo obtener detalles sobre una versión del procesador para tu procesador con el método processorVersions.get
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación de tu procesador, por ejemplo:
us
: Estados Unidoseu
: Unión Europea
- PROJECT_ID: El ID de tu 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-DD
stable
rc
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 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 C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cómo cambiar la versión predeterminada
La versión predeterminada de un procesador especifica la versión que se usa para procesar documentos cuando no se especifica una versión en particular. Cuando crea un procesador, la versión predeterminada inicial es la versión más reciente del canal estable.
Si cambias la versión predeterminada, las solicitudes entrantes se procesarán con la versión recién seleccionada. Si cambias la versión predeterminada mientras el procesador está en medio de una solicitud, la solicitud 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 versión predeterminada.
REST
En este ejemplo, se muestra cómo establecer la versión predeterminada del procesador usando el método processors.setDefaultProcessorVersion
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación de tu procesador, por ejemplo:
us
: Estados Unidoseu
: Unión Europea
- PROJECT_ID: El ID de tu 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-DD
stable
rc
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 C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 del 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: La ubicación de tu procesador, por ejemplo:
us
: Estados Unidoseu
: Unión Europea
- PROJECT_ID: El ID de tu 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 C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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, luego, implementarla, puedes anular su 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 que 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 para tu procesador con el método processorVersions.undeploy
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación de tu procesador, por ejemplo:
us
: Estados Unidoseu
: Unión Europea
- PROJECT_ID: El ID de tu 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 C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 del procesador con el método processorVersions.delete
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación de tu procesador, por ejemplo:
us
: Estados Unidoseu
: Unión Europea
- PROJECT_ID: El ID de tu 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 C#.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Go.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Java.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Python.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 Ruby.
Para autenticarte en Document AI, configura las credenciales predeterminadas de la aplicación. Si deseas 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 desde el mismo proyecto o desde uno diferente.
destination project
es donde comienzas la importación y donde la versión del procesador estará disponible después de la importación.
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 procesador deben coincidir. Ejemplos:
CUSTOM_EXTRACTION_PROCESSOR
oINVOICE_PROCESSOR
- Los esquemas del 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 estado
ENABLED
. - La versión del procesador de origen debe estar en uno de los siguientes estados:
DEPLOYED
DEPLOYING
UNDEPLOYED
UNDEPLOYING
Debes otorgar el permiso de DocumentAI Core Service Agent del proyecto de destino Document AI Editor en el proyecto de origen para evitar un error de permiso denegado.
En el caso de 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 DocumentAI Core Service Agent y completa el número de tu proyecto de destino. El agente del 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.iam.gserviceaccount.com
.Abre la página IAM en la consola de Google Cloud .
Selecciona tu proyecto fuente.
Haz clic en Otorgar acceso.
Agrega el agente de servicio de Document AI Core del proyecto de destino como un principal nuevo 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.iam.gserviceaccount.com \ --role=roles/documentai.editor
Ingresa los siguientes valores:
SOURCE_PROJECT
: Es el número o 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 Administra versiones (o Implementar y usar) y haz clic en Importar.
En la ventana, elige el proyecto, el procesador y la versión del procesador como la versión del procesador de origen.
Haz clic en el botón IMPORT de la ventana para iniciar 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 de tu proyecto de Google Cloud destino.
- DESTINATION_LOCATION: 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 de tu proyecto de Google Cloud origen.
- 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 realizas la importación a través de un perímetro de los 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 los Controles del servicio de VPC y, 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 egress:
- 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 más información para configurar Document AI.
- Revisa la lista de procesadores.