Zum Hauptinhalt springen

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:

WerkzeuggruppeTypische Fähigkeit
artifactSitzungsdateien auflisten, prüfen, anheften und exportieren
webÖffentliche Websuche und Abruf
sessionsFrühere Profilsitzungen durchsuchen
memoryProfilerinnerungsoperationen
tasks, automationAufgaben, Erinnerungen und geplante Arbeit
clarifyStrukturierte Fragen bei fehlenden Eingaben
file, terminalDateizugriff und direkte Befehlsausführung
messagingKanalbewusste Nachrichtenoperationen
skillsProfil-Skill-Bibliothek verwalten; Lesen über read/bash
subagentsDelegierung, Hintergrundarbeit und Kindsteuerung
ttsGesprochene 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 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:

BereitstellungSitzungsverhalten
directIm aktiven Zustand aufrufbar; normalerweise direkt deklariert
codemode, deferredAus dem registrierten Inventar ohne direkte Deklaration aufrufbar
model-onlyKann deklariert, aber nicht aus einem Skript aufgerufen werden
hiddenWeder 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.

Werkzeugverfügbarkeit

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​

SymptomPrüfung
Ein konfiguriertes Werkzeug ist nicht sichtbarGeeignete Produktgruppe, Bereitstellung und Sitzungsauswahl prüfen
MCP-Server verbunden, aber Werkzeuge fehlenServeraktivierung/Bereitstellung und Aktivierung von Codemode oder Werkzeugsuche prüfen
Einem Kind fehlt ein WerkzeugDer Werkzeugkatalog der übergeordneten Sitzung oder die Werkzeugrichtlinie der untergeordneten Sitzung erlaubte es nicht
Werkzeugaufruf schlägt fehlErgebnis, Zugangsdaten, Betriebssystemrechte und Backend-Status prüfen