Sources de données

Les Sources de données dans SayMyData

Vous créez des Bases de connaissances dans lesquelles vous créez des Ressources et vous y ajoutez vos Sources de données.

Les Sources de données, ce sont les données non-structurées de votre organisation que SayMyData va analyser et indexer pour que vos données deviennent exploitables.

Types de Sources de données acceptées

Voici les Sources de données qui peuvent être analysées par SayMyData :

• Fichiers :

  De nombreux formats de fichiers peuvent être analysés et transformés en données indexées : Formats textuels (.pdf, .epub, .doc, ...), Feuilles de calculs, Images, etc.

• Texte

  Du texte brut peut être directement analysé et associé à une Ressource.

• Lien / Page Web Vous pouvez directement associer l'URL d'une page web pour que son contenu soit analysé et associé à une Ressource.

Exemple d'appel API - Ajouter une Source de données

Consultez l'ensemble des routes API dans cette documentation : Routes

Ci-dessous, l'appel API permettant d'ajouter une Source de données dans une de vos Ressources.

Pour cet exemple, nous allons ajouter 3 Sources de données : Un fichier, une URL et du texte.

curl -L \​
  --request POST \​
  --url 'https://api.saymydata.fr/v1/kb/{id}/resources/{resource_id}/upload' \​
  --header 'X-API-Key: VOTRE_API_KEY' \​
  --header 'Content-Type: application/json' \​
  --data '{
    "files": [
        {
            "filename": "ordonnance-patient-test-02032025.pdf",
            "payload": "CONTENU_EN_BASE64"
        }
    ],
    "url": [
        {
            "body": "https://example.com"
        }
    ],
    "text": [
        {
            "body": "Entretien du 02-03-2025 : Prescription anti-inflammatoire"
        }
    ]
}'

Explications :

Désigner la Ressource et la Base de connaissances

L'URL doit désigner la Base de connaissances via{id} et la Ressource à laquelle ajouter vos Sources de données via {resource_id}

https://api.saymydata.fr/v1/kb/{id}/resources/{resource_id}/upload'

Désigner les Sources de données

Les Sources de données que vous ajoutez sont désignées dans les data et leur type détermine les informations obligatoires lors de l'appel API :

• files :

  • Description : Un tableau contenant les fichiers associés à la Ressource. Chaque fichier doit inclure son nom (filename) et son contenu en base64 (payload).

  • Exemple :

    "files": [
      {
         "filename": "ordonnance-patient-test-02032025.pdf",
         "payload": "CONTENU_EN_BASE64"
      }
    ]

• url :

  • Description : Un tableau de liens associés à la ressource. Chaque lien doit inclure l'URL (url).

  • Exemple :

    "url": {
        "body": "https://example.com"
    }

• text :

  • Description : Un tableau de textes associés à la ressource. Chaque texte représente un contenu textuel spécifique lié à cette ressource. Cela peut inclure des descriptions, des notes ou tout autre type de texte.

  • Exemple :

    "text": {
        "body": "Entretien du 02-03-2025 : Prescription anti-inflammatoire"
    }

Dans une requête de création de ressource via l'API, au moins un des champs suivants doit être présent :

• files : Pour attacher des fichiers à la ressource.

• url : Pour associer un lien externe à la ressource.

• text : Pour inclure un texte explicatifs ou descriptifs.