De nouvelles versions sont publiées pour diverses raisons, par exemple pour améliorer la précision, augmenter la disponibilité et prendre en charge de nouveaux éléments de document, tels que les marques de sélection.
Étant donné que Document AI est optimisé par l'IA générative, les futures versions utilisent de nouveaux modèles de fondation pour vous permettre de bénéficier des améliorations de l'IA générative.
À mesure que nous améliorons les modèles de fondation, les modèles de fondation antérieurs sont abandonnés. De même, les versions de processeur sont obsolètes six mois après la sortie de nouvelles versions.
Un processeur peut avoir l'une des versions suivantes :
- Version stable
- Version candidate
- Version personnalisée et sa version de base associée
Cette page explique comment les versions des processeurs sont gérées, et comment afficher et sélectionner une version spécifique.

Présentation des versions de processeur
Il existe deux catégories de versions de processeur :
- Les versions Google sont soit stables (pour les cas d'utilisation en production), soit des versions candidates (expérimentales avec les dernières fonctionnalités).
- Les versions utilisateur sont créées par vous pour personnaliser les prédictions pour vos documents et ont des ID de version alphanumériques.
Versions Google
Chaque version de Google est identifiée par un ID de version, par exemple pretrained-TYPE-vX.X-YYYY-MM-DD.
Chaque version de processeur proposée par Google est nommée Google Stable ou Google version candidate (RC).
Versions stables de Google
Les versions stables sont de qualité production et prêtes à être utilisées.
- Google donne la priorité à la stabilité du comportement du processeur, mais inclut toujours les correctifs essentiels.
- Les versions stables de Google antérieures sont obsolètes six mois après la sortie de la version stable la plus récente, comme illustré dans la figure suivante.

Versions candidates (RC) de Google
Les versions candidates sont expérimentales et sont mises à niveau régulièrement pour intégrer les dernières fonctionnalités. Il ne s'agit pas de versions de qualité production, et leur stabilité peut varier.
Versions personnalisées
Les versions personnalisées sont les versions de processeur que vous pouvez créer en fonction de vos documents pour personnaliser les prédictions.
Les versions personnalisées ont un Type, qui indique le type de modèle utilisé pour les prédictions.
Si vous créez une version à l'aide d'un modèle de fondation (en créant une version ou en l'affinant), le type est IA générative. Si vous créez une version de processeur en entraînant un modèle personnalisé plus petit (basé sur un modèle ou un modèle), le type est Personnalisé. Si vous créez des versions de processeur, vous décidez du nom et de l'ID.
Versions de base
Si vous créez une version de l'outil de traitement, la "version de base" indique la version de Google qui alimente votre version utilisateur personnalisée. La version de base détermine le cycle de vie de votre version utilisateur. Vous devez prendre des décisions concernant la gestion du cycle de vie de votre version utilisateur personnalisée.
Versions de processeur stables disponibles
Vous pouvez consulter les versions de processeur stables disponibles pour les différents types de processeurs dans les tableaux suivants.
| Extracteur personnalisé | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-foundation-model-v1.5-2025-05-05 |
5 mai 2025 | Non applicable |
pretrained-foundation-model-v1.5-pro-2025-06-20 |
20 juin 2025 | Non applicable |
pretrained-foundation-model-v3.1-lite-2026-10-08 |
8 octobre 2026 | Non applicable |
| Analyseur de formulaires | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-form-parser-v1.0-2020-09-23 |
23 septembre 2020 | Non applicable |
pretrained-form-parser-v2.0-2022-11-10 |
10 novembre 2022 | Non applicable |
| Analyseur de mise en page | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-layout-parser-v1.0-2024-06-03 |
3 juin 2024 | Non applicable |
pretrained-layout-parser-v3.5-2026-07-09 |
18 novembre 2026 | Non applicable |
| Analyseur de relevés bancaires | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-bankstatement-v1.0-2021-08-08 |
8 août 2021 | Non applicable |
pretrained-bankstatement-v1.1-2021-08-13 |
13 août 2021 | Non applicable |
pretrained-bankstatement-v2.0-2021-12-10 |
10 décembre 2021 | Non applicable |
pretrained-bankstatement-v3.0-2022-05-16 |
16 mai 2022 | Non applicable |
pretrained-bankstatement-v5.0-2023-12-06 |
6 décembre 2023 | Non applicable |
| Analyseur de formulaires W2 | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-w2-v1.0-2020-10-01 |
1er octobre 2020 | 31 mars 2024 |
pretrained-w2-v1.1-2022-01-27 |
27 janvier 2022 | 31 mars 2024 |
pretrained-w2-v1.2-2022-01-28 |
28 janvier 2022 | Non applicable |
pretrained-w2-v2.1-2022-06-08 |
8 juin 2022 | Non applicable |
| Analyseur de vérification de documents d'identité | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-id-proofing-v1.0-2022-10-03 |
3 octobre 2022 | Non applicable |
| Analyseur de bulletins de salaire | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-paystub-v1.0-2021-03-19 |
19 mars 2021 | Non applicable |
pretrained-paystub-v1.1-2021-08-13 |
13 août 2021 | Non applicable |
pretrained-paystub-v1.2-2021-12-10 |
10 décembre 2021 | Non applicable |
pretrained-paystub-v2.0-2022-07-22 |
22 juillet 2022 | Non applicable |
pretrained-paystub-v3.0-2023-12-06 |
6 décembre 2023 | Non applicable |
| Analyseur de permis de conduire américains | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-us-driver-license-v1.0-2021-06-14 |
14 juin 2021 | Non applicable |
| Analyseur de dépenses | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-expense-v1.1-2021-04-09 |
09 avril 2024 | Non applicable |
pretrained-expense-v1.4-2022-11-18 |
18 novembre 2022 | Non applicable |
pretrained-expense-v1.4.2-2024-09-12 |
12 septembre 2024 | Non applicable |
| Analyseur de factures | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-invoice-v1.1-2021-04-09 |
09 avril 2024 | Non applicable |
pretrained-invoice-v1.2-2022-02-18 |
18 février 2022 | Non applicable |
pretrained-invoice-v1.3-2022-07-15 |
15 juillet 2022 | Non applicable |
pretrained-invoice-v2.0-2023-12-06 |
6 décembre 2023 | Non applicable |
| Enterprise Document OCR (reconnaissance optique des caractères) | Date de disponibilité | Début de la période d'abandon |
|---|---|---|
pretrained-ocr-v1.2-2022-11-10 |
10 novembre 2022 | Non applicable |
pretrained-ocr-v2.0-2023-06-02 |
2 juin 2023 | Non applicable |
pretrained-ocr-v2.1-2024-08-07 |
7 août 2024 | Non applicable |

Cycle de vie des versions de processeur
Dès qu'une nouvelle version Google est disponible, vous devez créer et évaluer de nouvelles versions utilisateur avec la nouvelle version de base. Ensuite, déployez votre nouvelle version et annulez le déploiement (ou supprimez) les versions utilisateur antérieures qui utilisent la version stable précédente comme base. Les versions stables sont abandonnées après la publication d'une nouvelle version. Google vous prévient au moins six mois à l'avance lorsque cela se produit.
Que se passe-t-il lorsqu'une version de base est obsolète ?
Les versions utilisateur dépendant de versions de base antérieures cessent de renvoyer des prédictions lorsque la version de base est obsolète.
Comment les versions de l'outil de traitement sont-elles sélectionnées pour vos requêtes ?
Lorsque vous appelez un point de terminaison de processeur sans spécifier la version du processeur, la version par défaut est utilisée. Lorsque la version du processeur par défaut change, vous devrez peut-être mettre à jour le code.
| Point de terminaison utilisé | Expérience |
|---|---|
| Si vous ne spécifiez pas d'ID de version de processeur | Requêtes traitées à l'aide d'une nouvelle version de processeur par défaut. Si la version par défaut de votre processeur est obsolète, la version par défaut est mise à jour vers la version Google stable la plus récemment lancée lorsque l'ancienne version par défaut est obsolète. |
| Si vous spécifiez l'ID de la version du processeur | La réponse échoue si vous appelez un point de terminaison de processeur et spécifiez un ID de version obsolète. |
Exemple d'abandon d'une version personnalisée
Prenons l'exemple du scénario suivant, qui décrit la séquence d'événements lors de l'abandon d'une version personnalisée :
En tant que développeur, vous utilisez un extracteur personnalisé pour obtenir des données à partir de documents. Compte tenu de la complexité et du volume des documents que vous traitez, vous affinez le modèle de fondation pour créer une version nommée
fine-tune-A. Vous définissez la versionfine-tune-Acomme version par défaut de votre processeur et l'utilisez pour traiter des documents. La version de base qui alimente le modèlefine-tune-Aest la version stablepretrained-foundation-model-v1.0-2023-08-22 (v1.0).Google a publié une nouvelle version stable nommée
pretrained-foundation-model-v1.2-2024-05-10 (v1.2)et a annoncé que la version stablev1.0sera obsolète le 9 avril 2025.Comme vous avez conservé vos documents d'entraînement et de test dans l'ensemble de données de votre processeur, vous allez affiner une autre version basée sur la dernière version stable de Google,
v1.2, et la nommerfine-tune-B. Après avoir évalué ses performances, vous définissez la versionfine-tune-Bcomme nouvelle version par défaut de votre processeur et vous mettez hors service la versionfine-tune-A. Votre nouvelle version utilise désormais la dernière version stable de Google compatible.
En revanche, si vous n'aviez pas créé ni évalué la version fine-tune-B personnalisée, Google aurait mis à jour la version par défaut de votre processeur vers v1.2 le 9 avril 2025. Étant donné que vous appelez le point de terminaison du processeur et que vous ne spécifiez pas de version de processeur, la nouvelle version v1.2 est utilisée comme nouvelle version par défaut pour traiter vos requêtes.
Ressources d'abandon et de migration
Pour en savoir plus sur les analyseurs et les processeurs obsolètes, consultez Éléments obsolètes de Document AI.
Consultez les ressources suivantes pour les migrations :
Pour créer et entraîner un nouvel analyseur de dépenses, vous pouvez consulter la section Entraîner un processeur pré-entraîné.
Pour créer et régler un processeur d'extraction personnalisé, consultez Extracteur personnalisé avec l'IA générative.
Sélectionner une version de processeur
Il existe trois façons de spécifier la version de l'outil de traitement à utiliser pour le traitement en ligne et par lot :
Si vous ne spécifiez pas de version, la version par défaut du processeur est utilisée.
- Exemple :
projects/my-proj/locations/us/processors/my-processor:process
- Exemple :
Si vous spécifiez une version, cette version spécifique est utilisée. Si la version spécifique n'existe pas, la requête échoue et renvoie une erreur.
- Exemple :
projects/my-proj/locations/us/processors/my-processor/processorVersions/pretrained-invoice-v1.2-2022-02-18:process
- Exemple :
Si vous spécifiez un canal, la dernière version de ce canal est utilisée. (Options :
stable,rc)- Exemple :
projects/my-proj/locations/us/processors/my-processor/processorVersions/stable:process
- Exemple :
Afficher la version disponible
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur dont vous souhaitez afficher les détails.
Sélectionnez l'onglet Gérer les versions (ou Déployer et utiliser), qui affiche toutes les versions de processeur disponibles.
REST
Cet exemple montre comment lister les versions disponibles pour votre processeur à l'aide de la méthode processorVersions.list.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : emplacement de votre processeur, par exemple :
us– États-Uniseu- Union européenne
- PROJECT_ID : ID de votre projet Google Cloud .
- PROCESSOR_ID : ID de votre processeur personnalisé.
Méthode HTTP et URL :
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 réponse contient une liste de ProcessorVersions, qui contient des informations sur chaque version de processeur, telles que ses name, state et d'autres détails.
{
"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#
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage C#.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Go.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Java.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Python.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Ruby.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Afficher les détails d'une version
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur dont vous souhaitez afficher les détails.
Sélectionnez l'onglet Gérer les versions (ou Déployer et utiliser), qui affiche toutes les versions de processeur disponibles et leurs détails.
REST
Cet exemple montre comment obtenir des informations sur une version de processeur pour votre processeur à l'aide de la méthode processorVersions.get.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : emplacement de votre processeur, par exemple :
us– États-Uniseu- Union européenne
- PROJECT_ID : ID de votre projet Google Cloud .
- PROCESSOR_ID : ID de votre processeur personnalisé.
- PROCESSOR_VERSION : identifiant de la version du processeur. Pour en savoir plus, consultez Sélectionner une version d'outil de traitement. Par exemple :
- .
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
Méthode HTTP et URL :
GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 réponse est un ProcessorVersion, qui contient des informations sur la version du processeur, telles que son name, son state et d'autres détails.
{
"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#
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage C#.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Go.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Java.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Python.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Ruby.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Modifier la version par défaut
La version par défaut d'un processeur spécifie la version utilisée pour traiter les documents lorsque vous ne spécifiez pas de version spécifique. Lorsque vous créez un processeur, la version par défaut initiale est la dernière version du canal stable.
Si vous modifiez la version par défaut, les requêtes entrantes sont traitées à l'aide de la nouvelle version sélectionnée. Si vous modifiez la version par défaut alors que le processeur est en train de traiter une requête, la requête continuera d'utiliser la version précédemment sélectionnée.
Pour modifier la version par défaut :
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur dont vous souhaitez afficher les détails.
Dans l'onglet Gérer les versions (ou Déployer et utiliser) du processeur, dans le menu déroulant Version par défaut, choisissez la version du processeur que vous souhaitez utiliser comme version par défaut.
REST
Cet exemple montre comment définir la version de processeur par défaut de votre processeur à l'aide de la méthode processors.setDefaultProcessorVersion.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : emplacement de votre processeur, par exemple :
us– États-Uniseu- Union européenne
- PROJECT_ID : ID de votre projet Google Cloud .
- PROCESSOR_ID : ID de votre processeur personnalisé.
- PROCESSOR_VERSION : identifiant de la version du processeur. Pour en savoir plus, consultez Sélectionner une version d'outil de traitement. Par exemple :
- .
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
Méthode HTTP et URL :
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion
Corps JSON de la requête :
{
"defaultProcessorVersion": "PROCESSOR_VERSION"
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$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 réponse est une opération de longue durée. Pour interroger l'opération de longue durée, appelez operations.get.
Le champ SetDefaultProcessorVersionMetadata de la réponse indique l'état de l'opération.
{
"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#
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage C#.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Go.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Java.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Python.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Ruby.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Déployer une version de processeur
Après avoir créé une version de processeur avec Document AI, vous devez la déployer avant de pouvoir traiter des documents avec cette version.
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur dont vous souhaitez afficher les détails.
Dans l'onglet Gérer les versions (ou Déployer et utiliser) de l'outil de traitement, cochez la case à côté de la version de l'outil de traitement que vous souhaitez déployer.
Cliquez sur Déployer, puis à nouveau sur Déployer dans la boîte de dialogue. Ce processus prend quelques minutes.
REST
Cet exemple montre comment déployer une version de processeur pour votre processeur à l'aide de la méthode processorVersions.deploy.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : emplacement de votre processeur, par exemple :
us– États-Uniseu- Union européenne
- PROJECT_ID : ID de votre projet Google Cloud .
- PROCESSOR_ID : ID de votre processeur personnalisé.
- PROCESSOR_VERSION : identifiant de la version du processeur.
Méthode HTTP et URL :
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 réponse est une opération de longue durée. Pour interroger l'opération de longue durée, appelez operations.get.
Le champ DeployProcessorVersionMetadata de la réponse indique l'état de l'opération.
{
"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#
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage C#.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Go.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Java.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Python.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Ruby.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Annuler le déploiement d'une version de processeur
Après avoir créé une version de processeur avec Document AI et l'avoir déployée, vous pouvez annuler son déploiement si vous ne souhaitez pas que la version du processeur puisse gérer les requêtes de traitement.
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur dont vous souhaitez afficher les détails.
Dans l'onglet Gérer les versions (ou Déployer et utiliser) de l'outil de traitement, cochez la case à côté de la version de l'outil de traitement dont vous souhaitez annuler le déploiement.
Cliquez sur Annuler le déploiement, puis à nouveau sur Annuler le déploiement dans la boîte de dialogue. Ce processus prend quelques minutes.
REST
Cet exemple montre comment annuler le déploiement d'une version de processeur pour votre processeur à l'aide de la méthode processorVersions.undeploy.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : emplacement de votre processeur, par exemple :
us– États-Uniseu- Union européenne
- PROJECT_ID : ID de votre projet Google Cloud .
- PROCESSOR_ID : ID de votre processeur personnalisé.
- PROCESSOR_VERSION : identifiant de la version du processeur.
Méthode HTTP et URL :
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 réponse est une opération de longue durée. Pour interroger l'opération de longue durée, appelez operations.get.
Le champ UndeployProcessorVersionMetadata de la réponse indique l'état de l'opération.
{
"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#
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage C#.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Go.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Java.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Python.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Ruby.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Supprimer une version de processeur
Après avoir créé une version de processeur avec Document AI, vous pouvez la supprimer si vous n'en avez plus besoin.
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur dont vous souhaitez afficher les détails.
Dans l'onglet Gérer les versions (ou Déployer et utiliser) de l'outil de traitement, cliquez sur le menu d'actions à côté de la version de l'outil de traitement que vous souhaitez supprimer.
Cliquez sur Supprimer, puis à nouveau sur Supprimer dans la boîte de dialogue.
REST
Cet exemple montre comment supprimer une version de processeur pour votre processeur à l'aide de la méthode processorVersions.delete.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- LOCATION : emplacement de votre processeur, par exemple :
us– États-Uniseu- Union européenne
- PROJECT_ID : ID de votre projet Google Cloud .
- PROCESSOR_ID : ID de votre processeur personnalisé.
- PROCESSOR_VERSION : identifiant de la version du processeur.
Méthode HTTP et URL :
DELETE https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
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
Exécutez la commande suivante :
$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 réponse est une opération de longue durée. Pour interroger l'opération de longue durée, appelez operations.get.
Le champ DeleteProcessorVersionMetadata de la réponse indique l'état de l'opération.
{
"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#
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage C#.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Go.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Java.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Python.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Document AI en langage Ruby.
Pour vous authentifier auprès de Document AI, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Importer une version de processeur
Après avoir créé un processeur avec Document AI, vous pouvez importer une version de processeur depuis le même projet ou un autre.
destination project est l'endroit où vous lancez l'importation et où la version du processeur devient disponible après l'importation.
source project correspond à l'emplacement de la version du processeur source.
Les processeurs source ou de destination doivent répondre aux exigences suivantes pour l'importation :
- Les types de processeurs doivent correspondre. Exemples :
CUSTOM_EXTRACTION_PROCESSORouINVOICE_PROCESSOR - Les schémas de processeur ne doivent pas entrer en conflit.
- Le processeur de destination peut comporter des ensembles de données et des versions existants.
- Le processeur de destination doit être à l'état
ENABLED. - La version du processeur source doit être dans l'un des états suivants :
DEPLOYEDDEPLOYINGUNDEPLOYEDUNDEPLOYING
Vous devez accorder à l'agent de service DocumentAI Core du projet de destination l'autorisation Éditeur Document AI sur le projet source pour éviter une erreur d'autorisation refusée.
Pour les versions de processeur basées sur Gemini 1.5 et versions ultérieures, telles que les extracteurs personnalisés pretrained-foundation-model-v1.2-2024-05-10, vous pouvez importer des versions de processeur affinées.
Pour configurer les autorisations avant d'importer une version de processeur, procédez comme suit :
Console
Recherchez Agent de service DocumentAI Core et indiquez le numéro de votre projet de destination. L'agent de service DocumentAI Core se présente sous la forme d'une adresse e-mail. Par exemple :
service-123@gcp-sa-prod-dai-core.Ouvrez la page IAM dans la console Google Cloud .
Sélectionnez votre projet source.
Cliquez sur "Accorder l'accès".
Ajoutez l'agent de service principal Document AI du projet de destination en tant que nouveau compte principal, puis attribuez-lui le rôle Éditeur Document AI.
gcloud
Exécutez la commande gcloud suivante pour accorder les autorisations nécessaires :
gcloud projects add-iam-policy-binding SOURCE_PROJECT \ --member=serviceAccount:service-DESTINATION_PROJECT NUMBER@gcp-sa-prod-dai-core. \ --role=roles/documentai.editor
Indiquez les valeurs suivantes :
SOURCE_PROJECT: numéro ou ID du projet source.DESTINATION_PROJECT NUMBER: numéro du projet de destination.
Après avoir mis à jour les autorisations, procédez comme suit pour importer une version de processeur :
Console
Dans la console Google Cloud , accédez à la page Processeurs de la section Document AI.
Dans la liste des processeurs, cliquez sur le nom du processeur vers lequel vous souhaitez importer une version de processeur en tant que processeur de destination.
Accédez à l'onglet Gérer les versions (ou Déployer et utiliser), puis cliquez sur Importer.
Dans la fenêtre, sélectionnez le projet, le processeur et la version du processeur comme version du processeur source.
Cliquez sur le bouton IMPORT dans la fenêtre pour lancer l'importation.
REST
Cet exemple montre comment utiliser la méthode processorVersions.importProcessorVersion pour importer une version de processeur.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- Projet de destination
- DESTINATION_PROJECT_ID : ID du projet Google Cloud de destination.
- DESTINATION_LOCATION : emplacement de votre processeur de destination.
- DESTINATION_PROCESSOR_ID : ID de votre processeur de destination.
- Projet source
- SOURCE_PROJECT_ID : ID de votre projet source Google Cloud .
- SOURCE_LOCATION : emplacement de l'outil de traitement source.
- SOURCE_PROCESSOR_ID : ID de votre processeur source.
- SOURCE_PROCESSOR_VERSION : version du processeur source à importer.
Méthode HTTP et URL :
POST https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion
Corps JSON de la requête :
{
"processorVersionSource": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/processors/SOURCE_PROCESSOR_ID/processorVersions/SOURCE_PROCESSOR_VERSION"
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$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
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/operations/OPERATION_ID"
}
Si vous importez des données via un périmètre VPC Service Controls (VPC-SC), consultez Configurer des règles d'entrée et de sortie et Configurer un périmètre VPC Service Controls, puis définissez les règles suivantes.
Indiquez les valeurs suivantes pour ingress :
DESTINATION_PROJECT: numéro du projet de destination.SOURCE_PROJECT: numéro du projet source.
- 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
Indiquez les valeurs suivantes pour 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
Configurez un périmètre de destination VPC avec les valeurs suivantes.
- 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
Étape suivante
- Découvrez comment configurer Document AI.
- Consultez la liste des outils de traitement.