Répondre à un run qui attend¶
Un employé virtuel est un assistant avec une tâche permanente qu'il accomplit seul, selon un calendrier ou quand quelqu'un choisit Exécuter maintenant. Chaque fois qu'il démarre, c'est un run. Parfois un run s'arrête et demande quelque chose à une personne avant de continuer : il attend. Cette page s'adresse à vous, en tant que membre à qui on le demande.
Où voir un run qui attend¶
Ouvrez le Cockpit dans la navigation (sur un téléphone, l'onglet Cockpit). Un nombre à côté compte les runs qui attendent après vous ; il est relu chaque minute tant que la page est ouverte. Dans le Cockpit, la tuile en attente de vous filtre la liste sur ces runs, et chacun a un bouton Évaluer. Vous recevez aussi une notification, par e-mail également sauf si vous l'avez désactivé dans vos réglages de notifications, quand un run se met à attendre après vous, et une fois encore, en rappel, s'il attend toujours après un certain temps.
Qui est sollicité¶
Les personnes que l'employé virtuel nomme pour « demande de l'attention » (directement ou par un groupe), la personne qui a démarré le run et toute personne qui peut utiliser les employés virtuels dans votre organisation. Qui peut seulement voir les employés virtuels, un auditeur par exemple, lit un run et ses questions sans y répondre. Si vous voyez une question sans boutons, c'est pour cette raison.
Ce qu'on peut vous demander¶
- Approuver un appel d'outil. L'appel de l'assistant est retenu jusqu'à ce que quelqu'un décide, et la carte montre l'outil et exactement avec quoi il sera appelé. Choisissez Approuver, ou Refuser avec un commentaire qui retourne à l'assistant. Un appel refusé n'est jamais effectué. Si l'outil demande toujours une approbation, l'appel figure aussi dans Approbations (Approuver un outil).
- Répondre à une question. La carte montre la question et ses champs. Remplissez-les, choisissez une des options si l'assistant en propose (ou Autre… pour écrire votre propre réponse) et cochez Je ne sais pas pour un champ auquel vous ne pouvez pas répondre. Choisissez Envoyer.
- Décider de vérifications non remplies. Quand un run signale qu'il n'a pas rempli ses critères, la carte les énumère. Continuer quand même les accepte comme non remplis : le run continue et peut encore aboutir. Ne pas continuer laisse le run se terminer en échec.
- S'authentifier auprès d'une connexion. Le compte de l'assistant n'est pas encore authentifié auprès d'une connexion dont le run a besoin, et la carte la nomme. Les personnes sollicitées et les administrateurs de votre organisation sont prévenus. Quiconque peut modifier cet employé virtuel et détient tout ce que détient son compte voit le bouton d'authentification avec le nom de la connexion ; les autres lisent qu'ils doivent demander à une telle personne. Connectez-vous avec le compte que votre organisation a réservé à cet assistant, pas avec le vôtre : tout ce que l'assistant fait sur cette connexion se fait sous l'identifiant que vous utilisez, pour tous ses employés virtuels, et OS ne peut ni le voir ni l'annuler. Personne ne répond à cette question : environ une minute après l'authentification, le run reprend de lui-même.
La première réponse compte : si un collègue a répondu avant vous, OS vous le dit. Une question à laquelle personne ne répond en 30 jours est annulée, et le run se termine en échec ; l'attente d'une authentification s'arrête après 7 jours, et le prochain moment planifié lance un nouveau run.
Après votre réponse¶
Le run continue aussitôt. La page du run montre son historique étape par étape, avec qui a répondu à chaque question et quand. Depuis la même page, vous pouvez arrêter un run encore en cours, relancer un run terminé et le supprimer, dans la mesure où vos droits le permettent ; les boutons que vous ne pouvez pas utiliser ne sont pas affichés. Les appels au modèle dans l'historique montrent ce que l'assistant a fait entre les étapes. Ce qu'un run a coûté figure sous Détails, uniquement si votre organisation vous laisse voir les coûts.
Via l'API¶
GET /api/v1/organisations/{id}/runs/attention compte les runs qui attendent après vous ;
GET …/runs/{run_id} renvoie un run avec ses questions ; POST …/runs/{run_id}/waits/{wait_id}/answer
en répond à une, avec decision (approved ou rejected) et éventuellement comment, ou avec
values pour une question ; POST …/runs/{run_id}/waits/{wait_id}/sign-in répond où s'authentifier quand une authentification est attendue (url, expires_at), à ouvrir en pleine page et à ne jamais conserver, pour quiconque peut modifier l'employé virtuel et détient son compte; POST …/runs/{run_id}/cancel arrête un run.