Mit dem Agenten arbeiten

Der Agent – in einer neuen Clapilot-Instanz heißt er Angela, Ihre Administration kann den Namen ändern – ist kein Suchfeld, sondern ein Kollege mit Zugriff auf Ihren Arbeitsbereich. Er liest E-Mails, legt Aufgaben und Termine an, sucht Dokumente, bereitet Antworten vor und bedient installierte Module. Sie erreichen ihn an drei Stellen:

• im Chat (Menü → Chat, oder zweimal auf eine Unterhaltung links klicken) für längere Unterhaltungen,
• im Chat-Dock rechts neben jeder Seite für Fragen zur aktuellen Seite,
• im Team-Chat, wenn Sie ihn mit @ erwähnen (siehe Team-Chat).

Der Chat

1234567

1. Ihre Nachricht – was Sie gefragt oder beauftragt haben.
2. Antwort des Agenten – hier ein Tagesüberblick mit Terminen und dringenden Aufgaben, den der Agent aus Kalender, Aufgaben und Posteingang zusammengestellt hat.
3. Erledigte Aktion – der Agent sagt, was er geändert hat, und nennt das Objekt. Nach dieser Anweisung hat er eine Aufgabe angelegt, die sofort im Aufgaben-Board steht.
4. Sitzung – zeigt rechts, welche Module und Tools der Agent in dieser Unterhaltung genutzt hat; ein Klick auf einen Eintrag zeigt die einzelnen Aufrufe. Das Kreuz blendet die Übersicht aus.
5. Eingabefeld – schreiben Sie hier. Enter sendet, Shift + Enter fügt eine neue Zeile ein. Das Plus öffnet ein Menü: Lokale Dateien von Ihrem Gerät, Clapilot-Dokumente aus den Dokumenten und Zeichnung. Die Zeichnung öffnet das Whiteboard an Stelle des Verlaufs – mit Stift (auch Apple Pencil), Formen, Text und Haftnotizen; Fertig hängt sie als Bild an Ihre Nachricht. In den Apple-Apps kommen Fotos aus Ihrer Mediathek dazu. Dateien können Sie auch einfach auf das Feld ziehen. Das gilt ebenso im Coding-Modus.
6. Modell – zeigt, welches KI-Modell antwortet. Standard nutzt das Modell, das Ihre Administration vorgesehen hat; darunter stehen die Modelle, die Sie selbst wählen können, mit ihrem Namen und einer kurzen Beschreibung. Ihre Wahl gilt für diese Session. Nimmt die Administration ein Modell aus der Auswahl, antwortet der Chat mit dem Standardmodell und zeigt einen Hinweis. Ist ein Modell nur gerade nicht verfügbar, antwortet der Chat mit dem Standardmodell, sagt das dazu und behält Ihre Wahl für die nächste Nachricht. Sehen Sie nur Standard, hat Ihre Administration noch keine weiteren Modelle freigegeben.
7. Neuer Chat – startet eine frische Unterhaltung. Auf breiten Bildschirmen steht er oben in der Liste Unterhaltungen, zusätzlich als Stift-Symbol oben links neben der Suche; in der Mac-App unten links in der Liste. Die Liste links neben dem Chat zeigt Ihre Sessions mit Zeitpunkt und Modell. Das Seitenleisten-Symbol klappt die Liste zu einer schmalen Leiste ein. Im Coding-Modus zeigt dieselbe Liste Ihre Coding-Sessions mit Repository, Ausführungsort, der Zahl der Tool-Aufrufe und einem Symbol für Codex, Claude oder Clapilot Code; derselbe Knopf startet dann eine neue Coding-Session; das Symbol oben rechts öffnet daneben die Sitzungsübersicht mit Status, Branch und den geänderten Dateien. Auf dem Smartphone öffnet der Pfeil oben die Liste. Die drei Punkte bieten weitere Optionen.

Während der Agent arbeitet, sehen Sie seinen Fortschritt. Wenn Sie jeden einzelnen Arbeitsschritt sehen möchten, aktivieren Sie unter Einstellungen → Profil die Option Agent-Tool-Calls im Chat anzeigen. Schreiben Sie ruhig weiter, während er arbeitet: neue Nachrichten stellt Clapilot in eine Warteschlange, und mit Direkt senden schieben Sie eine Nachricht sofort hinterher.

Den Simulator live ansehen

Startet der Agent für Sie einen iOS-Simulator auf einem verbundenen Computer, sehen Sie ihn live. Im Chat erscheint er in der Seitenleiste rechts; ist dort auch die Sitzungsübersicht offen, wechseln Sie oben zwischen Simulator und Sitzung. Ein Klick ins Bild tippt auf dem Simulator, das Textfeld schreibt in das gerade aktive Feld, daneben liegen Zurück und Home. Mit dem Symbol für ein eigenes Fenster lösen Sie den Simulator aus der Seitenleiste; das schwebende Fenster verschieben Sie an seiner Kopfzeile und ziehen es an der rechten unteren Ecke größer oder kleiner. Das Seitenleisten-Symbol im Fenster dockt ihn wieder an. In anderen Modulen und im Chat-Dock erscheint der Simulator immer als schwebendes Fenster. Die Seitenleiste des Chats ziehen Sie an ihrem linken Rand breiter oder schmaler; Clapilot merkt sich die Breite in diesem Browser. In der Mac-App steht der Simulator ebenso in der Seitenleiste des Chats und lässt sich in ein eigenes Fenster lösen. Das Ausblenden beendet die Simulator-Sitzung nicht.

Sessions: getrennte Unterhaltungen

Für jedes Thema können Sie eine eigene Session führen – etwa eine für den Jahresabschluss eines Kunden und eine für den Newsletter. So bleibt der Kontext sauber, und der Agent verwechselt nichts.

12345

1. Sessionauswahl – öffnet die Liste im Chat-Dock oder im Chat.
2. Neuer Chat – legt eine neue Session an.
3. Hauptchat – Ihre Standard-Unterhaltung. Sie ist immer angepinnt; Automationen und der Heartbeat melden sich standardmäßig hier.
4. Angepinnte Sessions – Sessions, die Sie oben halten möchten. Die Nadel rechts pinnt oder löst sie.
5. Zuletzt – Ihre übrigen Sessions, die neueste zuerst. Umbenennen und Löschen erreichen Sie über das Menü der jeweiligen Session.

Chat mit einem Spezial-Agenten

Neuer Chat → Spezial-Agent öffnet die Liste Ihrer Spezial-Agenten. Wählen Sie einen aus, startet eine neue Unterhaltung, die fest zu diesem Agenten gehört: Jede Nachricht geht direkt an ihn, ohne dass Sie ihn mit @ erwähnen müssen. Statt der Modellauswahl zeigt das Eingabefeld Bild und Namen des Agenten, und in der Liste Unterhaltungen steht sein Name an Stelle des Modells. Erwähnen Sie in dieser Unterhaltung einen anderen Agenten mit @, antwortet für diese Nachricht der erwähnte. Den Eintrag gibt es im Web, in der iPhone-, iPad- und Mac-App, sobald mindestens ein Spezial-Agent eingeschaltet ist.

Fork, Archiv und Löschen

Ein Rechtsklick auf eine Session in der Liste Unterhaltungen (in den Apps: lange drücken bzw. Rechtsklick auf dem Mac) öffnet ihr Menü:

• Fork erstellen – startet eine neue Session, die den bisherigen Verlauf und den Kontext des Agenten mitnimmt. So probieren Sie eine andere Richtung aus, ohne die ursprüngliche Unterhaltung zu verändern. Der Fork steht eingerückt unter der Session, aus der er entstanden ist, und geht danach eigene Wege.
• Archivieren – nimmt die Session aus der Liste, ohne sie zu löschen. Archivierte Sessions finden Sie im eingeklappten Bereich Archiv am Ende der Liste; Wiederherstellen holt sie zurück.
• Löschen – entfernt die Session mit ihrem Verlauf endgültig (zum Bestätigen ein zweites Mal wählen). Forks einer gelöschten Session bleiben erhalten.

Den Hauptchat können Sie forken, aber weder archivieren noch löschen.

Ihre Chats mit dem Agenten sind persönlich. Andere Teammitglieder sehen sie nicht.

Schreiben Sie dem Agenten auch über WhatsApp, Telegram oder einen anderen Messenger, landen diese Direktnachrichten in einer Ihrer Sessions – standardmäßig im Hauptchat. Die Session trägt dann das Symbol des Messengers, und jede Nachricht von dort ist mit demselben Symbol markiert. Sie sehen den Verlauf also auch im Web und in der App und können dort im selben Kontext weiterschreiben. Welche Session verwendet wird, legt Ihre Administration fest (siehe Administration).

Projekte: Chats zu einem Thema bündeln

Arbeiten Sie an mehreren Themen parallel – etwa Marketing, Steuer und einem App-Release –, legen Sie für jedes Thema ein Projekt an. Ein Projekt hat ein Ziel, zuständige Agenten und einen Verlauf Zuletzt passiert. Jeder Chat im Projekt kennt diesen Kontext, Sie müssen ihn also nicht in jedem Chat neu erklären.

• Projekt anlegen – das + neben Projekte in der Liste Unterhaltungen öffnet Neues Projekt: Name, Art (Intern oder Kunde), Rhythmus (einmalig, fortlaufend, wiederkehrend), Ziel und Agenten. Bei Kunde wählen Sie einen Kontakt aus Kontakte oder tippen einen neuen Namen ein – der Kontakt wird dann beim Anlegen erstellt. Ist der Entwicklermodus der Instanz eingeschaltet, wählen Sie im Bereich Entwicklung ein bestehendes Aufgabenboard oder legen ein neues an und verknüpfen ein Repository (aus der Liste oder als owner/name). Alle Auswahlfelder lassen sich durchsuchen; wählen Sie ein Board oder Repository, übernimmt das Projekt dessen Namen, solange Sie selbst keinen eingetragen haben.
• Chats im Projekt – unter jedem Projekt stehen Ihre Chats dazu, darunter Neuer Chat im Projekt. Bestehende Chats verschieben Sie per Rechtsklick → In Projekt verschieben; Rückgängig im Hinweis macht das sofort rückgängig. Das Eingabefeld zeigt Projekt: …; ein Klick darauf zeigt, was der Chat über das Projekt weiß.
• Projektübersicht – ein Klick auf den Projektnamen öffnet Ziel, Verlauf, Agenten, Aufgabenboard und Repository sowie Ihre Chats im Projekt. Über ⋯ bearbeiten, schließen (Abgeschlossen am Ende der Liste) oder löschen Sie das Projekt. Beim Löschen bleiben die Chats erhalten.
• Wiki und Feed – jedes Projekt bekommt beim Anlegen eine eigene Projektseite im Wiki. Wiki-Seiten und Feed-Beiträge lassen sich einem Projekt zuordnen; im Wiki und im Feed filtern Sie oben nach Projekt. Neue Seiten und Beiträge landen automatisch im gefilterten Projekt. In der Projektübersicht führt Wiki & Feed direkt dorthin.
• Ziel und Verlauf – die Agenten tragen Ergebnisse in Zuletzt passiert ein; Einträge entfernen Sie jederzeit. Das Ziel ändert ein Agent nie selbst: Er macht einen Vorschlag, den Sie übernehmen oder verwerfen.

Projekte sieht der ganze Workspace, außer Sie schalten Nur für mich ein. Ihre Chats bleiben persönlich: Im Projekt sieht jede Person nur ihre eigenen. Verknüpft eine Administratorin oder ein Administrator Repository und Aufgabenboard, gilt die Verknüpfung auch im Agent Orchestrator. Sie können den Agenten auch direkt bitten, etwa: „Leg ein Projekt für f1rede/clapilot an und verschieb diesen Chat hinein.“

Das Chat-Dock

Das Dock rechts kennt die aktuelle Seite. Im Aufgaben-Board weiß der Agent, dass Sie im Aufgaben-Modul sind; in einer geöffneten E-Mail kennt er genau diese E-Mail.

123456

1. Kontext – zeigt, worauf sich Ihre Frage bezieht.
2. Passende Vorschläge – wechseln mit der Seite, zum Beispiel Offene Aufgaben zusammenfassen in den Aufgaben oder Antwort verbessern in einer E-Mail.
3. Eingabefeld – wie im Chat.
4. Anhängen – dasselbe Menü wie im Chat: lokale Dateien, Clapilot-Dokumente oder eine Zeichnung, dazu im Dock Aktuelle Ansicht (App-Shot).
5. Konversation starten – startet ein Live-Gespräch per Sprache. Diese Funktion steht zur Verfügung, wenn Ihre Administration einen Sprachanbieter eingerichtet hat.
6. Diktieren – spricht Ihre Nachricht ein; sie erscheint als Text im Eingabefeld.

App-Shot – der Eintrag Aktuelle Ansicht im Plus-Menü nimmt die aktuelle Ansicht links neben dem Dock auf (ohne Menü und Chat) und hängt sie als Bild an Ihre Nachricht. So sieht der Agent genau, was Sie gerade sehen, etwa ein Layoutproblem im Canvas. Der Browser fragt dabei jedes Mal, ob er diesen Tab teilen darf; Chrome und Edge wählen den Tab schon vor. Die Funktion gibt es nur im Chat-Dock (auch in der Mac- und iPad-App), nicht im Vollbild-Chat oder im Team-Chat.

Erwähnungen, Befehle und Referenzen

Im Eingabefeld öffnen vier Zeichen eine Auswahlliste:

12

1. Erwähnungen – nach @ listet Clapilot den Hauptagenten und alle Spezial-Agenten. Pfeiltasten und Enter wählen aus.
2. Eingabefeld – die Auswahl wird an der Cursorposition eingefügt.

Mit einer Erwähnung übergeben Sie eine Aufgabe gezielt an einen Spezial-Agenten, zum Beispiel einen Agenten, der nur für Social-Media-Beiträge zuständig ist.

Rückfragen als Formular

Braucht der Agent mehrere Angaben auf einmal – etwa Aktenzeichen, Fristdatum und Art der Frist –, zeigt er statt einzelner Rückfragen ein kleines Formular in seiner Antwort. Pflichtfelder sind mit * markiert; Datumsfelder, Auswahllisten und Ja/Nein-Schalter funktionieren wie überall in Clapilot. Mit Absenden geht Ihre Eingabe als normale Nachricht an den Agenten, und das Formular wird gesperrt – auch nach dem Neuladen, auf Ihren anderen Geräten und im Team-Chat für alle Mitglieder. Dasselbe gilt für Auswahl-Buttons: Die gewählte Antwort bleibt markiert. Das Absenden löst selbst noch keine Aktion aus: Was der Agent danach nach außen tut, braucht weiterhin Ihre Freigabe. In Telegram oder WhatsApp erscheint das Formular als Liste der Felder, die Sie in einer Antwort ausfüllen.

Freigaben: bevor der Agent handelt

Aktionen, die nach außen wirken oder etwas unwiderruflich ändern, führt der Agent nicht ohne Sie aus. Bevor er eine E-Mail, ein Fax oder einen Brief verschickt, Daten löscht, etwas veröffentlicht oder eine Bestellung aufgibt, erscheint eine Freigabe-Karte. Dasselbe gilt, wenn der Agent eine dauerhafte Einstellung ändert, die für alle in einem gemeinsamen Bereich gilt – etwa den Channel-Prompt eines Team-Chat-Channels setzt oder entfernt. Die Karte zeigt dann Channel, Agent, die Änderung und eine Vorschau des neuen sowie den bisherigen Prompt. Auch bevor der Agent einen Browser oder iOS-Simulator auf einem verbundenen Computer startet, der nicht Ihnen gehört, fragt er nach; die Karte nennt den Computer und wem er gehört.

1234

1. Freigabe erforderlich – nennt die Aktion, hier E-Mail senden.
2. Details – Empfänger, Betreff und eine Vorschau des Inhalts. Prüfen Sie diese Angaben wie bei einer eigenen E-Mail.
3. Freigeben – der Agent führt die Aktion sofort aus, und die Karte zeigt das Ergebnis.
4. Ablehnen – nichts wird ausgeführt; der Agent erfährt, dass Sie abgelehnt haben.

Offene Freigaben bleiben 72 Stunden gültig. Sie erscheinen auch dann, wenn der Agent im Hintergrund gearbeitet hat – etwa in einer Automation –, und auf dem Smartphone als Mitteilung. In Kanälen wie Telegram oder WhatsApp antworten Sie einfach mit der Nummer der Freigabe. Für wiederkehrende Automationen kann eine Aktion vorab freigegeben werden (siehe Automationen).

Gute Aufträge schreiben

Der Agent arbeitet am besten, wenn er Ziel, Kontext und gewünschtes Ergebnis kennt.

Weitere Tipps:

• Nennen Sie Namen, wenn Sie sie kennen: Kontakte, Dokumente, Boards. Mit # fügen Sie eine eindeutige Referenz ein.
• Korrigieren statt neu anfangen: Schreiben Sie „kürzer“, „förmlicher“ oder „ohne den zweiten Absatz“ – der Agent überarbeitet sein letztes Ergebnis.
• Nach dem Ergebnis fragen: „Was hast du geändert?“ liefert eine Liste der angelegten oder bearbeiteten Objekte.
• Fachliche Verantwortung bleibt bei Ihnen. Prüfen Sie rechtliche, steuerliche und nach außen gehende Inhalte, bevor Sie sie freigeben.

Was der Agent sich merkt

Der Agent lernt aus Ihren Unterhaltungen stabile Fakten, etwa bevorzugte Formulierungen oder wer für welchen Kunden zuständig ist. Unter Einstellungen → Profil bestimmen Sie mit Meine Erinnerungen mit dem Team teilen, ob neue Erkenntnisse aus Ihren Unterhaltungen dem ganzen Team zur Verfügung stehen. Private Erinnerungen bleiben privat.

Soll der Agent sich regelmäßig von selbst melden – etwa mit Hinweisen auf überfällige Fristen –, richten Sie den Heartbeat ein.