Aller au contenu principal
Version: Actuelle

Concepts

motce que c'est
tenantle client qui déploie la station. Sa config est un fichier YAML, identifié par tenant_id.
APIun service du tenant, décrit par son OpenAPI. Seules les opérations listées (operations) sont joignables, et chacune dit si elle lit ou écrit (access).
capabilityune opération autorisée d'une API. Rien d'autre n'est joignable.
itemune action possible : acheter un article, choisir un créneau, valider une feuille d'heures, rembourser une ligne de facture.
skill (skills:)ce que voit un agent : une capability qu'elle appelle (invoke), avec ce qu'il faut pour s'en servir. Une skill qui déclare des kinds transforme ses lignes en items qu'une personne peut choisir (select) et exécuter (submit) ; sans kinds, elle répond avec ce qu'elle lit. Les capabilities brutes ne sont jamais exposées.
kindla catégorie d'un item (dish, pickup, delivery), déclarée dans les kinds de sa skill. Un kind se reconnaît sur la ligne par son when, et peut avoir ses propres select et submit.
rooml'espace d'une personne avec la station, le même sur toutes les portes. Il garde sa sélection, son parcours et ses reçus.
sélectionce que la personne a choisi dans sa room, en vue du submit. Elle est faite de parts, une par skill à kinds.
select guardce qui doit être vrai pour qu'un item entre dans la sélection : une liste ordonnée : un formulaire (form), une condition (require), l'avis du tenant (check), un prix calculé par le tenant (update: {price}) ; chacune peut porter when.
submitl'exécution de la sélection : chaque skill appelle son opération (mode: request), renvoie la personne sur le site du tenant (handover), ou ne déclenche rien (self).
submit guardce qui est exigé une fois, avant le submit : des conditions acceptées, une confirmation explicite.
playbookun ensemble de tâches qui mène à un résultat : ce qu'une sélection doit couvrir avant de pouvoir être soumise, et dans quel ordre.

Qui fait quoi, aujourd'hui​

  • L'agent parle, montre les skills, ajoute ou retire des items quand la personne le demande.
  • La personne remplit les formulaires et soumet elle-même, d'un clic sur le bouton de sa sélection. Aujourd'hui, c'est toujours un humain qui soumet.
  • Core applique les gardes et le submit guard. Aucune consigne donnée à l'agent ne peut les contourner.