Wissen

Der Tab Wissen: alle Memories des Projekts, gruppiert um die C4-Elemente, auf die sie sich beziehen

Der Tab Wissen zeigt das gemeinsame Gedächtnis eines Projekts als eine einzige Karte. Memory ist das, was der Code nicht verrät: der Fallstrick, über den jemand in Produktion gestolpert ist, die Konvention, auf die sich ein Team geeinigt hat, die Notiz, die ein Agent am Ende einer Arbeitssitzung hinterlassen hat. Menschen schreiben sie in der App, Agenten über den Harness (remember, finish_work_session). Beides landet am selben Ort, und beides wird dem nächsten Agenten bereitgestellt, der denselben Teil des Systems anfasst.

Sie öffnen den Tab über den Projekt-Header (Wissen), über die Befehlspalette oder über einen Link, den jemand geteilt hat.

Die Karte lesen

  • Elemente sind die Ringe: die C4-Systeme, -Container und -Komponenten, um die es im Wissen geht. Jedes Memory liegt um das Element, an das es angeheftet ist.
  • Memories sind die Punkte, eingefärbt nach Art: Fallstrick, Konvention, Notiz. Ein Punkt mit hellem Innenring wurde von einem Menschen geschrieben, die anderen stammen von Agenten.
  • Entscheidungen (ADRs) sind Quadrate. Sie erscheinen, wenn ein Memory mit [[ADR-12]] auf eine verlinkt.
  • Gestrichelte Geister sind Links, die noch niemand geschrieben hat: Ein Memory erwähnt [[Rate limits]], aber kein Memory trägt diesen Titel. Klicken Sie darauf, um es zu schreiben.

Die Karte bleibt auch bei Tausenden von Memories lesbar. Memories, die denselben Fakt aussagen, werden zu einem Punkt zusammengefaltet, markiert mit ×3, wenn drei Kopien ihn enthalten. Sitzungsergebnisse sind standardmäßig ausgeblendet und werden an ihrem Element gezählt; blenden Sie sie über die Sitzungen-Schaltfläche in der Werkzeugleiste ein. Die Legende der Arten dient zugleich als Filter, und die Zeitleiste unten spielt ab, wie das Wissen gewachsen ist.

Klicken Sie auf einen Punkt, um das Memory vollständig zu lesen, mit seinen Links und Backlinks. Klicken Sie auf ein Element, um alles zu sehen, was daran angeheftet ist, und das nächste Memory dazu zu schreiben.

Tastatur: / sucht, N schreibt ein Memory, F zeigt die ganze Karte, Esc geht einen Schritt zurück.

Eine Frage stellen

Eine Antwort, die nur aus dem Gedächtnis des Projekts geschrieben wurde; die Memories, auf denen sie beruht, sind auf der Karte hervorgehoben

Geben Sie eine Frage in das Suchfeld ein und klicken Sie auf Fragen (oder drücken Sie Enter nach einem Fragezeichen). Die Antwort wird nur aus den Memories des Projekts geschrieben, mit derselben Suche, die auch Agenten verwenden: Wörter und Bedeutung, dazu die Memories, die mit den besten Treffern verlinkt sind. Jede Aussage nennt ihre Quelle als Nummer; ein Klick darauf zeigt dieses Memory auf der Karte, wo die zitierten Memories hervorgehoben sind.

Wenn das Gedächtnis nichts zum Thema enthält, sagt die Antwort das, statt zu raten. Das ist der Moment, den Fakt aufzuschreiben: Die nächste Person und der nächste Agent finden ihn dann. Ist kein KI-Anbieter verfügbar, erhalten Sie statt einer Antwort die ähnlichsten Memories. Fragen zählt nicht als Bereitstellung an einen Agenten und verfälscht daher die Nutzungszahlen weiter unten nicht.

Antworten nutzen den KI-Anbieter Ihrer Organisation, wie die anderen Harness-Funktionen.

Widersprüche

Ein Fakt wird geschrieben, der einem bereits bekannten widerspricht

Wenn Sie ein Memory schreiben, das fast wie ein bestehendes zu denselben Elementen klingt, aber andere Zahlen nennt („8-mal wiederholt“ gegenüber „3-mal wiederholt“), hält Archyl an, bevor der Dialog schließt, und zeigt beide. Zwei aktive Memories, die sich widersprechen, sind das Schlimmste, was ein Agent bekommen kann. Deshalb entscheiden Sie:

  • Das alte ersetzen: Das alte Memory wandert in den Verlauf. Agenten sehen es nicht mehr, und die Karte behält es als Geist, verlinkt mit seinem Ersatz.
  • Beide behalten: Wenn beide stimmen (zwei Umgebungen, zwei Mandanten), behalten Sie beide und machen den Unterschied explizit.
  • Meines verwerfen: Ihr Memory war das falsche.

Wer einen bestehenden Fakt wortgleich noch einmal schreibt, legt keine zweite Kopie an: Stattdessen wird das bestehende Memory bestätigt, und der Dialog weist darauf hin. Agenten werden über die API genauso behandelt, in den Feldern deduplicated und conflicts von remember.

Auf jeden Fakt verlinken

Jedes Memory und jedes Element hat eine eigene Adresse. Der Link im Lesebereich kopiert sie; fügen Sie sie in einen Pull Request, ein ADR oder einen Slack-Thread ein, und sie öffnet die Karte bei diesem Memory mit seinen Nachbarn. Links auf ein Memory funktionieren weiter, nachdem es mit einem Duplikat zusammengeführt wurde, und ein Link auf ein inzwischen ersetztes Memory öffnet die Verlaufsansicht, damit er trotzdem irgendwo ankommt.

Duplikate

Wenn Agenten denselben Fakt auf verschiedene Weise schreiben, zeigt die Schaltfläche Duplikate jede Gruppe. Zu einem zusammenführen behält die am häufigsten bestätigte Kopie, zieht die anderen zurück und verschiebt deren Links. Zusammenführen ist immer Ihre Entscheidung: Ähnliche Formulierungen zu zwei verschiedenen Elementen oder mit unterschiedlichen Zahlen werden nie als Duplikat vorgeschlagen.

Zu prüfen

Memories, deren Element sich seit der Bestätigung geändert hat, und Memories, die Agenten nie nutzen

Memory, das niemand neu prüft, wird still und leise falsch. Die Lesart Zu prüfen lässt nur die Memories in voller Stärke auf der Karte, die einen menschlichen Blick brauchen, und listet sie auf:

  • Ihr Element hat sich geändert: Der Code unter dem Element hat sich verändert, seit das Memory zuletzt bestätigt wurde. Agenten bekommen es weiterhin, markiert als zu prüfen. Stimmt es noch, bestätigt Stimmt noch es und entfernt die Markierung; andernfalls öffnen Sie es und korrigieren oder ersetzen es.
  • Agenten nutzen es nie: Es wurde fünf oder mehr Sitzungen bereitgestellt, und keine davon hat angegeben, dass es geholfen hat. Öffnen Sie es, um es zu schärfen, an das richtige Element anzuheften oder zu löschen.

Nichts auf dieser Liste wird automatisch entfernt. Dieselben Einträge erreichen das Team im wöchentlichen Digest, damit die Liste nicht davon abhängt, dass jemand den Tab öffnet.

Nutzung

Memories, deren Größe zeigt, wie oft sie Agenten bereitgestellt wurden; hohle wurden bereitgestellt und nie genutzt

Die Lesart Nutzung bemisst die Größe jedes Memorys an der Zahl der Agenten-Sitzungen, denen es bereitgestellt wurde. Volle Punkte wurden mindestens einmal genutzt (ein Agent hat sie beim Abschluss seiner Sitzung in usedMemories genannt), hohle wurden bereitgestellt und nie genutzt, blasse wurden nie bereitgestellt. So beantwortet die Karte auf einen Blick zwei Fragen: Welches Wissen trägt die Arbeit der Agenten wirklich, und welches ist nur Rauschen?

Berechtigungen

Wer das Projekt ansehen kann, kann die Karte lesen und Fragen stellen. Memories schreiben, bestätigen, zusammenführen, ersetzen und löschen erfordert Bearbeitungsrechte für das Projekt.