Cortex Code CLI エージェントツール

Cortex Codeは、ファイル操作、シェルコマンド、ウェブアクセスなどのための包括的なツールセットにアクセスできます。追加のものをインストールする必要はありません。これらのツールはCortex Code CLI に組み込まれており、すぐに使用できます。Cortex Codeは、リクエストに基づいて適切なツールを自動的に使用します。手動で呼び出す必要はありません。必要なことを説明するだけです。 例:

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

カスタムスキルを作成するときは、スキルが使用できるツールを指定する必要があります。スキル をご参照ください。

ファイルツール

読む

ローカルファイルシステムからファイルの内容を読み取ります。以下をサポートしています。

  • 行番号付きテキストファイル

  • 画像（ PNG 、 JPG など） - 視覚的に表示

  • PDFs - ページごとの抽出

  • Jupyterノートブック - 出力のあるセル

  • 行範囲: @file.py$10-20

書き込み

ファイルを作成または上書きします。以下をサポートしています。

  • 親ディレクトリを自動的に作成する

  • セッション統計のために行の変更を追跡する

  • 既存のファイルを上書きする

編集

ファイルの検索と置換を行います。以下をサポートしています。

  • 正確な文字列置換

  • 変更前の差異プレビュー

  • グローバル置換のためのreplace_allのサポート

Glob

パターンマッチングによりファイルを検索します。例：

パターン

説明

**/*.py

すべてのPythonファイル

src/**/*.ts

src/ ディレクトリ内の TypeScript ファイル

**/test_*.py

Pythonテストファイル

!node_modules

除外パターン

Grep

正規表現を使用してファイルの内容を検索します。以下をサポートしています。

  • 再帰検索

  • 正規表現パターン

  • バイナリファイル検出

  • 出力モード: コンテンツ、ファイル、カウント

シェルツール

Bash

シェルコマンドを実行します。以下をサポートしています。

  • ストリーミング出力

  • バックグラウンド実行（run_in_background）

  • タイムアウト制御（デフォルトは2分、最大10分）

  • Sandboxランタイムのサポート

BashOutput

バックグラウンドシェルプロセスからの出力を取得します。

  • 正規表現で出力をフィルターする

  • ステータスを確認する

  • run_in_backgroundで使用する

KillShell

実行中のバックグラウンドシェルを終了します。

エージェントツール

RunSubagent

特殊なタスク用にサブエージェントを起動します。型:

  • 汎用:すべてのツール、調査タスク

  • 探索:高速なコードベース探索

  • 計画:アーキテクチャと計画

  • .cortex/agents/からのカスタムエージェント

詳細については サブエージェント をご参照ください。

AskUserQuestion

実行中にユーザーに入力を求めます。以下をサポートしています。

  • 複数選択の質問

  • 自由形式の入力

  • 複数選択オプション

レビュー

品質保証のためのレビューサブエージェントを起動します。

ウェブツール

WebSearch

複数のエンジンを使用してウェブを検索します。以下をサポートしています。

  • 検索エンジンのフォールバック

  • スニペット抽出

  • 結果のキャッシュ

  • 30秒のタイムアウト

注釈

WebSearch では、 Snowsight のCortex Code設定でウェブ検索を有効にする必要があります。ウェブ検索 をご参照ください。

WebFetch

ウェブ URLs からコンテンツを取得します。以下をサポートしています。

  • HTML からテキストへの変換

  • コンテンツ抽出

  • 最大10,000文字

  • 30秒のタイムアウト

Snowflakeツール

SnowflakeSqlExecute

Snowflakeで SQL クエリを実行します。以下をサポートしています。

  • 権限チェック

  • 結果のキャッシュ

  • トークンの更新

  • 大規模な結果のオフロード

SnowflakeObjectSearch

データベースオブジェクトのセマンティック検索。

検索

テーブル、ビュー、スキーマ、データベース、関数

戻り値

名前、列、説明

SnowflakeProductDocs

Snowflakeドキュメントを検索します。サポートされているカテゴリは以下のとおりです。

  • ユーザーガイド

  • SQL リファレンス

  • 開発者ガイド

  • Cortex Codeのトピック

ReflectSemanticModel

Cortex Analystのセマンティックモデルを検証します。検証ステージ:

  • ファイルの存在

  • YAML 構文

  • スキーマの検証

  • サーバー側の検証

SnowflakeMultiCortexAnalyst

Cortex Analystクエリを実行します。以下をサポートしています。

  • 自然言語から SQL

  • セマンティックモデルのサポート

  • 検証済みのクエリの取得

データツール

DataDiff

データベース/テーブル間のデータを比較します。以下をサポートしています。

  • Snowflakeの接続処理

  • アカウント識別子の導出

  • 300秒のタイムアウト

NotebookExecute

Jupyterノートブックを実行します。以下をサポートしています。

  • タイムアウト制御

  • カーネル管理

  • パラメーターインジェクション

  • カスタムPython環境

NotebookEdit

Jupyterノートブックのセルを編集します。対応モード:

  • replace:セルのコンテンツを置換

  • insert:新しいセルを追加

  • delete:セルを削除

プランモードツール

EnterPlanMode

複雑なタスク用のプランモードをリクエストします。以下をサポートしています。

  • ユーザー承認ワークフロー

  • マルチステップタスクの自動呼び出し

ExitPlanMode

ユーザーにプランを提示し、プランモードを終了します。以下をサポートしています。

  • プランの確認

  • ストリーミング制御

メモリツール

メモリ

セッションをまたいで情報を格納し、取得します。サポートされているコマンド:

  • view:保存されたメモリを表示する

  • create:新しいメモリを保存する

  • str_replace:メモリを更新する

  • insert:メモリに追加する

  • delete:メモリを削除する

  • rename:メモリファイルの名前を変更する

注釈

CORTEX_ENABLE_MEMORY 環境変数を設定して、メモリツールを有効にする必要があります。

権限レベル

ツールには異なる権限要件があります。

レベル

ツール

動作

安全

読み取り、Glob、Grep

自動承認される

低

書き込み（新しいファイル）

通常は自動承認される

中

編集、Bash（安全）

確認モードのプロンプト

高

Bash（リスク）、 SQL 書き込み

常にプロンプト

重大

rm -rf、sudo

追加の確認

詳細については、 セキュリティ をご参照ください。