道具の範囲
次の表は、主な道具の例です。全部の道具は、下の「全部の道具の一覧」にあります。表の道具は、Exploratory Desktop のプラグインが AI に使うよう案内するものです。使える道具は、Desktop のバージョンと、システム設定 > MCP / CLI の設定によって変わります。「作成、変更、削除を許可する」がオフのときは、読み取りだけができます。| 目的 | AI にできること | 道具(例) |
|---|---|---|
| データフレームとデータ加工 | データフレームの読み取り、プレビュー、プロファイル。加工ステップの追加と削除、ブランチの操作、R コードの実行と結果のデータフレームへの保存。 | create_wrangling_step, ai_wrangle, preview_data_frame, profile_data_frame, create_branch, execute_r_script, save_result_as_dataframe |
| データソースと接続 | 接続の読み取りと保存、データの取り込み、データソースの作成と置き換え、PDF からの表の抽出。 | get_connections, save_connection, create_data_source, replace_data_source, extract_pdf_tables |
| チャート | チャートの作成、変更、コピー、読み取り(設定、データ、画像)、チャートのデータの書き出し。 | create_chart, update_chart, get_chart, get_chart_data, get_chart_image, copy_chart, export_chart_data |
| アナリティクス | アナリティクス(回帰、検定、クラスタリングなど)とテンプレートの作成、変更、読み取り。 | create_analytics, update_analytics, get_analytics, list_analytics_templates |
| ノート | ノートの作成、変更、読み取り、表示、公開、書き出し。ノートの AI への質問。 | create_note, update_note, get_note, publish_note, export_note_html, ask_note_ai |
| ダッシュボード | ダッシュボードの作成、変更、検証、公開、書き出し。パラメーターの値の設定。 | create_dashboard, update_dashboard, validate_dashboard, publish_dashboard, export_dashboard_pdf |
| パラメーター | パラメーターの作成、名前の変更、読み取り、削除。 | save_parameter, get_parameters, rename_parameter, delete_parameter |
| システム設定 | システム設定、カラーパレット、AI 関数のテンプレート、辞書の読み取りと変更。 | get_system_settings, update_system_settings, save_palette, save_dictionary |
変更や削除を行う道具があります これらの道具には、削除、公開と公開の取り消し、R コードの実行を行うものがあります。Desktop が先に確認する仕組みは、許可の範囲と設定で説明しています。
全部の道具の一覧
全部で 146 個の道具があります。いつでも使える道具が 68 個、システム設定で「作成、変更、削除を許可する」をオンにすると使える道具が 78 個です。使える道具は、Exploratory Desktop のバージョンと、MCP / CLI の設定によって異なります。 いつでも使える道具には、読み取りのほか、画面を開く道具などが含まれます。「作成、変更、削除を許可する」はシステム設定 > MCP / CLI にあります。オフのときは、それ以外の道具は権限の不足で止まります。プロジェクト(16 個)
いつでも使える(12 個)| 名前 | 使える条件 | できること |
|---|---|---|
| ask_project | いつでも | 書き込みの前に、どのプロジェクトを使うかを利用者に確認します。 |
| get_environment | いつでも | 接続している Desktop の情報(アプリのバージョン、Agent API のバージョン、OS、サインイン中のユーザー、開いているプロジェクト)を返します。 |
| get_lineage | いつでも | チャート、アナリティクス、ノート、データフレームが、どのデータソースから作られているかを返します。 |
| get_project | いつでも | プロジェクト 1 つの名前、説明、更新日時、開いているかどうかを読み取ります。 |
| get_project_history | いつでも | プロジェクトの変更履歴を読み取り、検索します。 |
| list_created_artifacts | いつでも | この会話で AI が作成または変更したチャート、アナリティクス、ステップ、ブランチを一覧します。 |
| list_projects | いつでも | このコンピューターのプロジェクトを、新しい順に一覧します。 |
| locate_published_source | いつでも | 公開されたデータの取り込み元をたどります。 |
| open_project | いつでも | ローカルプロジェクトをウィンドウで開きます。すでに開いていればそのウィンドウを前面に出します。 |
| search_artifacts | いつでも | 開いているプロジェクトから、名前、コメント、中身で成果物を検索します。 |
| search_projects | いつでも | 手元のすべてのプロジェクトから、データフレーム、チャート、アナリティクス、ノートなどを検索します。 |
| search_server_projects | いつでも | サインイン中の Exploratory サーバーで公開されているプロジェクトを一覧します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| close_project | 作成、変更、削除を許可したとき | 保存してから、プロジェクトのウィンドウを閉じます。 |
| import_project | 作成、変更、削除を許可したとき | 公開されているプロジェクトをダウンロードし、新しいローカルプロジェクトとして取り込みます。 |
| restore_project_history | 作成、変更、削除を許可したとき | プロジェクト全体を、変更履歴のある時点に戻します。 |
| save_project | 作成、変更、削除を許可したとき | 新しいプロジェクトを作成するか、プロジェクトファイルを取り込みます。 |
データフレーム(10 個)
いつでも使える(6 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_data_frame | いつでも | データフレームのステップ、列名、型、行数を読み取ります。 |
| get_step_diagram | いつでも | データフレームのステップ図(Step Diagram)を返します。 |
| get_summary_view | いつでも | データフレームの Summary の表を返します。 |
| list_data_frames | いつでも | プロジェクトのデータフレームを一覧します。 |
| preview_data_frame | いつでも | データフレームの最後のステップの先頭の行を返します。 |
| profile_data_frame | いつでも | すべての列の型、欠損、要約統計、分布をまとめて確認します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| execute_r_script | 作成、変更、削除を許可したとき | R スクリプトを実行して結果を返します。 |
| manage_data_frame | 作成、変更、削除を許可したとき | データフレームやカタログに対する操作(名前の変更や削除など)を行います。 |
| save_result_as_dataframe | 作成、変更、削除を許可したとき | チャートまたはアナリティクスの出力データを、新しいデータフレームとして保存します。 |
| select_data_frame | 作成、変更、削除を許可したとき | 加工の対象にするデータフレームを選び、列の一覧を返します。 |
データ加工(15 個)
いつでも使える(2 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_wrangling_command | いつでも | 加工コマンドが受け付けるパラメーターを返します。 |
| list_ai_proposals | いつでも | プロジェクトの AI の提案と、確認の状況を一覧します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| ai_wrangle | 作成、変更、削除を許可したとき | 加工の依頼から AI が R スクリプトを書き、必要に応じてステップとして追加します。 |
| apply_wrangling_preview | 作成、変更、削除を許可したとき | プレビューで試した変更を、まとめて適用します。 |
| copy_wrangling_steps | 作成、変更、削除を許可したとき | ステップを、同じまたは別の開いているプロジェクトのデータフレームにコピーします。 |
| create_branch | 作成、変更、削除を許可したとき | ステップから分岐するブランチを作成します。 |
| create_wrangling_step | 作成、変更、削除を許可したとき | データフレームに加工ステップを 1 つ追加します。 |
| delete_branch | 作成、変更、削除を許可したとき | ブランチを削除します。 |
| delete_wrangling_step | 作成、変更、削除を許可したとき | データフレームのステップを削除します。 |
| edit_wrangling_steps | 作成、変更、削除を許可したとき | 既存のステップを、ステップのメニューと同じ方法で編集します。 |
| move_branch | 作成、変更、削除を許可したとき | ブランチの分岐元を、別のステップに変更します。 |
| preview_wrangling_steps | 作成、変更、削除を許可したとき | 変更を一時的なオブジェクトで試し、保存せずに結果を確認します。 |
| set_step_cache | 作成、変更、削除を許可したとき | ステップのデータのキャッシュ、更新、解除のいずれかを行います。 |
| set_step_disabled | 作成、変更、削除を許可したとき | ステップを削除せずに、無効にするか、有効に戻します。 |
| update_ai_proposal | 作成、変更、削除を許可したとき | 公開後に、AI の提案で直した内容が効いたかどうかを記録します。 |
チャート(15 個)
いつでも使える(7 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_chart | いつでも | チャートの定義、データ、パラメーターを読み取ります。 |
| get_chart_data | いつでも | チャートを実行し、集計された実際の値を返します。 |
| get_chart_image | いつでも | チャートの PNG 画像を返します。 |
| get_chart_summary_prompt | いつでも | チャートの AI サマリを書くための、実際の値を含む参考資料を返します。 |
| list_chart_maps | いつでも | 地図のチャートで使える地図を一覧します。 |
| list_chart_settings | いつでも | チャートの種類ごとに使える設定と関数を返します。 |
| list_charts | いつでも | データフレームのチャートを一覧します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| copy_chart | 作成、変更、削除を許可したとき | チャートを複製するか、別のデータフレームに貼り付けます。 |
| create_chart | 作成、変更、削除を許可したとき | データフレームから、編集できるチャートを作成します。 |
| delete_chart | 作成、変更、削除を許可したとき | チャートを削除します。 |
| export_chart_data | 作成、変更、削除を許可したとき | チャートのデータをファイルに書き出します。 |
| install_chart_map | 作成、変更、削除を許可したとき | 地図の拡張を Exploratory のサーバーから入れるか、更新します。 |
| open_chart | 作成、変更、削除を許可したとき | チャートをチャートビューで開きます。 |
| save_chart_ai_summary | 作成、変更、削除を許可したとき | 書いた解釈文を、チャートの AI サマリとして保存します。 |
| update_chart | 作成、変更、削除を許可したとき | チャートの種類、集計、名前などの設定を変更します。 |
アナリティクス(9 個)
いつでも使える(5 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_analytics | いつでも | アナリティクスの結果(種類、設定、出力)を読み取ります。 |
| get_analytics_summary_prompt | いつでも | アナリティクスの AI サマリを書くための、実際の値を含む参考資料を返します。 |
| get_analytics_template | いつでも | アナリティクスの種類ごとに、指定できる項目と設定を返します。 |
| list_analytics | いつでも | データフレームのアナリティクスを一覧します。 |
| list_analytics_templates | いつでも | 作成できるアナリティクスの種類を一覧します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| create_analytics | 作成、変更、削除を許可したとき | アナリティクス(回帰、分類、クラスタリングなど)を作成して実行します。 |
| delete_analytics | 作成、変更、削除を許可したとき | アナリティクスを削除します。 |
| save_analytics_ai_summary | 作成、変更、削除を許可したとき | 書いた解釈文を、アナリティクスのコメントに追記して保存します。 |
| update_analytics | 作成、変更、削除を許可したとき | アナリティクスの列、設定、種類を変更して再実行します。 |
ノート(10 個)
いつでも使える(3 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_note | いつでも | ノート 1 つを、Markdown の本文ごと読み取ります。 |
| get_note_image | いつでも | ノートのプレビュー全体を PNG 画像で返します。 |
| list_notes | いつでも | プロジェクトのノートを、本文なしで一覧します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| ask_note_ai | 作成、変更、削除を許可したとき | ノートエディターの AI に、ノートの文章の書き直し、翻訳、要約を頼みます。 |
| create_note | 作成、変更、削除を許可したとき | チャートやアナリティクスを埋め込める Markdown のノートを作成します。 |
| delete_note | 作成、変更、削除を許可したとき | ノートを削除します。 |
| export_note_html | 作成、変更、削除を許可したとき | ノートを HTML ファイルに書き出します。 |
| export_note_pdf | 作成、変更、削除を許可したとき | ノートを PDF ファイルに書き出します。 |
| open_note | 作成、変更、削除を許可したとき | ノートを画面で開きます。 |
| update_note | 作成、変更、削除を許可したとき | ノートの本文に追記するか置き換えるか、名前を変更します。 |
ダッシュボード(9 個)
いつでも使える(4 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_dashboard | いつでも | ダッシュボード 1 つのページ、Markdown、変数、設定を読み取ります。 |
| get_dashboard_image | いつでも | 保存済みダッシュボードの指定ページを PNG 画像で返します。 |
| list_dashboards | いつでも | プロジェクトのダッシュボードを一覧します。 |
| validate_dashboard | いつでも | 保存せずに、ダッシュボードのレイアウトを検査します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| create_dashboard | 作成、変更、削除を許可したとき | ページ、行、パネルを並べたダッシュボードを作成します。 |
| delete_dashboard | 作成、変更、削除を許可したとき | ダッシュボードを削除します。 |
| export_dashboard_html | 作成、変更、削除を許可したとき | ダッシュボードを HTML ファイルに書き出します。 |
| export_dashboard_pdf | 作成、変更、削除を許可したとき | ダッシュボードの全ページを PDF ファイルに書き出します。 |
| update_dashboard | 作成、変更、削除を許可したとき | ダッシュボードのページ、パネル、名前、設定を変更します。 |
データソースと接続(18 個)
いつでも使える(8 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_connections | いつでも | データ接続の一覧、または接続 1 件の項目を読み取ります。 |
| get_data_source_params | いつでも | データソースのプラグインが受け取る設定項目と、接続が必要かどうかを返します。 |
| identify_data_source | いつでも | 依頼されたデータの取得元を特定し、リファレンスを返します。 |
| lookup_connection | いつでも | 選択した接続を探し、認証情報を除いたメタ情報を返します。 |
| lookup_reference | いつでも | データの取得元の種類に合う、AI Data のリファレンスを返します。 |
| request_connection_creation | いつでも | 接続の作成ダイアログを開きます。 |
| search_schema | いつでも | 接続の保存済みのテーブルと列の情報を確認します。 |
| validate_connection | いつでも | 保存済みの接続に、必須の項目がそろっているかを検証します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| create_data_source | 作成、変更、削除を許可したとき | データフレームとデータソースを保存します。 |
| delete_connection | 作成、変更、削除を許可したとき | データ接続を削除します。 |
| extract_pdf_tables | 作成、変更、削除を許可したとき | PDF の表の中身を、取り込む前に確認します。 |
| list_pdf_tables | 作成、変更、削除を許可したとき | PDF ファイル内の表を下見します。 |
| list_schema_nodes | 作成、変更、削除を許可したとき | 階層型の接続で、指定したパスの下にあるノードを確認します。 |
| read_file_header | 作成、変更、削除を許可したとき | ローカルのテキストファイルの先頭と形式を確認します。 |
| replace_data_source | 作成、変更、削除を許可したとき | 既存のデータフレームの取り込み元を差し替えます。 |
| sample_collections | 作成、変更、削除を許可したとき | 接続の実際のテーブル一覧とサンプルを取得します。 |
| save_connection | 作成、変更、削除を許可したとき | 接続の作成または設定のダイアログを開きます。項目は利用者が入力します。 |
| save_schema_info | 作成、変更、削除を許可したとき | 接続で確認したテーブルと列の情報を保存します。 |
パラメーター(6 個)
いつでも使える(2 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_parameters | いつでも | プロジェクトのパラメーターを読み取ります。 |
| get_session_parameters | いつでも | サインイン情報から自動で定義されるセッションパラメーターの定義を読み取ります。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| delete_parameter | 作成、変更、削除を許可したとき | パラメーターを削除します。 |
| rename_parameter | 作成、変更、削除を許可したとき | パラメーターの名前を変更します。 |
| save_parameter | 作成、変更、削除を許可したとき | パラメーターを作成します。すでにあれば更新します。 |
| set_dashboard_parameter_value | 作成、変更、削除を許可したとき | 表示中のダッシュボードのパラメーターの選択を変えて、表示し直します。 |
公開(7 個)
いつでも使える(2 個)| 名前 | 使える条件 | できること |
|---|---|---|
| list_published | いつでも | プロジェクトから公開しているノート、ダッシュボード、データを一覧します。 |
| list_teams | いつでも | 所属しているチームを一覧します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| publish_dashboard | 作成、変更、削除を許可したとき | ダッシュボードを、公開 URL でサーバーに公開します。 |
| publish_data_frame | 作成、変更、削除を許可したとき | データフレームのステップをサーバーに公開します。 |
| publish_note | 作成、変更、削除を許可したとき | ノートを、公開 URL でサーバーに公開します。 |
| publish_project | 作成、変更、削除を許可したとき | プロジェクトの公開ダイアログを開きます。 |
| unpublish | 作成、変更、削除を許可したとき | ノートまたはダッシュボードの公開を取り消します。 |
設定と共有のリソース(17 個)
いつでも使える(7 個)| 名前 | 使える条件 | できること |
|---|---|---|
| get_ai_function_presets | いつでも | 列メニューにある AI 関数の、プリセットの指示文を返します。 |
| get_ai_function_templates | いつでも | 保存されている AI 関数のテンプレートを読み取ります。 |
| get_dictionaries | いつでも | テキスト分析の辞書を読み取ります。 |
| get_note_prompt_templates | いつでも | 保存されているノート編集用のプロンプトテンプレートを読み取ります。 |
| get_palettes | いつでも | 作成したカラーパレットを読み取ります。 |
| get_r_packages | いつでも | プロジェクトのカスタム R パッケージを一覧します。 |
| get_system_settings | いつでも | システム設定を読み取ります。秘密の値は伏せて返します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| add_r_package | 作成、変更、削除を許可したとき | CRAN またはローカルのファイルから、R パッケージをインストールします。 |
| delete_ai_function_template | 作成、変更、削除を許可したとき | AI 関数のテンプレートを削除します。 |
| delete_note_prompt_template | 作成、変更、削除を許可したとき | ノート編集用のプロンプトテンプレートを削除します。 |
| delete_palette | 作成、変更、削除を許可したとき | カラーパレットを削除します。 |
| delete_r_package | 作成、変更、削除を許可したとき | カスタム R パッケージを削除します。 |
| save_ai_function_template | 作成、変更、削除を許可したとき | 指示文を AI 関数のテンプレートとして保存します。 |
| save_dictionary | 作成、変更、削除を許可したとき | テキスト分析の辞書を作成または更新します。 |
| save_note_prompt_template | 作成、変更、削除を許可したとき | ノート編集用のプロンプトテンプレートを保存します。 |
| save_palette | 作成、変更、削除を許可したとき | カラーパレットを作成または更新します。 |
| update_system_settings | 作成、変更、削除を許可したとき | システム設定のうち、変更が許されている項目を変更します。 |
ローカルのデータカタログ(10 個)
いつでも使える(7 個)| 名前 | 使える条件 | できること |
|---|---|---|
| fetch_catalog_item | いつでも | カタログの項目 1 つの、タイトル、説明、列などを Markdown で読み取ります。 |
| get_catalog_schedule | いつでも | カタログの項目の更新スケジュールを取得します。 |
| get_catalog_schema | いつでも | カタログの項目の列を、説明と要約統計つきで取得します。 |
| preview_catalog_data | いつでも | カタログの項目の行を、ページ送りで取得します。 |
| query_catalog_data | いつでも | カタログの項目を、絞り込み、グループ化、集計、結合します。 |
| read_catalog | いつでも | プロジェクトのデータフレーム、チャート、アナリティクス、ノート、パラメーター、ダッシュボードをまとめて読み取ります。 |
| search_catalog | いつでも | このコンピューターのデータカタログを検索します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| delete_catalog_item | 作成、変更、削除を許可したとき | カタログの項目を、データ、スケジュール、アクセスログごと削除します。 |
| set_catalog_schedule | 作成、変更、削除を許可したとき | カタログの項目の更新スケジュールを設定します。 |
| update_catalog_item | 作成、変更、削除を許可したとき | カタログの項目と列の説明を変更します。 |
そのほか(4 個)
いつでも使える(3 個)| 名前 | 使える条件 | できること |
|---|---|---|
| cancel_execution | いつでも | 時間のかかる操作を止めます。 |
| get_execution | いつでも | 時間のかかる操作の進み具合と結果を返します。 |
| get_guide | いつでも | 道具の使い方のガイドを返します。 |
| 名前 | 使える条件 | できること |
|---|---|---|
| rerun_artifact | 作成、変更、削除を許可したとき | 開いているプロジェクトのチャートやアナリティクスなどを再実行します。 |
