Zuva DocAI

Ce connecteur est disponible dans les produits et régions suivants :

Service	classe	Régions
Copilot Studio	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Régions Azure Government      - Régions Azure Chine      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps , à l’exception des suivantes :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)

Contact
Nom	Zuva Support
URL	https://zuva.ai/support/
Messagerie électronique	support@zuva.ai

Métadonnées du connecteur
Éditeur	Zuva Inc.
Site internet	https://zuva.ai/
Politique de confidentialité	https://zuva.ai/privacy/
Catégories	AI

Ce connecteur permet aux utilisateurs de rechercher et d’extraire des entités, des phrases et des paragraphes à partir de contrats (et de documents connexes), en tirant parti de l’ia de contrats de classe de Zuva. Conçu et formé pour identifier les clauses juridiques dans plusieurs secteurs d’activité et cas d’usage, ce connecteur fournit une suite plug-and-play de modules pour incorporer Contracts AI dans vos workflows. Ce connecteur est fourni avec OCR pour lire vos documents, ainsi que les fonctionnalités de classification et de normalisation des documents.

Prerequisites

Vous aurez besoin d’un compte Zuva et d’un jeton DocAI. Commencez par vous inscrire à un compte gratuit.

Comment obtenir des informations d’identification

Zuva DocAI a plusieurs serveurs régionaux. Vous devez créer un jeton d’API pour la région spécifique que vous souhaitez utiliser.

1. Créez et/ou connectez-vous à votre compte à zuva.ai.
2. Accédez à la console DocAI
3. Sélectionnez la région que vous souhaitez utiliser.
4. Copiez l’URL de base de la région vers votre connexion.
5. Créez un jeton et copiez-le pour l’utiliser dans votre connexion.

Consultez le guide de démarrage rapide DocAI pour plus d’informations sur les comptes et jetons Zuva.

Bien démarrer avec votre connecteur

Pour utiliser le connecteur Zuva DocAI, vous devez définir un flux similaire à ce qui suit :

Étape 1 : Obtenir un fichier

À des fins de test, vous pouvez créer un « flux cloud instantané » dans Power Automate. Choisissez « Déclencher manuellement un flux » et créez le flux. Ajoutez une entrée, puis choisissez le type « Fichier ».

Étape 2 : Envoyer un fichier

Ajoutez l’action Submit a file , puis choisissez « Contenu du fichier » à l’étape précédente en tant qu’entrée.

Remarque : le fichier ne doit pas être transformé d’une manière quelconque (c’est-à-dire sans encodage base64). DocAI accepte uniquement les données binaires brutes.

Étape 3 : Démarrer le traitement du fichier

Choisissez le service que vous souhaitez utiliser en ajoutant l’une des actions suivantes :

• Create Language Classification Request
• Create Document Classification Request
• Create Multi-Level Classification Request
• Create Field Extraction Request
• Create OCR Request

Chacun d’eux accepte l’ID de fichier (retourné à partir de l’action Submit a file ) comme entrée.

L’extraction de champs nécessite également des ID de champ en tant qu’entrées. Les ID de champ sont disponibles dans la bibliothèque de champs (connexion requise), à partir d’un formateur IA si vous avez formé des champs personnalisés ou par programmation à l’aide de l’action Get Field List .

Étape 4 : Interroger l’achèvement de la demande

Utilisez un Do Until bloc (trouvé dans la section « Contrôle ») et ajoutez l’action de vérification d’état correcte à l’intérieur du bloc :

• Get Field Extraction Request Status
• Get Language Classification Request Status
• Get Document Classification Request Status
• Get MLC request Status
• Get OCR Request Status

L’action Get ____ status prend comme entrée l’ID de requête de son action correspondante Create ____ Request .

Vous devez également ajouter un bloc de 10 secondes Delay à l’intérieur du Do until bloc pour vous assurer que le fichier a suffisamment de temps à traiter.

Définissez la condition pour que le Do Until bloc Is Finished? soit égal à true.

Étape 4 : Obtenir les résultats

Enfin, utilisez l’une des actions Obtenir les résultats correspondant à votre demande, à l’aide de l’ID de requête de l’opération De création d’origine comme entrée :

• Get Field Extraction Request Text Results
• Get Language Classification Request Status
• Get Document Classification Request Status
• Get MLC request Status
• Get OCR Results Text
• Get OCR Results Images

Notez que pour la langue, la classification des documents et le MLC, les résultats sont inclus dans la réponse État.

Vous pouvez consulter la documentation DocAI pour plus d’informations sur la structure des résultats d’extraction de champs.

Problèmes connus et limitations

Champs par requête

Un maximum de 100 champs peut être inclus dans une seule Create Field Extraction Request action.

Champs personnalisés

Le connecteur ne prend pas en charge les points de terminaison de DocAI liés à l’apprentissage de champs personnalisés ou à l’obtention des métadonnées d’un champ individuel.

Différences avec l’API sous-jacente

En outre, notez que la fonctionnalité de connecteur ne correspond pas à un avec la documentation de l’API sous-jacente. En particulier, le connecteur :

1. Expose une valeur booléenne supplémentaire is_finished , qui peut être utilisée pour indiquer si la requête est terminée ou a échoué
2. Toutes les requêtes fonctionnent sur des fichiers uniques, plutôt que sur des lots de plusieurs fichiers.

Erreurs courantes et solutions

Veillez à charger des chaînes binaires brutes plutôt que des chaînes encodées en base64. Vous pouvez utiliser le service OCR et vérifier qu’il retourne le texte attendu.

Questions fréquentes (FAQ)

Où puis-je trouver des informations supplémentaires sur Zuva DocAI ?

https://zuva.ai/docai/

Où puis-je trouver de la documentation supplémentaire sur Zuva DocAI ?

https://zuva.ai/documentation/

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut	Paramètres de création de connexion.	Toutes les régions	Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
Jeton	securestring	Votre jeton DocAI	Vrai
URL de base	ficelle	Exemple : https://us.app.zuva.ai/api/v2	Vrai

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	100	60 secondes

Actions

Créer une demande de classification de documents	Créez une demande de classification du document spécifié.
Créer une demande de classification linguistique	Créez une demande pour la langue du fichier spécifié.
Créer une demande de classification à plusieurs niveaux	Créez une demande de classification à plusieurs niveaux du fichier spécifié.
Créer une demande d’extraction de champ	Créez une demande d’extractions à partir du fichier spécifié.
Créer une requête OCR	Créez une demande d’OCR à appliquer au fichier spécifié.
Envoyer un fichier	Envoyez un fichier à Zuva DocAI.
Normaliser les dates	Normaliser une chaîne contenant une ou plusieurs dates. Pour chaque date trouvée, le point de terminaison retourne un ensemble d’entiers représentant l’année, le mois et le jour.
Obtenir des images de requête OCR	Obtenez les images à partir d’une requête OCR terminée.
Obtenir la liste des champs	Obtenez la liste de tous les champs disponibles.
Obtenir le texte de la requête OCR	Obtenez le texte à partir d’une requête OCR terminée.
Obtenir les résultats de la demande d’extraction de champ	Obtenez des résultats de texte à partir d’une demande d’extraction de champ terminée.
Obtenir l’état de la demande de classification de document	Obtenez l’état et les résultats disponibles pour une demande de classification de documents existante.
Obtenir l’état de la demande de classification linguistique	Obtenez l’état et les résultats disponibles pour une demande de classification de documents existante.
Obtenir l’état de la demande d’extraction de champ	Vérifiez l’état d’une demande d’extraction de champ existante.
Obtenir l’état de la demande OCR	Vérifiez l’état d’une requête OCR existante.
Obtenir l’état de la requête MLC	Obtenez l’état et les résultats disponibles pour une requête MLC existante.
Supprimer un fichier	Supprimez un fichier existant de Zuva.

Créer une demande de classification de documents

Créer une demande de classification linguistique

Créer une demande de classification à plusieurs niveaux

Créer une demande d’extraction de champ

Créer une requête OCR

Envoyer un fichier

Normaliser les dates

Obtenir des images de requête OCR

Obtenir la liste des champs

Obtenir le texte de la requête OCR

Obtenir les résultats de la demande d’extraction de champ

Obtenir l’état de la demande de classification de document

Obtenir l’état de la demande de classification linguistique

Obtenir l’état de la demande d’extraction de champ

Obtenir l’état de la demande OCR

Obtenir l’état de la requête MLC

Supprimer un fichier

Définitions

ficelle

binaire