Passer au contenu principal
Pour tirer le meilleur parti de l’API UBIK, il est utile de comprendre les concepts clés avec lesquels vous allez travailler. Ce guide présente les composants principaux de notre plateforme.

Espaces de Travail

Conteneurs de haut niveau pour organiser vos projets et vos données.

Documents

Les informations brutes que vous fournissez, comme des PDF, des fichiers texte ou des pages web.

Outils

Fonctions puissantes et pré-construites qui effectuent des tâches complexes sur vos documents.

Compétences (Skills)

Instructions, logiques et capacités personnalisées regroupées dans des modules réutilisables.

Sessions d'Agent

Conversations avec état avec des agents IA qui maintiennent le contexte et l’historique.

Espaces de Travail (Workspaces)

Considérez un Espace de Travail comme un conteneur de haut niveau pour vos projets. C’est le principal moyen d’organiser et de séparer vos données. Chaque espace de travail peut contenir son propre ensemble de documents, d’outils et d’assistants.
  • Organisation: Regroupez les documents liés à un projet, une équipe ou un client spécifique.
  • Isolation: Les données au sein d’un espace de travail sont séparées des autres, garantissant confidentialité et contrôle.
  • Espace de Travail par Défaut: Chaque utilisateur dispose d’un espace de travail par défaut où les nouveaux documents sont ajoutés si aucun autre n’est spécifié.
Vous pouvez gérer vos espaces de travail via les points de terminaison /workspaces.

Documents

Un Document représente tout contenu que vous ingérez sur la plateforme UBIK. Il peut s’agir d’un fichier que vous téléchargez (comme un PDF ou un fichier .txt) ou d’une page web que vous scrapez. Une fois ingérés, les documents sont traités et stockés, ce qui les rend prêts à être utilisés par les Outils.
Vous pouvez gérer vos documents via les points de terminaison /documents.

Outils (Tools)

Un Outil est une fonction spécialisée qui effectue une tâche complexe et spécifique. Les outils sont conçus pour être puissants et asynchrones, vous permettant d’exécuter des tâches de longue durée sans bloquer votre application. Exemples d’utilisation :
  • Extraire des données financières d’un rapport.
  • Résumer un long document juridique.
  • Répondre à des questions basées sur le contenu de plusieurs documents.
Vous pouvez découvrir et exécuter des outils à l’aide des points de terminaison /tools.

Compétences (Skills)

Une Compétence (Skill) est un ensemble packagé d’instructions, de fichiers et de logiques qui définissent une capacité personnalisée pour vos agents IA. Au lieu de réécrire constamment des invites complexes ou de joindre des fichiers, vous pouvez les regrouper dans une compétence réutilisable.
  • Réutilisabilité : Créez une capacité une fois et partagez-la entre plusieurs agents.
  • Personnalisation : Fournissez des fichiers spécifiques (SKILL.md, scripts, données) pour guider le comportement de l’agent.
  • Contrôle d’accès : Partagez les compétences avec votre entreprise ou gardez-les privées pour votre compte utilisateur.
Vous pouvez gérer vos compétences à l’aide des points de terminaison /skills.

Sessions d’Agent

Une Session d’Agent est une conversation persistante et avec état avec un agent IA. Contrairement aux simples complétions de chat, les sessions maintiennent :
  • Historique de Conversation : Le contexte complet de l’interaction, y compris les chemins de branchement.
  • Contexte Documentaire : Fichiers et connaissances spécifiquement liés à la conversation.
  • Accès aux Outils : L’ensemble des outils que l’agent peut utiliser pour répondre aux questions ou effectuer des tâches.
Les sessions sont conçues pour construire des applications interactives comme des bots de support client, des assistants de recherche ou des outils d’analyse de données.
Vous pouvez créer et gérer des sessions via les points de terminaison /agent-sessions.