Ressources

Les Ressources dans SayMyData

Les Ressources permettent d'organiser

Vos Bases de connaissances contiennent vos données et, en créant des Ressources, vous pouvez organiser et regrouper ces données.

Exemple

• Cabinet médical : Dans une Base de connaissances "Patients" chaque Ressource est un patient.

Les Ressources regroupent des Sources de données

Dans une Ressource, vous importez ou ajoutez des Sources de données (fichiers, textes bruts, pages web) qui sont analysées et dont les données indexées deviennent rattachées à la Ressource.

Retrouvez la liste des formats acceptés comme Sources de données ici : Sources de données

Exemple

Un cabinet médical crée une Base de connaissances "Patient" dans laquelle chaque Ressource est un patient. Chaque Ressource peut ainsi inclure :

• Des fichiers :

  • PDF : Ordonnances, prescriptions médicales, résultats d'analyses, etc.

  • Images : Imagerie médicale

  • etc.

• Du texte :

  • Comptes rendus médicaux et commentaires des médecins et d'autres soignants

Exemple d'appel API - Création d’une Ressource

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

Ci-dessous, l'appel API permettant de créer une nouvelle Ressource.

curl --location --request POST 'https://api.saymydata.com/v1/kb/{id}/resources' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "files": [
        {
            "filename": "ordonnance-patient-test-02032025.pdf",
            "payload": "CONTENU_EN_BASE64"
        }
    ],
    "url": [
        {
            "body": "https://example.com"
        }
    ],
    "texts": [
        {
            "body": "Ceci est un exemple de texte"
        }
    ]
}'

Explications

Désigner la Base de connaissances

L'URL doit désigner la Base de connaissances à dans laquelle créer la Ressource via{id}

https://api.saymydata.com/v1/kb/{id}/resources

Vous devez désigner la Base de connaissances dans laquelle créer la Ressource via {id}

Désigner les Sources de données

En créant une nouvelle Ressource, vous pouvez directement y ajouter des Sources de données via data.

Les Sources de données ajoutées doivent être désignées en fonction de leur type :

1. 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"
       }
     ]

2. url :

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

   • Exemple :

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

3. 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": "Ceci est un exemple de texte"
     }

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.