Passer au contenu principal
Ce guide vous expliquera un scénario d’utilisation courant : créer un nouvel espace de travail, y ajouter un document à partir d’une URL, puis vérifier que le document est correctement associé à l’espace de travail.
1

Créer un Nouvel Espace de Travail

Tout d’abord, créons un nouvel espace de travail pour contenir nos documents. Nous effectuerons une requête POST vers l’endpoint /workspaces. Vous pouvez lui donner un nom et une description pour garder les choses organisées.
curl -X POST "https://app.ubik-agent.com/api/v1/workspaces" \
     -H "X-API-KEY: VOTRE_CLE_API" \
     -H "Content-Type: application/json" \
     -d '{
          "name": "Mon Premier Projet",
          "description": "Espace de travail pour mon premier projet avec l''API UBIK."
        }'
L’API répondra avec les détails de l’espace de travail nouvellement créé, y compris son id unique. Conservez cet id car nous en aurons besoin à l’étape suivante.
2

Ajouter un Document à l'Espace de Travail

Maintenant que nous avons un espace de travail, ajoutons-y un document. Vous pouvez ingérer du contenu depuis une URL ou en téléversant un fichier directement. En passant les workspace_ids dans la requête, le nouveau document sera automatiquement associé à notre nouvel espace de travail.
curl -X POST "https://app.ubik-agent.com/api/v1/documents" \
     -H "X-API-KEY: VOTRE_CLE_API" \
     -F "urls=https://www.ubik-agent.com/" \
     -F "workspace_ids=VOTRE_ID_ESPACE_DE_TRAVAIL"

curl -X POST "https://app.ubik-agent.com/api/v1/documents" \
     -H "X-API-KEY: VOTRE_CLE_API" \
     -F "files=@/chemin/vers/votre/fichier.pdf" \
     -F "workspace_ids=VOTRE_ID_ESPACE_DE_TRAVAIL"
Le traitement des documents est asynchrone. L’API répondra immédiatement avec les détails du document et son statut (pending ou processing). Vous pouvez interroger l’endpoint du document pour vérifier quand le statut passe à completed.
3

Vérifier le Contenu de l'Espace de Travail

Enfin, vérifions que notre document a bien été ajouté à l’espace de travail. Nous ferons une requête GET vers l’endpoint /workspaces/{workspace_id}/documents.
curl -X GET "https://app.ubik-agent.com/api/v1/workspaces/VOTRE_ID_ESPACE_DE_TRAVAIL/documents" \
     -H "X-API-KEY: VOTRE_CLE_API"
La réponse confirmera que le document que nous avons ajouté à l’étape 2 est maintenant listé dans cet espace de travail.
4

Récupérer le Contenu du Document

Une fois qu’un document a été traité avec succès (status: "completed"), vous pouvez récupérer son contenu. L’API fournit une représentation Markdown du document, ce qui est utile pour l’envoyer à des LLMs ou pour l’afficher.
curl -X GET "https://app.ubik-agent.com/api/v1/documents/VOTRE_ID_DOCUMENT" \
     -H "X-API-KEY: VOTRE_CLE_API"
La réponse inclura les détails complets du document, y compris le markdown_content.
Félicitations ! Vous avez correctement créé un espace de travail, y avez ajouté un document, vérifié son contenu et récupéré son rendu traité. Vous êtes maintenant prêt à gérer l’organisation du contenu dans vos projets UBIK.