Cortex Code CLI-Agententools

Cortex Code hat Zugriff auf einen umfassenden Satz von Tools für Dateioperationen, Shell-Befehle, Webzugriff und mehr. Sie brauchen nichts zusätzliches zu installieren. Diese Tools sind in Cortex Code CLI integriert und einsatzbereit. Cortex Code verwendet automatisch die entsprechenden Tools, die Ihren Anfragen entsprechen. Sie müssen diese nicht manuell aufrufen. Beschreiben Sie einfach, was Sie wollen. Beispiel:

Read the first 10 lines of the file src/main.py
Search for TODO comments in all Python files
Execute a bash command to list running processes
Copy

Beim Erstellen von kundenspezifischen Fähigkeiten müssen Sie die Tools festlegen, die von der Fähigkeit verwendet werden können. Siehe Skills.

Dateitools

Lesen

Liest Dateiinhalte aus dem lokalen Dateisystem. Unterstützt:

  • Textdateien mit Zeilennummern

  • Bilder (PNG, JPG usw.) – visuell angezeigt

  • PDFs – Extraktion Seite für Seite

  • Jupyter-Notebooks – Zellen mit Ausgaben

  • Zeilenbereiche: @file.py$10-20

Schreiben

Erstellen oder Überschreiben von Dateien. Unterstützt:

  • Automatische Erstellung von übergeordneten Verzeichnissen

  • Verfolgt Zeilenänderungen für Sitzungsstatistiken

  • Überschreibt die vorhandenen Dateien

Bearbeiten

Suchen und Ersetzen in Dateien. Unterstützt:

  • Genaue Ersetzung der Zeichenfolge

  • Vergleich der Vorschau vor den Änderungen

  • Unterstützt „replace_all“ für eine globale Ersetzung

Glob

Suchen von Dateien durch Mustererkennung. Beispiele:

Muster

Beschreibung

**/*.py

Alle Python-Dateien

src/**/*.ts

TypeScript-Dateien im src/-Verzeichnis

**/test_*.py

Python-Testdateien

!node_modules

Muster ausschließen

Grep

Suchen von Dateiinhalten mit einem regulären Ausdruck. Unterstützt:

  • Rekursive Suche

  • Regex-Muster

  • Erkennung von Binärdateien

  • Ausgabemodi: Inhalt, Dateien, Anzahl

Shell-Tools

Bash

Ausführen von Shell-Befehlen. Unterstützt:

  • Streaming-Ausgabe

  • Ausführung im Hintergrund (run_in_background)

  • Timeout-Kontrolle (Standard: 2 Minuten, max. 10 Minuten)

  • Unterstützung der Sandbox-Laufzeitumgebung

BashOutput

Abrufen der Ausgabe aus einem Shell-Prozess im Hintergrund.

  • Filtert die Ausgabe nach Regex

  • Statusüberprüfung

  • Verwenden mit „run_in_background“.

KillShell

Beenden von aktiven Hintergrund-Shells.

Agententools

RunSubagent

Starten von Subagenten für spezielle Aufgaben. Typen:

  • general-purpose: Alle Tools, Forschungsaufgaben

  • Erkunden: Schnelle Erkundung der Codebasis

  • Plan: Architektur und Planung

  • Kundenspezifische Agenten von .cortex/agents/

Weitere Informationen dazu finden Sie unter Subagenten.

AskUserQuestion

Auffordern von Benutzenden zur Eingabe während der Ausführung. Unterstützt:

  • Mehrere Auswahlfragen

  • Freiform-Eingabe

  • Optionen zur Mehrfachauswahl

Überprüfen

Starten eines Überprüfungssubagenten zur Qualitätssicherung.

Web-Tools

WebSearch

Durchsuchen des Webs mit mehreren Engines. Unterstützt:

  • Fallback-Suchmaschinen

  • Extraktion von Ausschnitten

  • Ergebnis-Caching

  • Timeout von 30 Sekunden

Bemerkung

WebSearch erfordert die Aktivierung der Websuche in den Cortex Code-Einstellungen in Snowsight. Siehe Websuche.

WebFetch

Ruft Inhalte aus den Web-URLs ab. Unterstützt:

  • Konvertierung von HTML in Text

  • Extraktion von Inhalten

  • Maximal 10.000 Zeichen

  • Timeout von 30 Sekunden

Snowflake-Tools

SnowflakeSqlExecute

Ausführen von SQL-Abfragen in Snowflake. Unterstützt:

  • Berechtigungsprüfungen

  • Ergebnis-Caching

  • Token-Aktualisierung

  • Auslagern großer Ergebnisse

SnowflakeObjectSearch

Semantische Suche nach Datenbankobjekten.

Suchen von

Tabellen, Ansichten, Schemata, Datenbanken, Funktionen

Rückgabewerte

Namen, Spalten, Beschreibungen

SnowflakeProductDocs

Durchsuchen der Snowflake-Dokumentation. Unterstützte Kategorien:

  • Benutzerhandbuch

  • SQL-Referenz

  • Entwicklerhandbuch

  • Cortex Code-Themen

ReflectSemanticModel

Validieren von semantischen Cortex Analyst-Modellen. Validierungsstufen:

  • Vorhandensein der Datei

  • YAML-Syntax

  • Schemavalidierung

  • Serverseitige Validierung

SnowflakeMultiCortexAnalyst

Ausführen von Cortex Analyst-Abfragen. Unterstützt:

  • Natürliche Sprache in SQL

  • Unterstützung von semantischen Modellen

  • Geprüfter Abfrageabruf

Datentools

DataDiff

Vergleichen von Daten zwischen Datenbanken/Tabellen. Unterstützt:

  • Verarbeitung von Verbindungen mit Snowflake

  • Ableitung des Kontobezeichners

  • Timeout von 300 Sekunden

NotebookExecute

Ausführen von Jupyter-Notebooks. Unterstützt:

  • Timeout-Kontrolle

  • Kernel-Verwaltung

  • Parametereinschleusung

  • Kundenspezifische Python-Umgebungen

NotebookEdit

Bearbeiten der Zellen des Jupyter-Notebooks. Unterstützte Modi:

  • replace: Ersetzt den Inhalt der Zelle

  • insert: Fügt eine neue Zelle hinzu

  • delete: Entfernt eine Zelle

Planmodus-Tools

EnterPlanMode

Anfordern des Planmodus für komplexe Aufgaben Unterstützt:

  • Genehmigungs-Workflow für Benutzende

  • Automatischer Aufruf von mehrstufigen Aufgaben

ExitPlanMode

Präsentieren des Plans dem Benutzenden und Verlassen des Planmodus. Unterstützt:

  • Bestätigung des Plans

  • Streaming-Kontrolle

Speichertools

Speicher

Speichern und Abrufen von Informationen über Sitzungen hinweg. Unterstützte Befehle:

  • view: Siehe gespeicherte Speicher

  • create: Speichern von neuem Speicher

  • str_replace: Speicher aktualisieren

  • insert: Zum Speicher hinzufügen

  • delete: Speicher entfernen

  • rename: Speicherdatei umbenennen

Bemerkung

Das Speichertool muss durch Einstellen der CORTEX_ENABLE_MEMORY-Umgebungsvariable aktiviert werden.

Berechtigungsstufen

Tools haben unterschiedliche Anforderungen an die Berechtigung:

Level

Tools

Verhalten

Sicher

Lesen, Glob, Grep

Automatisch genehmigt

Niedrig

Schreiben (neue Dateien)

In der Regel automatisch genehmigt

Medium

Bearbeiten, Bash (sicher)

Eingabeaufforderungen im Bestätigungsmodus

Hoch

Bash (risikoreich), Schreiben in SQL

Fordert immer an

Kritisch

rm -rf, sudo

Zusätzliche Bestätigung

Siehe Sicherheit für Details.