Werkzeuggruppen
Eine Werkzeuggruppe ist eine benannte Gruppe verwandter Werkzeuge. Profil-/Sitzungsgruppenwahl und übergeordnete Zugriffsgrenzen bestimmen das geeignete Inventar. Die Sitzung wählt separat, welche Werkzeuge dem Modell deklariert werden und welche über Codemode aufrufbar sind.
Integrierte Vorgaben
Die standardmäßig sichtbaren integrierten Gruppen sind:
| Werkzeuggruppe | Typische Fähigkeit |
|---|---|
artifact | Sitzungsdateien auflisten, prüfen, anheften und exportieren |
web | Öffentliche Websuche und Abruf |
sessions | Frühere Profilsitzungen durchsuchen |
memory | Profilerinnerungsoperationen |
tasks, automation | Aufgaben, Erinnerungen und geplante Arbeit |
clarify | Strukturierte Fragen bei fehlenden Eingaben |
file, terminal | Dateizugriff und direkte Befehlsausführung |
messaging | Kanalbewusste Nachrichtenoperationen |
skills | Profil-Skill-Bibliothek verwalten; Lesen über read/bash |
subagents | Delegierung, Hintergrundarbeit und Kindsteuerung |
tts | Gesprochene Antworten bei konfiguriertem TTS |
Dies sind geeignete Produktgruppen, kein Versprechen, dass jedes Werkzeug in jeder Sitzung aktiv ist. Die portablen aktiven Standardnamen sind read, bash, edit und write; Produktwerkzeuge können eigene standardaktive Einträge ergänzen. Die installierte Laufzeit kann weitere Gruppen enthalten; Zugangsdaten oder Backend-Verfügbarkeit können sie weiterhin begrenzen.
Den Katalog prüfen
Dashboard → Werkzeuge → Integriert zeigt Quelle, Werkzeuggruppe, native Definition und Laufzeitlimits jedes Werkzeugs. Öffnen Sie eine Zeile für Definition, Zeitlimit und Ausgabebudgets. Dies ist ein Inventar, nicht die aktive Deklarationsliste der aktuellen Sitzung. Definitionen bleiben schreibgeschützt. Codemode hat eine gezielte Einstellungsseite für Profilvorgaben und eine ausdrücklich gewählte Sitzung; dies ist kein allgemeiner Editor für Werkzeugüberschreibungen.
Dashboard bietet keinen allgemeinen Editor zum „Umschalten aller Standardwerkzeuggruppen“. Unterstützte optionale Fähigkeiten aktualisieren ihre Produktgruppen. MCP-Konfiguration ist von diesen Gruppen unabhängig.
Werkzeugauswahl einer Sitzung
Verwenden Sie Gesprächswerkzeugflags, um die Sitzungsauswahl zu ändern:
anyy --tools '+codemode,+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "Inspect the project"
Neue Sitzungen beginnen mit Profilvorgaben und angegebenen Flags. +name und -name ändern diese Vorgaben, nicht die aktuell aktive Werkzeugmenge einer fortgesetzten Sitzung. Das obige --resume-Beispiel kann Codemode in einer vorhandenen Sitzung aktivieren, wenn sie untätig ist und keine ausstehende Eingabe hat; eine neue Sitzung ist nicht nötig. Ohne Überschreibung behält eine aktive Sitzung ihre Auswahl. Verwenden Sie zum ausschließlichen Ändern von Codemode unter Bewahrung anderer aktiver Namen und Regeln dessen Dashboard-Einstellungen, statt die CLI-Auswahl erneut anzuwenden.
Per Flags angegebene Werkzeugauswahlregeln bleiben an der laufenden Sitzung. Sie ändern weder config.yaml des Profils noch überdauern sie einen Gateway-Neustart. Zuvor aufgezeichnete aktive Namen können aus dem gewählten Gesprächszweig unter aktuellen Profilregeln wiederhergestellt werden. Verwenden Sie erneut eine explizite Anbindung im Leerlauf, wenn Sie dieselben Einschluss-, Ausschluss- oder Ohne-Werkzeuge-Regeln benötigen.
Werkzeugauswahl kann weder den Zugriffsumfang der übergeordneten Sitzung noch den Akteur-/Sitzungsbereich oder den Zustellbereich erweitern. Eine zuvor gespeicherte Schema-/Namensliste ist historischer Nachweis und keine zusätzliche Sperre gegen frisch registrierte oder neu definierte Handles mehr.
Codemode und Werkzeugsuche
codemode führt rohes JavaScript mit den aufrufbaren Werkzeugen der aktuellen Sitzung aus. tool_search findet inaktive codemode-/deferred-Werkzeuge und aktiviert Treffer für die nächste Modellanfrage. Beide integrierten Werkzeuge werden inaktiv registriert; explizite Auswahl oder zutreffende MCP-Autoaktivierung kann sie aktivieren. Sie sind unabhängig: Eine Codemode-Änderung ändert weder Werkzeugsuche noch Sitzungsrolle.
Öffnen Sie Dashboard → Werkzeuge → Integriert → codemode, um Profilvorgaben und gemeinsamen Modus on/only zu speichern. Speichern dort veröffentlicht Einstellungen für die nächste Vorbereitung ohne Neustart. Es wählt keine vorhandene Sitzung neu aus; wählen Sie diese separat und verwenden Sie Auf Sitzung anwenden, wenn sie untätig und ohne ausstehende Eingabe ist. Codemode-Einstellungen erklärt Beschränkungen und den Unterschied beider Aktionen.
Sie können config.yaml des Profils auch manuell bearbeiten, etwa:
default_tools:
- "+codemode"
- "+tool_search"
codemode:
mode: on
codemode.mode steuert, wie eine bereits aktive Codemode-Sitzung Werkzeuge darstellt; es ist kein Aktivierungsschalter. on bewahrt direkte Deklarationen. only verbirgt aufrufbare direkte Deklarationen aus der Anfrage, während diese Werkzeuge über Codemode verfügbar und ihre kanonischen Deklarationen aufgezeichnet bleiben. Es gibt kein Codemode-spezifisches CLI-Flag und keine Rolleneinstellung.
Starten Sie nach einer manuellen Dateiänderung Gateway neu oder speichern Sie ausdrücklich über die Codemode-Einstellungsseite, um gespeicherte Werte zu veröffentlichen. Anbieter-Neuladen veröffentlicht keine Werkzeugeinstellungen. Die Seite unterscheidet gespeicherte, noch nicht angewendete Werte. Eine gemeinsame Modusänderung wird bei der nächsten Vorbereitung wirksam; eine Profil-Aktivierungsvorgabe lässt vorhandene Sitzungsauswahl unverändert. Sitzungs-Anwenden ändert nur Codemode unter aktuellen Sitzungsregeln; daher kann eine eingeschränkte vorhandene Sitzung die Aktivierung weiterhin ablehnen, nachdem eine Profilvorgabe aktiviert wurde.
Werkzeugbereitstellung und Produktgruppen sind getrennt:
| Bereitstellung | Sitzungsverhalten |
|---|---|
direct | Im aktiven Zustand aufrufbar; normalerweise direkt deklariert |
codemode, deferred | Aus dem registrierten Inventar ohne direkte Deklaration aufrufbar |
model-only | Kann deklariert, aber nicht aus einem Skript aufgerufen werden |
hidden | Weder deklariert noch aufrufbar |
Aktivierte MCP-Server stellen ihre nativen Werkzeuge mit Server-exposure und geordneten toolExposure-Einstellungen bereit. Sie benötigen weder eine Produktwerkzeuggruppe mcp-NAME noch eine Einschlusslisten-Aktivierungsschranke. Zutreffende MCP-Einstellungen können Codemode automatisch aktivieren; ein expliziter Ausschluss hat weiterhin Vorrang. Ist Codemode deaktiviert, kann eine erlaubte aktive Werkzeugsuche weiterhin indirekte MCP-Werkzeuge entdecken. Siehe MCP-Server.
Die Sandbox lädt bei der ersten Ausführung. Ihr Zeitlimit umfasst Laden und VM-Start. Kompilierter Code kann innerhalb des Anyy-Prozesses wiederverwendet werden, während jede Ausführung eine eigene JavaScript-VM und Globals hat. Ein fehlgeschlagenes Laden kann bei einem späteren Aufruf wiederholt werden; das Abbrechen eines ladenden Aufrufs bricht das Laden eines anderen nicht ab. Für diese Sandbox ist keine installierte Node.js-Laufzeit nötig.
Von einem erfolgreichen Skript gespeicherte Codemode-Werte gehören zum ausgewählten Gesprächszweig und können nach erneutem Öffnen seiner Datenbank gelesen werden. Ein Skript mit Zeitüberschreitung behält Teilausgabe und Fehler, verwirft aber vorbereitete Wertänderungen. Bei gekürzter Ausgabe lässt sich der zurückgegebene Vollausgabepfad später mit read, offset und limit lesen. Bereits abgeschlossene Werkzeugwirkungen werden durch ein fehlgeschlagenes Skript nicht zurückgerollt. APIs, Grenzen und Beispiele finden Sie unter Codemode, Erkennungseingaben unter Werkzeugsuche.
Sitzungen und Skills
Eine Sitzung kann eine explizite Werkzeuggruppenauswahl tragen. In der aktuellen Implementierung kann ein aktiver Skill zusätzliche Gruppen anfordern, wenn die Sitzung noch Profilvorgaben verwendet. Eine explizite Gesprächsschrittauswahl oder bewusst verengte Sitzungsauswahl hat Vorrang. Eine untergeordnete Sitzung kann den erlaubten Zugriffsumfang ihrer übergeordneten Sitzung nicht erweitern.
Enthält ein Gesprächsschritt Anhänge, kann Anyy für diesen Schritt artifact hinzufügen, damit das Modell auf die abgegrenzten Dateien zugreifen kann.
Aktivierte Werkzeuge werden direkt ausgeführt. Zugangsdaten, Betriebssystemrechte, Backend-Zustand und Sitzungsbereich bestimmen, ob eine angeforderte Operation verfügbar ist. Eine Werkzeuggruppe organisiert den Modellkatalog.
Fehlerbehebung
| Symptom | Prüfung |
|---|---|
| Ein konfiguriertes Werkzeug ist nicht sichtbar | Geeignete Produktgruppe, Bereitstellung und Sitzungsauswahl prüfen |
| MCP-Server verbunden, aber Werkzeuge fehlen | Serveraktivierung/Bereitstellung und Aktivierung von Codemode oder Werkzeugsuche prüfen |
| Einem Kind fehlt ein Werkzeug | Der Werkzeugkatalog der übergeordneten Sitzung oder die Werkzeugrichtlinie der untergeordneten Sitzung erlaubte es nicht |
| Werkzeugaufruf schlägt fehl | Ergebnis, Zugangsdaten, Betriebssystemrechte und Backend-Status prüfen |