Assistant IA

Chaque utilisateur a son assistant IA, qu'il retrouve dans l'application sous « Mon assistant ». L'API vous laisse lui parler à sa place, depuis votre logiciel : une question (« quels sont mes rendez-vous de demain ? »), une tâche (« prépare une relance pour les devis en attente »), un résumé. L'assistant répond dans une conversation, celle de l'utilisateur, avec les routes des conversations.

Une application qui écrit au nom de l'utilisateur — une application mobile, un panneau de votre logiciel — fait tout ce que fait l'application : elle dit à l'assistant ce que l'utilisateur regarde, reçoit ses réponses en temps réel, laisse noter chaque réponse, et peut faire dicter la demande.

Le déroulé

1. Ouvrir la conversation de l'assistant : POST https://staging-api.docage.com/Assistant/Conversation rend son identifiant.
2. Confier une demande et lire la réponse : POST https://staging-api.docage.com/Assistant/Context dit d'abord ce que l'utilisateur regarde, si vous le savez ; POST https://staging-api.docage.com/Conversations/{id}/Messages écrit la demande ; GET https://staging-api.docage.com/Assistant/Messages/{id}/Run dit quand l'assistant a terminé ; GET https://staging-api.docage.com/Conversations/{id}/Messages lit ses réponses.
3. Accepter ou refuser une proposition : ce que l'assistant ne fait pas seul, il le propose ; POST https://staging-api.docage.com/Assistant/Proposals/{id}/Accept le fait faire.
4. Noter une réponse de l'assistant : PUT https://staging-api.docage.com/Assistant/Messages/{id}/Feedback, utile ou à améliorer.

Une demande peut se dicter plutôt que se taper : voir Dicter un message.

Les règles

• L'assistant agit au nom de l'utilisateur authentifié, avec ses droits : il ne voit et ne fait rien que l'utilisateur ne pourrait voir ou faire. Chaque appel de votre logiciel désigne donc l'utilisateur à qui vous parlez — son jeton, ou sa clé API.
• Il lit seul, il propose avant d'agir : il cherche et lit les fiches de lui-même, mais ce qui part vers l'extérieur ou ne se défait pas — un email, un parcours envoyé, une suppression — est une proposition, qui attend la décision de l'utilisateur. Certaines actions lui sont fermées, quoi qu'on lui demande : les droits, une signature, les réglages de l'assistant.
• La conversation est celle de l'application : ce que vous y écrivez, l'utilisateur le retrouve dans « Mon assistant », et les réponses comptent comme non lues. Personne d'autre que lui n'y entre.
• Il répond dans la langue du profil de l'utilisateur.
• Ses réglages se font dans l'application, par l'utilisateur et par les administrateurs de son organisation : ce qu'il peut faire de lui-même, ce qu'il retient de l'utilisateur, le modèle qui lui répond. Aucune route de l'API ne les sert : une application mobile y renvoie l'utilisateur.
• L'assistant s'ouvre ou se ferme par l'offre de l'organisation et par sa fiche ; son usage se compte en jetons, facturés à l'organisation selon ses conditions. Une organisation qui n'est pas encore en production l'essaie dans une limite quotidienne.
• Ses échanges sont gardés 90 jours d'office.