Der Assistent

Der Assistent ist ein KI-Agent, der in Echolot eingebaut ist. Du fragst in normalen Worten („Warum schlägt Create order fehl?“, „Schreib Prüfungen für diese Anfrage“), und er arbeitet mit deinem Arbeitsbereich über dieselben Tools, die auch externe Agenten bekommen: Er listet Anfragen auf und liest sie, sendet sie, liest Antworten, schreibt Prüfungen, bearbeitet Specs, startet Mocks und führt Flows aus. Jeder Aufruf erscheint im Bereich, während er passiert, und alles, was Daten ändern könnte, fragt vorher dich.

Den Assistenten öffnenCopy Anchor Link

Der Assistent ist ein Panel, das rechts auf jeder Seite andockt. Öffne oder schließe es auf einem dieser Wege:

• ⌘ J
• Ansicht › Assistent einblenden (oder Assistent ausblenden)
• Die Taste mit dem Zauberstab, die letzte der Tasten im Seitenkopf

Jedes Fenster hat seinen eigenen Assistenten, der am Arbeitsbereich dieses Fensters arbeitet.

Um das Panel breiter zu machen, ziehe seinen linken Rand nach links; es nimmt sich Platz von der Seite, bis hinunter zur Mindestbreite der Seite. Ziehe nach rechts, um es schmaler zu machen, und doppelklicke auf den Rand, um zur üblichen Breite zurückzukehren.

Einen Modellanbieter wählenCopy Anchor Link

Beim ersten Öffnen des Panels steht dort Modell wählen. Wähle Assistent-Einstellungen öffnen … oder öffne Einstellungen › Assistent und füge unter Anbieter hinzufügen einen Anbieter hinzu:

Wähle Hinzufügen. Echolot lädt die Modelle des Anbieters und nimmt das erste; wähle ein anderes im Menü Modell des Kontos oder wähle Modelle laden, um die Liste erneut abzurufen. Wo ein Anbieter keine Modelle auflistet, gib den Namen des Modells im Feld Modell ein.

Um den Assistenten kostenlos und offline auszuprobieren, lass ein Modell in Ollama laufen und füge es als Anbieter OpenAI-kompatibel mit der Standardadresse hinzu.

Schlüssel bleiben im SchlüsselbundCopy Anchor Link

API-Schlüssel liegen im Schlüsselbund deiner Anmeldung auf diesem Mac, nie im Arbeitsbereich, und werden nur an die eigene Adresse des Anbieters gesendet. Entfernen … neben einem Konto löscht seinen Schlüssel aus dem Schlüsselbund.

Zwischen Anbietern wechselnCopy Anchor Link

Hast du mehrere Anbieter, ist der mit Häkchen unter Einstellungen › Assistent › Anbieter der, den der Assistent nutzt. Du kannst auch im Panel wechseln: Das Modellmenü im Kopf des Panels listet jedes Konto als Anbieter · Modell, und Assistent-Einstellungen … an seinem Fuß öffnet die Einstellungen.

Lokale Coding-Agenten (CLI-Agent)Copy Anchor Link

Ein CLI-Agent bringt sein eigenes Modell und seine eigene Anmeldung mit. Echolot startet ihn im Ordner des Arbeitsbereichs und gibt ihm den Arbeitsbereich über den MCP-Server von Echolot, schalte also zuerst Einstellungen › Agenten › Agenten geöffnete Arbeitsbereiche nutzen lassen ein (siehe Externe Agenten). Wähle CLI-Agent (ACP) als Anbieter und dann einen Agent:

Den Befehl kannst du später im Feld Befehl des Kontos ändern. Jede Unterhaltung bekommt einen eigenen Agent-Prozess, der endet, wenn du das Fenster schließt. Auch die eigenen Berechtigungsanfragen des Agenten fragen dich.

Die einmalige ErlaubnisCopy Anchor Link

Vor der ersten Nachricht an einen Anbieter fragt Echolot: An Anbieter senden? Die Frage sagt, was dorthin geht (deine Nachrichten, die Daten des Arbeitsbereichs, die der Assistent liest, und seine Tool-Ergebnisse), wohin es geht und dass geheime Werte nie gesendet werden. Abbrechen ist die Standardtaste, sodass ↩ nie versehentlich sendet; wähle Erlauben, um fortzufahren.

Echolot fragt einmal pro Anbieter: einmal für Anthropic, einmal für OpenAI, einmal für Gemini, einmal für jeden OpenAI-kompatiblen Server (nach seinem Host) und einmal für jeden CLI-Agenten. Server auf diesem Mac (localhost, 127.0.0.1, ::1) fragen nie, weil nichts den Mac verlässt. Ein Server anderswo in deinem Netzwerk fragt.

Einstellungen › Assistent › Darf deine Daten erhalten listet jeden Anbieter, den du erlaubt hast. Entziehen nimmt die Erlaubnis zurück; die nächste Nachricht fragt wieder.

FragenCopy Anchor Link

Tippe in Frag den Assistenten … am Fuß des Panels. ↩ sendet, ⇧↩ beginnt eine neue Zeile, und ⌘. hält den Assistenten an, während er arbeitet.

Eine neue Unterhaltung beginnt mit Vorschlägen für die Seite, auf der du bist. Klicke auf einen, um ihn ins Textfeld zu übernehmen:

Was du geöffnet hast, geht mitCopy Anchor Link

Über dem Textfeld zeigen Chips, was du geöffnet hast: die offene Anfrage, die Seite „Tests“ und ihre fehlgeschlagenen Prüfungen, der letzte Durchlauf der Ausführung, die offene Spec, der offene Mock, Flow oder MCP-Server. Jeder Chip wird mit deiner Nachricht gesendet, sodass du „diese Anfrage“ oder „der letzte Durchlauf“ sagen kannst. Klicke auf einen Chip, um ihn bei der nächsten Nachricht wegzulassen; klicke noch einmal, um ihn zurückzuholen. Bewege den Zeiger über einen Chip, um den Satz zu sehen, den das Modell bekommt.

Was der Assistent kannCopy Anchor Link

Der Assistent hat jede Gruppe von Tools, die externe Agenten bekommen können, was auch immer unter Einstellungen › Agenten eingeschaltet ist: Anfragen und Antworten, Ordner samt ihren Prüfungen ausführen, Verlauf, Umgebungen, die Ordner und Variablen des Arbeitsbereichs, Specs, Mocks, MCP-Server und Flows. Genehmigungen gelten weiterhin für jede davon.

Die Tools, die die Richtlinie für Agenten, den Proxy, Zertifikate, die Auth des Arbeitsbereichs oder Skripte ändern, bekommt er nie.

Jeder Tool-Aufruf erscheint als Karte in der Unterhaltung, mit Eingabe und Ergebnis und dem Hinweis, ob er läuft, fertig ist oder fehlgeschlagen. Die Zeile unter dem Textfeld zeigt die bisher verbrauchten Tokens und, wo die Preise des Modells bekannt sind, ungefähr, was sie gekostet haben.

Genehmigen, was sich ändertCopy Anchor Link

Will der Assistent etwas tun, wonach die Richtlinie fragt, erscheint im Fenster ein Blatt: Der Agent möchte eine Anfrage senden, die Daten ändern kann mit dem Aufruf und der Anfrage, wie sie hinausginge, geheime Werte maskiert.

• Einmal erlauben führt diesen Aufruf aus.
• Für diese Sitzung erlauben führt diesen Aufruf und ähnliche Aufrufe ohne Nachfrage aus, bis das Fenster geschlossen wird: jede Änderung am Arbeitsbereich auf einmal, mit welchem Tool auch immer (eine Anfrage erstellen, dann die Auth eines Ordners sichern, dann eine Umgebung), und bei Anfragen dieselbe Methode an denselben Host (jedes GET an demo.echolot.dev). Löschen fragt weiterhin, ebenso geschützte Umgebungen, neue Hosts und alles, was enger gefasst ist als eine einfache Änderung, etwa die Version eines Flows; dafür gilt es nur für denselben Aufruf. Das Blatt sagt, was es abdeckt.
• Vor Änderungen und Sendungen nicht mehr fragen ist ein Ankreuzfeld auf dem Blatt für Änderungen und für Anfragen, die Daten ändern. Erlaubst du mit gesetztem Häkchen, wird Einstellungen › Assistent › Vorher fragen (unten) eingeschaltet. Für Löschen, neue Hosts oder geschützte Umgebungen wird es nicht angeboten.
• Ablehnen verweigert den Aufruf, und der Assistent erfährt es.

Bei einer Anfrage an einen neuen Host, an eine geschützte Umgebung und beim Löschen ist Einmal erlauben nicht die Standardtaste, sodass ↩ sie nicht genehmigen kann. Eine Frage, die niemand innerhalb von fünf Minuten beantwortet, wird abgelehnt. Warten mehrere Aufrufe, sagt das Blatt, wie viele es noch sind.

Was fragt, hängt von den Agentenregeln des Arbeitsbereichs ab. Ohne welche gilt:

Weniger fragenCopy Anchor Link

Einstellungen › Assistent › Vorher fragen › Nur vor dem Löschen, neuen Hosts und geschützten Umgebungen fragen beendet die Fragen zu Anfragen und Änderungen: Der Assistent erstellt Anfragen, Umgebungen, Specs, Mocks und Flows und sendet POST-, PUT- und DELETE-Anfragen, ohne zu fragen. Jeder Aufruf erscheint weiterhin in der Unterhaltung. Etwas in den Papierkorb zu legen, ein Host, den der Arbeitsbereich beim Start des Assistenten nicht nutzte, und eine geschützte Umgebung fragen weiterhin, ebenso das Ausführen eines Flows, der Agenten nicht angeboten wird. Die Option ist aus, bis du sie einschaltest, und gilt nur für den Assistenten; externe Agenten folgen den Regeln des Arbeitsbereichs.

Um diese zu lockern oder zu verschärfen oder um Hosts und Anfragen zu begrenzen, nutze Arbeitsbereichseinstellungen › Agenten: siehe Regeln des Arbeitsbereichs für Agenten. Dieselben Regeln gelten für externe Agenten. Ist Agenten dürfen diesen Arbeitsbereich nutzen dort aus, weigert sich auch der Assistent, in diesem Arbeitsbereich zu arbeiten.

Geschützte UmgebungenCopy Anchor Link

Solange eine geschützte Umgebung aktiv ist, fragt jede Anfrage, die der Assistent sendet, vorher, welche Methode sie auch hat und was die Regeln auch sagen. Für diese Sitzung erlauben deckt nur denselben Aufruf ab.

Was das Modell nie siehtCopy Anchor Link

• Geheime Werte. Echolot ersetzt den Wert jeder geheimen Variable, bevor irgendetwas an das Modell geht, in den Nachrichten, den Tool-Ergebnissen und den Fehlern. Das Modell sieht Secrets nur mit Namen.
• Deine eigenen Muster. Einstellungen › Assistent › Vor dem Modell verborgen nimmt einen regulären Ausdruck pro Zeile. Alles, was in dem, was die Tools zurückgeben, passt, wird durch [hidden] ersetzt, bevor das Modell es sieht. Nutze es für Daten, die keine geheime Variable sind, etwa Kunden-IDs oder E-Mail-Adressen. Eine Zeile, die kein gültiger regulärer Ausdruck ist, wird rot angezeigt und weggelassen.
• Ganze Bodys von Antworten. Antworten erreichen das Modell als Zusammenfassungen (Status, Header, Zeiten, eine Gliederung und die ersten Bytes des Bodys, Ergebnisse der Prüfungen) mit einem Handle; mehr vom Body liest es über dieses Handle, einen JSONPath oder eine Suche auf einmal.

Um genau zu sehen, was mit deiner nächsten Nachricht mitgeht, wähle im Kopf des Panels die Taste mit dem Auge, Was das Modell sieht. Sie zeigt die Anweisungen, die Tools, die Unterhaltung und den Kontext, mit einer Schätzung der Tokens.

Eine Unterhaltung aufbewahrenCopy Anchor Link

Unterhaltungen bleiben auf diesem Mac, pro Arbeitsbereich. Im Kopf des Panels:

• Neue Unterhaltung (der Stift) beginnt eine frische.
• Frühere Unterhaltungen (die Uhr) listet die Unterhaltungen unter Auf diesem Mac und unter In diesem Arbeitsbereich geteilt. Klicke auf eine, um sie zu öffnen.
• Das Menü zum Aufbewahren (das Fach mit dem Pfeil) macht aus der Unterhaltung etwas Bleibendes:

Als Tests sichern und Als Flow sichern sind verfügbar, sobald die Unterhaltung eine Anfrage gesendet hat.

Apple Intelligence auf diesem MacCopy Anchor Link

Mit macOS 26 und eingeschalteter Apple Intelligence nutzt Echolot außerdem das On-Device-Modell von Apple für kleine Aufgaben, die den Mac nie verlassen und weder Anbieter noch Erlaubnis brauchen:

• Das Apple-Intelligence-Menü im Antwortbereich: Antwort zusammenfassen, Fehler erklären (bei fehlerhaften Antworten), Prüfungen vorschlagen (mit einer Taste, um die Prüfungen hinzuzufügen, die Echolot ausführen kann) und Namen vorschlagen (mit einer Taste, um die Anfrage umzubenennen).
• Fehler erklären bei einem fehlgeschlagenen Flow-Durchlauf und Protokoll zusammenfassen im Protokoll eines laufenden Mocks.
• Kommentare von Echo, wenn du sie einschaltest.

Jede Antwort sagt Auf diesem Mac beantwortet; nichts wurde gesendet. Wo das Modell nicht verfügbar ist, erscheinen diese Tasten nicht. Das Assistent-Panel selbst nutzt immer einen Anbieter aus den Einstellungen › Assistent.

Die Tools eines Servers mit einem Modell ausprobierenCopy Anchor Link

Auf der Seite MCP-Server zeigt die Karte Mit einem Modell ausprobieren, welche der Tools eines Servers ein Modell wählen würde. Tippe in Worum würde jemand einen Agenten mit diesem Server bitten? ein, was jemand einen Agenten tun lassen könnte, und wähle Ausprobieren. Das unter Einstellungen › Assistent gewählte Modell sieht die Tools des Servers und sagt, welches es mit welchen Argumenten aufrufen würde; es wird nichts aufgerufen. Aufrufe, die nicht zum Eingabeschema eines Tools passen, zeigen, was falsch ist, und so zeigen sich unklare Namen und Beschreibungen von Tools.

Der erste Versuch mit einem Anbieter fragt dieselbe einmalige Erlaubnis wie der Assistent. CLI-Agenten werden hier nicht genutzt.

FehlerbehebungCopy Anchor Link

• „Wähle zuerst einen Modellanbieter in ‚Einstellungen › Assistent‘.“ Kein Anbieter ist angehakt. Füge einen hinzu oder hake einen unter Einstellungen › Assistent › Anbieter an.
• „Agenten sind für diesen Arbeitsbereich deaktiviert“: Arbeitsbereichseinstellungen › Agenten › Agenten dürfen diesen Arbeitsbereich nutzen ist aus ([agents] enabled = false in workspace.toml). Schalte es ein, um den Assistenten dort zu nutzen.
• Ein Anbieter zeigt nach Hinzufügen oder Modelle laden einen Fehler. Prüfe den Schlüssel und bei einem OpenAI-kompatiblen Server, dass er unter dieser Adresse läuft. Die Meldung nennt den Anbieter und was schiefging.
• Ein CLI-Agent startet nicht. Prüfe, dass sein Befehl im Terminal läuft und dass Einstellungen › Agenten › Agenten geöffnete Arbeitsbereiche nutzen lassen an ist.