06/Documentation
Persistente Agenten auf dem Smartphone
Wie der Bereich, die Unterhaltungen, Fragen und Bestätigungen eines persistenten Agenten aussehen
Experimentell. Was ein Durable Agent auf dem Telefon anzeigt, kann sich in einer späteren Minor-Version ändern, oder die Funktion wird entfernt. Persistente Agenten beschreibt, woran sich entscheidet, ob sie bleibt.
Diese Seite zeigt jede Stelle, an der ein Durable Agent auf Ihrem Telefon erscheint: seine Zeile im Dashboard, seine Konversationsliste, seine Fragen, den Chat, seine Starter und seine Push-Nachrichten. Persistente Agenten bindet zuerst einen Durable Agent an.
Ein Durable Agent zeichnet ein Bedienelement nur für das, was er in seinem Hello als unterstützt deklariert hat. Eine Zeile weiter unten, die ein Bedienelement nennt, setzt voraus, dass der Durable Agent es deklariert hat.
Der Bereich Durable Agents auf dem Dashboard
Jeder Durable Agent ist eine Zeile im Bereich Durable Agents, getrennt von Ihren Spaces.
| Teil der Zeile | Was angezeigt wird |
|---|---|
| Zeile 1 | Der Name des langlebigen Agenten aus sources.json und ein Experimental-Badge |
| Zeile 2 | Dessen Laufzeit, der Name, den sich der langlebige Agent in seinem Hello selbst gibt, andernfalls durable. Danach local oder remote |
| Rechter Rand, bereit | Die Anzahl seiner offenen Unterhaltungen und in der Hervorhebungsfarbe die Anzahl jener, die auf Sie warten. Die zweite Anzahl wird bei null ausgeblendet |
| Rechter Rand, nicht bereit | Das Wort Starting, Unreachable oder Version mismatch und keine Zähler |
Ein langlebiger Agent, der über sein Socket oder über http://127.0.0.1 oder http://localhost erreicht wird, ist local. Jede andere URL ist remote.
Der Abschnitt befindet sich unter Ihren Spaces. Er rückt darüber, solange ein langlebiger Agent eine Unterhaltung hat, die auf Sie wartet, und wieder nach unten, sobald die letzte beantwortet ist. Wenn kein langlebiger Agent angebunden ist, wird der Abschnitt überhaupt nicht dargestellt.
Wenn "Nur Bereiche anzeigen, die Sie benötigen" aktiv ist, listet der Abschnitt nur die langlebigen Agenten auf, die auf Sie warten. Tippen Sie auf eine Zeile in einem beliebigen Zustand, um die Unterhaltungsliste dieses langlebigen Agenten zu öffnen.
Die Unterhaltungsliste
Die Startseite eines langlebigen Agenten listet seine Unterhaltungen so auf wie eine Messaging-App ihre Chats.
Was auf Sie wartet, steht an erster Stelle, danach die übrigen offenen Unterhaltungen, die neuesten zuerst. Die geschlossenen folgen unter der Beschriftung Geschlossen. Jede Zeile zeigt den Titel, ihre Statusmarkierung, den Zeitpunkt ihrer letzten Aktivität und eine Zeile darunter: die ausstehende Frage, andernfalls den Untertitel des langlebigen Agenten. Eine wartende Zeile zählt zudem ihre offenen Fragen. Eine Zeile ohne Titel trägt den Text "Unbenannte Unterhaltung".
Tippen Sie auf eine offene Zeile, um sie im Chat zu öffnen. Tippen Sie auf eine geschlossene Zeile, um sie schreibgeschützt zu lesen. Eine geschlossene Unterhaltung besitzt eine Schaltfläche zum Wiedereröffnen, sofern der langlebige Agent dies unterstützt.
Die offenen Zeilen stammen aus den eigenen Daten des Dashboards und werden daher sofort dargestellt. Die geschlossenen stammen vom langlebigen Agenten, den Collie einmal pro Besuch abfragt und erneut, sobald eine Unterhaltung geöffnet oder geschlossen wird, jedoch nie bei jedem Abrufzyklus.
| am Ende der Liste | wenn |
|---|---|
| Mehr laden | Der langlebige Agent hat mehr als 100 Unterhaltungen. Jedes Antippen liest die nächsten 100 ein |
| "Dieser langlebige Agent führt keine Liste seiner Unterhaltungen." | Der langlebige Agent hat geantwortet, dass er keine Liste führt |
| "Der langlebige Agent hat nicht geantwortet. Versuchen Sie es gleich noch einmal." | Der langlebige Agent hat auf den Lesevorgang nicht geantwortet |
| "Der langlebige Agent verwendet Wire-Version 2, dieses Collie verwendet Version 1. Aktualisieren Sie Collie oder das SDK des Agenten." | Collie hat den langlebigen Agenten aufgrund seiner Wire-Version abgelehnt (Empfangsbestätigungen) |
| "Die Unterhaltungen konnten nicht geladen werden. Versuchen Sie es erneut." | Der Lesevorgang schlug während der Übertragung fehl |
Ein durable Agent, der keinen Verlauf speichert, zeigt seine offenen Konversationen allein an, ohne Gruppe "Geschlossen" und ohne Hinweis. Eine bereits gezeichnete Liste bleibt gezeichnet, wenn ein späterer Lesevorgang fehlschlägt.
Eine Frage auf dem Telefon
Die Frage eines durable Agenten ist eine Karte im Chat unter dem Werkzeugaufruf, um den es geht.
Die Beschriftung nennt den durable Agenten: "Erfordert Ihre Antwort · desk". Wenn der durable Agent ein Ablaufdatum gesetzt hat, zählt die Zeile unter dem Titel herunter: "Läuft in 4 Min. ab", dann "Läuft in 40 s ab", dann "Abgelaufen". Nach Ablauf bleiben die Schaltflächen bestehen, und der durable Agent beantwortet ein verspätetes Antippen selbst.
| Art | Was die Karte anzeigt | Begrenzungen |
|---|---|---|
permission | Eine Schaltfläche pro Option, in Collies Worten: Zulassen, Immer zulassen, Ablehnen oder Abbrechen. Die eigene Beschriftung des durable Agenten steht unaufdringlich in der zweiten Zeile | Bis zu 6 Optionen |
choice | Eine Zeile pro Option. Ein Antippen sendet die Auswahl. Mit multiple schalten die Zeilen unter "Beliebig viele auswählen" um, und Senden überträgt die Auswahl | Bis zu 8 Optionen |
text | Eine Zeile zur Eingabe, ein Zähler wie "12 von 500" und Senden | 500 Zeichen oder das Limit des durable Agenten bis zu 2000 |
form | Die Felder unter einem einzigen Senden gestapelt: eine Textzeile, eine Auswahl als Liste oder ein Umschalter. Ein Pflichtfeld ist mit Erforderlich gekennzeichnet | Bis zu 6 Felder |
"Immer zulassen" erfordert zwei Fingertipps. Der erste ändert die Schaltfläche zu "Erneut tippen, um immer zuzulassen" und den Namen des Werkzeugs. Der zweite sendet sie ab. Collie bietet dies nicht an, wenn die Frage kein Werkzeug nennt.
Wenn Collie den Text des durable Agenten kürzen oder bereinigen musste, zeigt die Karte "Text gekürzt" und bietet kein "Immer zulassen", da Ihnen nicht der gesamte Text angezeigt wurde.
Eine Karte einer Art, die dieser Collie nicht kennt, zeigt ihren Text an und meldet: "Diese Anfrage kann nicht vom Telefon beantwortet werden." Eine Konversation zeichnet ihre ersten 5 Fragen als Karten, und eine Zeile "N weitere anzeigen" öffnet den Rest.
Was nach dem Antippen geschieht
Jedes Antippen übermittelt eine Anforderungs-ID, und nur ein Antippen sendet eine Antwort.
| Was geschah | Was die Karte anzeigt | Was zu tun ist |
|---|---|---|
| Der durable Agent hat die Antwort übernommen | Nichts: Die Karte schließt sich | Nichts |
| Der durable Agent hat zuerst entschieden | "Im durable Agenten entschieden." | Nichts. Der Chat behält eine Zeile dafür |
| Die Zeitüberschreitung der Frage trat zuerst ein | „Zeitüberschreitung vor einer Antwort.“ | Nichts. Der Chat behält eine Zeile dafür |
| Eine andere Antwort kam zuerst | „Bereits beantwortet. Diese Karte verschwindet bei der nächsten Aktualisierung.“ | Nichts |
| Die Frage war nicht offen, und der Durable Agent gab keinen Grund an | „Nicht angenommen. Die Frage wird möglicherweise gleich wieder angezeigt.“ | Warten Sie. Ein neu gestarteter Durable Agent fragt erneut nach |
| Die Frage hat sich zwischenzeitlich geändert | „Diese Anfrage hat sich geändert. Lesen Sie sie erneut und tippen Sie dann eine Antwort an.“ | Lesen Sie das neue Formular und tippen Sie erneut |
| Die Antwort ist möglicherweise nicht angekommen | „Nicht sicher, ob die Antwort angekommen ist. ‚Erneut versuchen‘ sendet sie noch einmal.“ | Tippen Sie auf ‚Erneut versuchen‘. Es sendet dieselbe Anfrage-ID, sodass der Durable Agent sie nur einmal erhält |
| Ein neuer Versuch ergab, dass die Frage geschlossen oder geändert wurde | „Wurde möglicherweise bereits angewendet. Überprüfen Sie den Chat.“ | Überprüfen Sie den Chat |
| Collie hat die Antwort abgelehnt | Grund von Collie, andernfalls „Die Antwort wurde abgelehnt.“ | Lesen Sie die Begründung |
| Auf dem Rechner des Durable Agents läuft ein älteres Collie | „Auf diesem Rechner läuft ein älteres Collie und Antworten können hier nicht angenommen werden. Aktualisieren Sie ihn oder antworten Sie im Durable Agent.“ | Aktualisieren Sie diesen Rechner |
Empfangsbestätigungen
Collie teilt Ihnen mit, wie eine Frage endete, wenn Sie sie nicht beantwortet haben, und warum ein Durable Agent abgelehnt wird.
| Fall | Was Sie sehen |
|---|---|
| Die Frage hat eine Ablaufzeit | Die Karte zeigt die verbleibende Zeit unter ihrem Titel an |
| Sie haben angetippt, nachdem der Durable Agent entschieden hatte oder nach Ablauf der Zeit | Die Karte friert ein und zeigt „Im Durable Agent entschieden.“ oder „Zeitüberschreitung vor einer Antwort.“ an |
| Eine Frage hat das Zeitlimit überschritten, oder der Durable Agent hat sie ohne Ihr Tippen entschieden | Eine Zeile im Chat: „Zeitüberschreitung vor einer Antwort:“ oder „Im Durable Agent entschieden:“, gefolgt vom Titel der Frage |
| Collie hat den Durable Agent wegen seiner Protokollversion abgelehnt | Ein Warnhinweis auf der Startseite des Durable Agents und der Text „Versionskonflikt“ in seiner Dashboard-Zeile |
Eine Frage, die Sie über das Smartphone beantwortet haben, oder eine, die endete, weil Sie den Durchlauf gestoppt haben, hinterlässt keine solche Zeile. Ihr Tippen hatte bereits eine eigene Karte.
Der Warnhinweis nennt die Protokollversion beider Seiten, zum Beispiel „Programm nutzt Wire-v2, dieses Collie nutzt v1. Aktualisieren Sie Collie oder das SDK des Durable Agents.“ Aktualisieren Sie die ältere Seite. Versionen enthält die Regel.
Der Chat
Die Unterhaltung eines Durable Agents öffnet sich im Chat, seiner einzigen Ansicht.
| Element des Durable Agents | Was der Chat anzeigt |
|---|---|
user | Ihre eigene Zeile |
reply | Die Antwort des Agenten |
thinking | Die Überlegungen des Agenten |
notice | Eine kurze Notiz im Verlauf |
markdown | Gerendertes Markdown: Überschriften, Listen, Hervorhebungen, Code und Links. Rohes HTML erscheint als Text |
code | Ein Codeblock mit Sprachangabe, sofern der Durable Agent eine angegeben hat |
link | Eine Linkzeile mit Beschriftung, andernfalls die Adresse. Nur https://-Links |
tool | Ein Tool-Aufruf: läuft, abgeschlossen mit Ausgabe, fehlgeschlagen oder verweigert |
Ein Element vom Typ reply, thinking, notice oder markdown, das noch wächst, hat einen Cursor am Ende und keinen Zeitstempel. Der Cursor verschwindet, sobald der endgültige Text eintrifft. Ein von Ihnen gestoppter Durchlauf hinterlässt den Vermerk „gestoppt“.
Ihre eigene Zeile
Ihre Zeile erscheint mit einer kleinen Uhr im Verlauf, sobald Sie auf Senden tippen. Trifft die Kopie des Durable Agents ein, ersetzt sie diese Zeile.
| Status | Was die Zeile anzeigt |
|---|---|
| Wird gesendet oder gesendet | Die Uhr. Das Eingabefeld zeigt „Gesendet“, sobald der Durable Agent die Nachricht übernommen hat |
| Die Antwort blieb aus | „Wird gesendet, nicht bestätigt“. Erneutes Senden wiederholt den Vorgang mit derselben Anforderungs-ID |
| Abgelehnt, oder der Durchlauf ist weitergegangen | „Nicht gesendet“, und Ihr Text wird wieder in das Eingabefeld eingefügt |
Antwortet ein Durable Agent nicht mit der Anforderungs-ID, wird die Zuordnung anhand des identischen Texts innerhalb von 30 Sekunden vorgenommen. Eine Zeile, die der Durable Agent nie zurückschreibt, wird nach 10 Minuten ausgeblendet.
Solange Ihre Zeile das neueste Element im Verlauf ist und der Durable Agent noch nicht geantwortet hat, signalisiert eine Reihe aus drei Punkten, dass er arbeitet.
Die Kopfzeile
Die Kopfzeile umfasst zwei Zeilen. Zeile 1 enthält den Titel der Konversation und das Kennzeichen „Experimental“.
| Zeile 2 zeigt | wenn |
|---|---|
| „Schritt 2 von 3: Notiz speichern“ | Der dauerhafte Agent meldet Schritte und einer wird ausgeführt |
| „42 %: Hochladen“ | Der dauerhafte Agent meldet einen Prozentwert mit seiner Beschriftung |
| Der Untertitel des dauerhaften Agenten | Kein Fortschritt oder jeder Schritt ist abgeschlossen |
| Der Arbeitsbereich | Der dauerhafte Agent setzt keines dieser Elemente |
Fortschritt wird nur angezeigt, während die Konversation arbeitet oder auf Sie wartet.
Die Leiste
Die Leiste enthält „Steuern“ und „Stopp“, danach bis zu 4 eigene Schaltflächen des dauerhaften Agenten.
„Steuern“ sendet Ihren Text in den laufenden Durchlauf, statt einen neuen zu starten. „Stopp“ beendet den laufenden Durchlauf. Eine Schaltfläche, die gerade nicht reagieren kann, wird an Ort und Stelle abgeblendet, sodass sich nichts verschiebt.
| Schaltfläche des dauerhaften Agenten | die Regel |
|---|---|
| Beschriftung | Höchstens 16 Zeichen |
| Symbol | Eines von 12: play, pause, check, x, refresh, archive, flag, star, send, note, search, more. Jeder andere Name zeichnet kein Symbol |
| Ausgelastet | Ein Ladeindikator, und kein Antippen |
| Deaktiviert | Abgeblendet, und kein Antippen |
Ein Antippen benennt den neuesten Durchlauf, den das Telefon registriert hat. Wenn die Konversation fortgeschritten ist, wird nichts ausgeführt und das Telefon meldet: „Die Konversation ist fortgeschritten, daher wurde die Aktion nicht ausgeführt.“ Prüfen Sie dies und tippen Sie die Schaltfläche erneut an, falls Sie die Ausführung weiterhin wünschen.
Was ein Bereich für einen dauerhaften Agenten nicht enthält
Ein dauerhafter Agent besitzt keinen Bildschirm. Daher enthält sein Bereich keine Terminal-Ansicht, keine Reiter- oder Bereichsleisten und keine Schaltflächen für „Tasten“, „Eingabe“ oder „Schnell“. Sein Menü enthält weder „Verlauf“, „Bereichseinstellungen“ noch „In oberster Zeile fixieren“. „Schließen“ im Menü lautet „Konversation schließen“.
Neue Konversation und Vorlagen
Die Seite „Neu“ eines dauerhaften Agenten trägt den Titel „Neue Konversation“ und listet die Vorlagen des dauerhaften Agenten auf.
Eine Vorlage erfordert weder Ordner noch Text: Der dauerhafte Agent entscheidet, wo er arbeitet. Tippen Sie eine an, und der dauerhafte Agent öffnet eine neue Konversation. Die Seite bietet keinen Agenten, keine Shell und keinen Befehl der Maschine an. Ein dauerhafter Agent ohne Vorlagen meldet: „Der dauerhafte Agent dieser Maschine bietet noch keine Vorlagen.“
Push
Eine Frage kann eine Push-Nachricht an Ihr Smartphone senden, innerhalb der Obergrenzen für jeden Durable Agent.
| Obergrenze | Limit | darüber hinaus |
|---|---|---|
| Ein Bereich | 3 Push-Nachrichten pro Minute | Die Frage erscheint auf dem Smartphone und sendet keine Push-Nachricht |
| Ein Durable Agent auf einer Maschine | 10 Push-Nachrichten pro Minute | Ebenso |
| Ein Durable Agent auf einer Maschine | 30 Push-Nachrichten pro Stunde | Eine Push-Nachricht, "A durable agent on {host} is raising many asks", danach eine Stunde lang keine Push-Nachricht von diesem Durable Agent |
Die Push-Nachricht lautet "Permission needed in" gefolgt vom Namen des Bereichs. Ein Durable Agent kann einen eigenen Titel hinzufügen (höchstens 60 Zeichen) sowie eine Zeile (höchstens 120 Zeichen). Collie sendet eine Frage nur einmal pro Maschine, Durable Agent und Tool-Aufruf als Push-Nachricht; eine nach einem Neustart erneut gestellte Frage wird daher angezeigt und löst keinen Push aus. Push-Nachrichten von einem Durable Agent enthält den Rest.
Maskierung
Wenn die Geheimnismaskierung aktiv ist (COLLIE_REDACT, standardmäßig aktiv), maskiert Collie Geheimnisse in den Titeln und Untertiteln der Konversationsliste eines Durable Agent.
In einer Crew
Das Dashboard des Leads enthält einen Abschnitt für Durable Agents für jede Maschine der Crew. Der Durable Agent eines Mitglieds fügt den Namen des Mitglieds in Zeile 2 ein, zum Beispiel pi-durable, local, workshop, und die eigenen Durable Agents des Leads nennen keine Maschine. Eine Frage auf einer beliebigen Maschine verschiebt diesen Abschnitt über die Bereiche. Durable Agents in einer Crew beschreibt, wer wofür antwortet.
Diese Seite auf GitHub bearbeiten