Anweisungen, Freigaben und Konfiguration

Geben Sie dem Assistenten klare Schreibvorlieben und wählen Sie, wie er mit Änderungen umgeht. Anweisungen beschreiben die Arbeit, die Sie wollen; Freigabesteuerungen entscheiden, welche Werkzeugaktionen ausgeführt werden dürfen.

Einstellungen → KI-Assistent → Anweisungen. Stellen Sie das Standardmodell ein, schreiben Sie Ihre Anweisungen und nutzen Sie dann Anweisungen speichern. Das Erfassen von PDF-Seiten liegt unter dem Textfeld. Vollständigen Screenshot öffnen

Standardmodell für Chats

Öffnen Sie Einstellungen → KI-Assistent → Anweisungen. Wählen Sie Standardmodell für Chats, um das Modell festzulegen, das ein neuer Chat nutzt. Die Liste enthält die aktivierten Modelle Ihrer konfigurierten Anbieter. Sie können das Modell in einer einzelnen Unterhaltung weiterhin wechseln.

Eigene Anweisungen

Geben Sie Ihre Vorlieben unter Eigene Anweisungen ein und klicken Sie dann auf Anweisungen speichern. Ein nützlicher Ausgangspunkt für ein Forschungsmanuskript ist:

Beispiel für Schreibanweisungen

Use British English and preserve the terminology already used in the paper.
Keep citation keys, labels, equations, and numerical results unchanged unless
I explicitly ask you to edit them.
When a statement needs evidence, mark it for a source check. Do not invent
references or results.
Explain substantive changes briefly so I can review them.

Formulieren Sie diese Anweisungen spezifisch genug, um eine Überarbeitung zu lenken, ohne Ihren gesamten Projektbrief zu wiederholen. Sie ergänzen das eingebaute Verhalten des Assistenten und ändern seine Werkzeugberechtigungen nicht.

Anweisungen speichern

Klicken Sie nach dem Bearbeiten auf Anweisungen speichern. Die Anzeige Gespeichert bestätigt das dauerhafte Speichern. Eine ungespeicherte Änderung in diesem Feld ist nicht Ihr neuer Standard.

Erfassen von PDF-Seiten für die KI erlauben

Aktivieren Sie Erfassen von PDF-Seiten für die KI erlauben, damit der Assistent gerenderte Seiten mit einem bildfähigen Modell prüfen kann. Das Werkzeug verify_pdf_pages rasterisiert kompilierte Seiten für Layoutprüfungen. Deaktivieren Sie die Steuerung, wenn Seitenbilder nicht an den konfigurierten Anbieter gesendet werden sollen.

Den Werkzeugkatalog ansehen

Klappen Sie im Tab „Anweisungen“ Der Assistent unterstützt derzeit diese Werkzeuge auf. Nutzen Sie ihn, um die Arbeit zu sehen, die der Assistent erledigen kann, und bitten Sie dann um ein Ergebnis wie das Kompilieren eines Abschnitts, das Prüfen des PDF oder das Finden einer nicht aufgelösten Referenz.

Personas

Einstellungen → KI-Assistent → Personas. Persona anlegen liegt über der Liste; Steuerungen zum Bearbeiten und Löschen sitzen neben jeder Persona. Vollständigen Screenshot öffnen

Eine Persona ist eine benannte Anweisungsvoreinstellung. Legen Sie eine unter Einstellungen → KI-Assistent → Personas an und wählen Sie sie dann im Chat-Eingabefeld für eine bestimmte Art von Arbeit. Halten Sie zum Beispiel eine knappe Korrektorat-Persona und eine separate Begutachtungs-Persona.

Eine aktive Persona liefert die Anweisungsvoreinstellung der Unterhaltung anstelle des Standardtexts der eigenen Anweisungen. Nehmen Sie alle dauerhaften Vorlieben auf, die die Persona ebenfalls braucht. Eine Persona ändert die Anleitung; sie gewährt keine Werkzeugberechtigungen.

Einen Freigabemodus wählen

Öffnen Sie das Freigabemenü unter dem Nachrichtenfeld. Der gewählte Modus ist mit einem Häkchen markiert; wählen Sie die Richtlinie, die Sie für Ihr Projekt wollen. Vollständigen Screenshot öffnen

Nutzen Sie die Freigabeauswahl im Chat-Eingabefeld. Die Auswahl wird für das aktuelle Projekt gespeichert.

Modus	Verhalten
Um Freigabe bitten	Als „lesen“ eingestufte Werkzeuge können laufen; andere Aktionen fragen zuerst
Für mich freigeben	Lese- und Netzwerkwerkzeuge können laufen; Dateiänderungen und Shell-Befehle fragen zuerst
Vollzugriff	Werkzeugaktionen können ohne Freigabeanfrage ausgeführt werden, abgesehen von Werkzeugen, die eine deny-Regel sperrt
Eigene Regeln	Gespeicherte allow- und deny-Regeln gelten, und Werkzeuge ohne Regel nutzen die Standard-Risikorichtlinie

Für mich freigeben ist der Standard. Manche Werkzeuge haben innerhalb einer Operation eigene Prüfungen. Das Kompilieren und Prüfen eines PDF wird anders behandelt als das Schreiben einer Quelldatei oder das Ausführen eines Shell-Befehls.

Eine vorgeschlagene Aktion freigeben

Lesen Sie den Werkzeugnamen und die vorgeschlagene Operation auf der Freigabekarte. Geben Sie frei, um diese Aktion auszuführen, oder lehnen Sie sie ab, um die vorgeschlagene Änderung nicht anzuwenden. Fahren Sie die Unterhaltung mit einer enger gefassten Anweisung fort, wenn die angefragte Aktion zu weit gefasst ist.

Immer in diesem Projekt

Nutzen Sie im Modus Eigene Regeln die Option Immer in diesem Projekt auf einer Freigabeanfrage, um eine Regel für dieses Werkzeug zu speichern. Prüfen Sie den gewählten Modus, wenn Sie erwarten, dass eine Regel den nächsten Lauf beeinflusst.

Eine Regel prüfen oder entfernen

Öffnen Sie das Projekt, gehen Sie zu Einstellungen → KI-Assistent → Anbieter und Schlüssel und scrollen Sie zu Werkzeugfreigaben. Jede Zeile zeigt den Werkzeugnamen und ob es immer erlaubt oder verweigert ist. Entfernen Sie eine Regel, um dieses Werkzeug im Modus „Eigene Regeln“ zur Standard-Risikorichtlinie zurückzuführen.

approvals.toml bearbeiten

Datei mit Freigaberegeln, unter Werkzeugfreigaben, bearbeitet ~/.oleafly/approvals.toml. Nutzen Sie Neu laden, um die aktuelle Datei zu lesen, Änderungen verwerfen, um ungespeicherte Bearbeitungen fallen zu lassen, oder Ein Beispiel einfügen, um von einer Beispielkonfiguration zu starten. Wie die Datei funktioniert erklärt das Format und zeigt die Kennung des offenen Projekts. Das Speichern prüft das TOML, bevor es angewendet wird, und die Regeln gelten ab dem nächsten Werkzeugaufruf.

Die Datei enthält eine Modustabelle und Werkzeug-Regeltabellen mit der Projektordner-Kennung als Schlüssel, nicht dem Anzeigenamen:

~/.oleafly/approvals.toml

["$approval_modes"]
"my-project-folder-id" = "custom"

["my-project-folder-id"]
write_file = "allow"
replace_in_file = "allow"
run_command = "deny"
delete_file = "deny"

Ersetzen Sie my-project-folder-id durch die echte Ordnerkennung Ihres Projekts. Projektkennungen sind die Ordnernamen unter ~/.oleafly/projects. Moduswerte sind ask-for-approval, approve-for-me, full-access und custom. Ein nicht aufgeführtes Projekt nutzt „Für mich freigeben“. Werkzeugregelwerte sind allow und deny. Eine deny-Regel gilt in jedem Modus, „Vollzugriff“ eingeschlossen, sodass ein verweigertes Werkzeug nie läuft. Eine allow-Regel gilt nur im Modus „Eigene Regeln“. Ein Werkzeug ohne Regel nutzt die normale Risikorichtlinie.

Kommentare, die mit # beginnen, überstehen ein Speichern aus den Einstellungen, aber das Wählen von Immer in diesem Projekt auf einer Freigabekarte schreibt die Datei ohne sie neu.

Verwenden Sie exakte Werkzeugnamen aus dem Katalog. Häufige Namen sind unter anderem write_file, replace_in_file, create_file, rename_file, delete_file, run_command, compile, insert_figure und set_main_doc.

Welche Konfigurationsdatei soll ich verwenden?

Datei	Zweck
~/.oleafly/config.json	App-Konfiguration, über die Einstellungen verwaltet
~/.oleafly/approvals.toml	Projekt-Freigabemodi und Regeln je Werkzeug
~/.oleafly/agent.toml	Fortgeschrittene Multi-Agent-Limits und -Anweisungen
Die Konfiguration Ihres externen Agenten, etwa ~/.codex/config.toml	Dessen eigene Einstellungen und MCP-Verbindungen

Oleafly verwendet keine einzige config.toml für all diese Einstellungen. Nutzen Sie die Einstellungen-Oberfläche für Anbieter-Schlüssel und App-Vorlieben; Zugangsdaten haben eine getrennte verschlüsselte Ablage. Ersetzen Sie nicht Ihre gesamte App-Konfiguration durch ein kurzes Beispiel.

agent.toml konfigurieren

Fortgeschrittene Nutzer können ~/.oleafly/agent.toml anlegen, um die Multi-Agent-Einstellungen des Assistenten abzustimmen. Diese Einstellungen regeln Oleaflys eigene Agenten-Laufzeit, getrennt von der Konfiguration eines verbundenen CLI-Agenten.

~/.oleafly/agent.toml

maxAgentDepth = 2
maxConcurrentSubagents = 8
minWaitTimeoutMs = 1000
maxWaitTimeoutMs = 300000
defaultWaitTimeoutMs = 120000
waitAgentEnabled = true

usageHintText = """
Delegate independent checks with clear scopes. Keep writing decisions with
the parent agent, and close completed agents when their work is collected.
"""

subagentDeveloperInstructions = """
Work only on the assigned task. Report the files and evidence you inspected.
Do not spawn additional agents.
"""

maxAgentDepth

Begrenzt die Verschachtelungstiefe. Der Standard ist 2: Kinder eines Laufs delegieren nicht weiter. Der kleinste akzeptierte Wert ist 1.

maxConcurrentSubagents

Begrenzt gleichzeitige Unteragenten in einer Sitzung. Der Standard ist 8, das Minimum ist 1. Mehr Agenten können die Modellnutzung erhöhen; erhöhen Sie das Limit für Arbeit, die tatsächlich unabhängig ablaufen kann.

minWaitTimeoutMs

Setzt die untere Grenze für ein Agenten-Warten, in Millisekunden. Der Standard ist 1000.

maxWaitTimeoutMs

Setzt die obere Grenze für ein Agenten-Warten. Der Standard ist 300000, also fünf Minuten. Er bleibt auf oder über dem Minimum.

defaultWaitTimeoutMs

Setzt die Standard-Wartedauer. Der Standard ist 120000, also zwei Minuten. Werte werden auf das konfigurierte Minimum und Maximum begrenzt.

waitAgentEnabled

Steuert die Verfügbarkeit der Funktion zum Warten auf Agenten. Der Standard ist true.

usageHintText

Liefert Delegationshinweise an den übergeordneten Agenten. Das Beispiel oben ersetzt die Standardhinweise durch Ihren eigenen Text.

subagentDeveloperInstructions

Liefert Anweisungen an Unteragenten. Nutzen Sie es, um Umfang, Berichterwartungen und die Frage, ob weitere Delegation angebracht ist, festzulegen.

Die Laufzeit akzeptiert auch snake_case-Versionen dieser Schlüssel, etwa max_agent_depth. Ausgelassene Felder nutzen Standards. Eine fehlende oder fehlerhafte Datei fällt auf Standards zurück; prüfen Sie also die Syntax sorgfältig und starten Sie nach einer Konfigurationsänderung einen neuen Lauf.

Eine Regel mit einer kleinen Aufgabe testen

1. Öffnen Sie ein Übungsprojekt und wählen Sie Um Freigabe bitten.
2. Fragen Sie: „Lies das Hauptdokument und schlage einen klareren Titel vor. Frage nach, bevor du die Datei änderst.“
3. Prüfen Sie die vorgeschlagene Änderung und geben Sie sie frei oder lehnen Sie sie ab.
4. Sehen Sie sich gespeicherte Regeln in den Einstellungen an, bevor Sie zum Modus „Eigene Regeln“ wechseln.
5. Nutzen Sie den Planmodus, wenn Sie mehrere Schritte vereinbaren wollen, bevor Bearbeitungen beginnen.

Externe Assistenten, die sich über Oleafly MCP verbinden, nutzen die Richtlinie des MCP-Servers, die getrennt konfiguriert wird.