Aller au contenu principal

Analyser du texte et/ou des pièces jointes

Introduction​

Dans ce guide, nous allons voir comment analyser du texte et/ou des pièces jointes avec l'API v2 de Golem.ai.

Vous devez avoir votre clé d'accés API et votre environment ID. Dans le reste de ce guide, nous allons les représenter de la manière suivante :

  • <YOUR-SECRET-KEY> pour la clé d'accès API
  • <YOUR-APP-ID> pour l'app ID
  • <YOUR-ENVIRONMENT-ID> pour l'environment ID

Référez vous aux prérequis pour plus de détails.

Example d'appel API par curl​

Example d'appel API par curl pour analyser uniquement du texte :

curl --request POST \
      --url https://api.console.golem.ai/environment/<YOUR-ENVIRONMENT-ID>/analyses?appId=<YOUR-APP-ID> \
      --header 'accept: application/json' \
      --header 'authorization: <YOUR-SECRET-KEY>' \
      --header 'content-type: multipart/form-data' \
      --form 'payload={"inputs":[{"type":"BODY","contentType":"text","text": "Texte à analyser","name": "Ticket content"}],"metadata":{"ticket_id":"123456"},"name":"my-analysis-name"}'

En considérant que les pièces jointes se trouvent dans le répertoire courant sous le nom document.pdf et image.jpg, voici la commande curl correspondante pour les téléverser en plus du texte :

curl --request POST \
      --url https://api.console.golem.ai/environment/<YOUR-ENVIRONMENT-ID>/analyses?appId=<YOUR-APP-ID> \
      --header 'accept: application/json' \
      --header 'authorization: <YOUR-SECRET-KEY>' \
      --header 'content-type: multipart/form-data' \
      --form 'payload={"inputs":[{"type":"BODY","contentType":"text","text": "Texte à analyser"},{"type":"ATTACHMENT","contentType":"file","file_key": "attachment_1"},{"type":"ATTACHMENT","contentType":"file","file_key": "attachment_2"}],"metadata":{}}' \
      --form 'attachment_1=@./document.pdf' \
      --form 'attachment_2=@./image.jpg'

Explication de la commande curl​

Vous devez téléverser un corps multipart/form-data, avec un champ payload décrivant ce que vous voulez envoyer à Golem.ai. Il y a aussi des champs pour chaque fichier à téléverser, leurs noms sont spécifiés dans le tableau inputs du champ payload.

Précisément, le texte à analyser est défini dans le tableau des inputs. Ici, le texte à analyser est : Texte à analyser.

Vous pouvez aussi intégrer des métadonnées, comme metadata ou name, vous pouvez les trouver dans la section "Les options de la requête" du guide de démarrage. Étant donné qu'il n'y a pas de nom de fichier principal, nous vous conseillons fortement de nommer vos analyses.