06/Documentation
Agents durables sur le téléphone
À quoi ressemblent la section, les conversations, les questions et les accusés de réception d'un agent durable
Expérimental. Ce qu'un durable agent affiche sur le téléphone peut changer, ou la fonctionnalité peut être supprimée dans une version mineure ultérieure. Agents durables précise ce qui décide de son maintien.
Cette page présente chaque endroit où un durable agent apparaît sur votre téléphone : sa ligne sur le tableau de bord, sa liste de conversations, ses questions, le chat, ses starters et ses pushes. Agents durables associe d'abord un durable agent.
Un durable agent n'affiche une commande que pour ce qu'il a déclaré pouvoir faire dans son hello. Une ligne ci-dessous mentionnant une commande suppose que le durable agent l'a déclarée.
La section Durable agents sur le tableau de bord
Chaque durable agent correspond à une ligne dans la section Durable agents, séparée de vos espaces.
| partie de la ligne | ce qu'elle affiche |
|---|---|
| Ligne 1 | Le nom du durable agent issu de sources.json, et un badge Expérimental |
| Ligne 2 | Son runtime, le nom que le durable agent se donne dans son hello, sinon durable. Puis local ou remote |
| Bord droit, prêt | Le nombre de ses conversations ouvertes, et dans la couleur requiert-attention le nombre de celles qui vous attendent. Le second compteur est masqué à zéro |
| Bord droit, non prêt | Le mot Démarrage, Inaccessible ou Discordance de version, et aucun décompte |
Un durable agent joint sur son socket, ou sur http://127.0.0.1 ou http://localhost, est local. Toute autre URL est remote.
La section se place sous vos espaces. Elle remonte au-dessus dès qu'un durable agent a une conversation qui vous attend, puis redescend lorsque vous avez répondu à la dernière. Sans aucun durable agent rattaché, la section n'est pas affichée du tout.
Quand l'option « Afficher uniquement les volets qui requièrent une action » est active, la section ne liste que les durable agents qui vous attendent. Cliquez sur une ligne dans n'importe quel état pour ouvrir la liste des conversations de ce durable agent.
La liste des conversations
L'accueil d'un durable agent liste ses conversations comme une application de messagerie liste ses discussions.
Ce qui vous attend apparaît en premier, puis les autres conversations ouvertes, de la plus récente à la plus ancienne. Les conversations fermées suivent sous le libellé Fermé. Chaque ligne affiche le titre, son indicateur d'état, l'heure de sa dernière activité et une ligne en dessous : la question en attente, sinon le sous-titre du durable agent. Une ligne en attente indique aussi son nombre de questions ouvertes. Une ligne sans titre affiche « Conversation sans titre ».
Cliquez sur une ligne ouverte pour l'ouvrir dans Chat. Cliquez sur une ligne fermée pour la consulter en lecture seule. Une conversation fermée affiche un bouton Rouvrir quand le durable agent est capable d'en rouvrir une.
Les lignes ouvertes proviennent des données propres au tableau de bord, elles s'affichent donc immédiatement. Les lignes fermées proviennent du durable agent, que Collie interroge une fois par visite, puis à nouveau à l'ouverture ou la fermeture d'une conversation, jamais à chaque scrutation.
| au bas de la liste | lorsque |
|---|---|
| Charger plus | Le durable agent a plus de 100 conversations. Chaque clic charge les 100 suivantes |
| « Ce durable agent ne conserve pas de liste de ses conversations. » | Le durable agent a répondu qu'il ne conserve aucune liste |
| « Le durable agent n'a pas répondu. Réessayez dans un instant. » | Le durable agent n'a pas répondu à la lecture |
| « Le durable agent utilise la version wire v2, ce Collie utilise la v1. Mettez à jour Collie ou le SDK de l'agent. » | Collie a rejeté le durable agent en raison de sa version wire (Confirmations) |
| « Impossible de charger les conversations. Réessayez. » | La lecture a échoué en cours de transfert |
Un agent durable qui ne conserve aucun historique affiche uniquement ses conversations ouvertes, sans groupe Fermé ni note. Une liste déjà affichée reste affichée si une lecture ultérieure échoue.
Une question sur le téléphone
La question d'un agent durable est une carte dans le chat, sous l'appel d'outil concerné.
La légende nomme l'agent durable, « Needs your answer · desk ». Quand l'agent durable a défini une expiration, la ligne sous le titre affiche un compte à rebours : « Expires in 4 min », puis « Expires in 40 s », puis « Expired ». Passé le délai d'expiration, les boutons restent affichés, et l'agent durable répond lui-même à un appui tardif.
| type | ce que la carte affiche | limites |
|---|---|---|
permission | Un bouton par option, selon les termes de Collie : Allow, Always allow, Deny ou Cancel. Le libellé propre à l'agent durable constitue la deuxième ligne discrète | Jusqu'à 6 options |
choice | Une ligne par option. Un appui envoie le choix. Avec multiple, les lignes basculent sous « Pick any number » et Send envoie la sélection | Jusqu'à 8 options |
text | Une ligne de saisie, un compteur tel que « 12 of 500 », et Send | 500 caractères, ou la limite de l'agent durable jusqu'à 2000 |
form | Ses champs superposés sous un seul bouton Send : une ligne de texte, un choix sous forme de liste d'options, ou un commutateur. Un champ obligatoire indique Required | Jusqu'à 6 champs |
« Always allow » nécessite deux appuis. Le premier transforme le bouton en « Tap again to always allow » avec le nom de l'outil. Le second l'envoie. Collie ne le propose pas lorsque la question ne nomme aucun outil.
Quand Collie a dû tronquer ou nettoyer le texte de l'agent durable, la carte indique « Text shortened » et ne propose aucun « Always allow », car le texte complet ne vous a pas été présenté.
Une carte d'un type que ce Collie ne connaît pas affiche son texte et indique « This ask cannot be answered from the phone. » Une conversation affiche ses 5 premières questions sous forme de cartes, et une ligne « Show N more » ouvre les suivantes.
Ce qui se passe après un appui
Chaque appui transmet un identifiant de requête, et seul un appui envoie une réponse.
| ce qui s'est passé | ce que la carte indique | que faire |
|---|---|---|
| L'agent durable a pris en compte la réponse | Rien : la carte se ferme | Rien |
| L'agent durable a pris la décision en premier | « Decided in the durable agent. » | Rien. Le chat conserve une ligne pour cet événement |
| Le délai de la question a expiré en premier | « Expiré avant une réponse. » | Rien. Le chat conserve une ligne pour cet événement |
| Une autre réponse est arrivée en premier | « Déjà répondu. Cette carte disparaîtra à la prochaine mise à jour. » | Rien |
| La question n'était pas ouverte, et l'agent durable n'a pas indiqué pourquoi | « Non pris en compte. La question peut réapparaître dans un instant. » | Attendez. Un agent durable qui a redémarré pose à nouveau la question |
| La question a été modifiée entre-temps | « Cette demande a changé. Relisez-la, puis appuyez sur une réponse. » | Lisez le nouveau formulaire et appuyez à nouveau |
| La réponse n'est peut-être pas arrivée | « Pas certain que la réponse soit arrivée. Réessayer l'envoie une fois de plus. » | Appuyez sur Réessayer. Cela envoie le même identifiant de requête, l'agent durable n'est donc notifié qu'une fois |
| Une nouvelle tentative a trouvé la question fermée ou modifiée | « Peut-être déjà appliqué. Vérifiez le chat. » | Vérifiez le chat |
| Collie a refusé la réponse | La raison donnée par Collie, sinon « La réponse a été refusée. » | Lisez la raison |
| La machine de l'agent durable exécute une version plus ancienne de Collie | « Cette machine exécute une ancienne version de Collie et ne peut pas recevoir de réponses ici. Mettez-la à jour, ou répondez dans l'agent durable. » | Mettez à jour cette machine |
Confirmations
Collie vous indique comment une question s'est terminée si vous n'y avez pas répondu, et pourquoi un agent durable est refusé.
| cas | ce que vous voyez |
|---|---|
| La question a une date d'expiration | La carte affiche le temps restant sous son titre |
| Vous avez appuyé après la décision de l'agent durable, ou après l'expiration | La carte se fige et indique « Décidé dans l'agent durable. » ou « Expiré avant une réponse. » |
| Le délai d'une question a expiré, ou l'agent durable a tranché, sans action de votre part | Une ligne dans le chat : « Expiré avant une réponse : » ou « Décidé dans l'agent durable : », suivie du titre de la question |
| Collie a refusé l'agent durable en raison de sa version de protocole réseau | Un encadré d'avertissement sur l'accueil de l'agent durable, et les mots Incompatibilité de version sur sa ligne du tableau de bord |
Une question à laquelle vous avez répondu depuis le téléphone, ou qui s'est terminée parce que vous avez arrêté le tour, ne laisse aucune ligne de ce type. Votre action avait déjà sa carte.
L'encadré d'avertissement indique la version de protocole utilisée de chaque côté, par exemple « Le programme utilise le protocole v2, ce Collie utilise la v1. Mettez à jour Collie, ou le SDK de l'agent durable. » Mettez à jour la partie la plus ancienne. Versions contient la règle.
Le chat
La conversation d'un agent durable s'ouvre dans Chat, sa seule vue.
| élément provenant de l'agent durable | ce qu'affiche Chat |
|---|---|
user | Votre propre ligne |
reply | La réponse de l'agent |
thinking | Le raisonnement de l'agent |
notice | Une courte note dans le fil |
markdown | Markdown interprété : titres, listes, mise en valeur, code et liens. Le HTML brut s'affiche sous forme de texte |
code | Un bloc de code, avec son langage si l'agent durable en a indiqué un |
link | Une ligne de lien avec son libellé, sinon l'adresse. Uniquement les liens https:// |
tool | Un appel d'outil : en cours, terminé avec son résultat, échoué ou refusé |
Un élément reply, thinking, notice ou markdown encore en cours d'écriture affiche un curseur à sa fin et aucun horodatage. Le curseur disparaît dès que le texte final arrive. Un tour que vous avez arrêté laisse la note « stopped ».
Votre propre ligne
Votre ligne s'affiche dans le fil dès que vous appuyez sur Envoyer, accompagnée d'une petite horloge. Quand la propre copie de l'agent durable arrive, elle prend la place de cette ligne.
| état | ce que la ligne indique |
|---|---|
| Envoi en cours, ou envoyé | L'horloge. La zone de saisie indique « Sent » dès que l'agent durable l'a reçue |
| La réponse n'est jamais arrivée | « Sending, not confirmed ». Renvoyer réessaie avec le même identifiant de requête |
| Refusé, ou le tour est passé à la suite | « Not sent », et vos termes reviennent dans le champ |
Un agent durable qui ne renvoie pas l'identifiant de requête est associé au même texte sous 30 secondes. Une ligne que l'agent durable ne renvoie jamais cesse d'apparaître après 10 minutes.
Tant que votre ligne reste le message le plus récent du fil et que l'agent durable n'a pas répondu, une rangée de trois points indique qu'il travaille.
L'en-tête
L'en-tête comporte deux lignes. La ligne 1 affiche le titre de la conversation et le badge Expérimental.
| la ligne 2 affiche | lorsque |
|---|---|
| "Étape 2 sur 3 : Enregistrer une note" | L'agent persistant signale des étapes et l'une d'elles est en cours |
| "42 % : téléversement" | L'agent persistant signale un pourcentage, avec son libellé |
| Le sous-titre de l'agent persistant | Aucune progression, ou toutes les étapes sont terminées |
| L'espace de travail | L'agent persistant n'en définit aucun |
La progression ne s'affiche que pendant que la conversation travaille ou attend votre intervention.
La ceinture
La ceinture contient Guider et Arrêter, puis jusqu'à 4 boutons propres à l'agent persistant.
Guider envoie votre texte dans le tour en cours au lieu d'en démarrer un nouveau. Arrêter met fin au tour en cours. Un bouton inactif reste grisé à sa place, afin que rien ne bouge.
| bouton de l'agent persistant | la règle |
|---|---|
| Libellé | 16 caractères au maximum |
| Icône | L'une des 12 suivantes : play, pause, check, x, refresh, archive, flag, star, send, note, search, more. Tout autre nom n'affiche aucune icône |
| Occupé | Un indicateur de chargement, et aucun appui |
| Désactivé | Grisé, et aucun appui |
Un appui désigne le tour le plus récent détecté par le téléphone. Si la conversation a évolué entre-temps, rien ne s'exécute et le téléphone l'indique : "La conversation a avancé, l'action n'a donc pas été exécutée." Vérifiez la situation, puis appuyez à nouveau sur le bouton si nécessaire.
Ce qu'un panneau d'agent persistant ne contient pas
Un agent persistant n'a pas d'écran : son panneau ne comporte donc pas de vue Terminal, pas de bandes d'onglets ou de panneaux, et aucun bouton Touches, Saisie ou Rapide. Son menu ne contient pas Historique, Paramètres du panneau ou Épingler en haut. Dans le menu, Fermer devient "Fermer la conversation".
Nouvelle conversation et amorces
La page Nouveau d'un agent persistant s'intitule Nouvelle conversation et liste les amorces de l'agent persistant.
Une amorce ne prend aucun dossier ni texte : l'agent persistant décide où il opère. Appuyez sur l'une d'elles et l'agent persistant ouvre une nouvelle conversation. La page ne propose aucun agent, shell ou commande de la machine. Un agent persistant sans amorce affiche "L'agent persistant de cette machine ne propose encore aucune amorce."
Push
Une question peut envoyer un push sur votre téléphone, dans les limites définies pour chaque agent durable.
| plafond | limite | au-delà |
|---|---|---|
| Un volet | 3 pushs par minute | La question s'affiche sur le téléphone et n'envoie aucun push |
| Un agent durable sur une machine | 10 pushs par minute | À l'identique |
| Un agent durable sur une machine | 30 pushs par heure | Un push, « A durable agent on {host} is raising many asks », puis aucun push venant de cet agent durable pendant une heure |
Le push indique « Permission needed in » suivi du nom du volet. Un agent durable peut ajouter son propre titre, de 60 caractères au maximum, et une ligne, de 120 caractères au maximum. Collie n'envoie un push pour une question qu'une seule fois par machine, agent durable et appel d'outil ; une question posée à nouveau après un redémarrage s'affiche donc sans renvoyer de push. Pushs émis par un agent durable détaille le reste.
Masquage
Lorsque le masquage des secrets est actif (COLLIE_REDACT, activé par défaut), Collie masque les secrets dans les titres et sous-titres de la liste des conversations d'un agent durable.
Dans une crew
Le tableau de bord du lead comporte une section Durable agents pour chaque machine de la crew. L'agent durable d'un membre ajoute le nom du membre sur la ligne 2, par exemple pi-durable, local, workshop, et les propres agents durables du lead ne mentionnent aucune machine. Une question sur n'importe quelle machine place cette unique section au-dessus des espaces. Agents durables dans une crew précise qui répond à quoi.
Modifier cette page sur GitHub