スクリプト(ベータ版)
最終更新: 2026-11-17
スクリプトは小さなプログラムで、数える、並べ替える、比べる、合計するといった、モデルは苦手でもプログラムなら毎回同じようにこなせる作業に向いています。JavaScriptで書きます。Plainvaの中の閉じた環境で動き、ファイルを開くことも、ネットワークに接続することも、時間を置いて待つこともできません。呼び出せるのは、チェックを入れたツールだけです。それらのツールは、AIが使うツールと同じ方法で保管庫を読むか、提案を残します。提案を適用するかどうかは、あなたが決めます。ここから開始したスクリプトが自分で何かを変更することはありません。会話の中でAIが開始したスクリプトは、あなたが許可した場合は直接書き込めます(下の「会話の中で」を参照)。
スクリプトを実行する
スクリプトは、AIタブのスキル(スマートフォンではAI画面のスキル区分)にあるスクリプトグループに表示されます。実行を選ぶとスクリプトが開くので、求められた内容を入力して実行を押します。実行中は、呼び出されたツールが1つずつ表示され、停止で終了できます。終わると、ダイアログに呼び出し、結果(コピーできます)、ログに加えて、実行が上限のうちどれだけを使ったかが表示されます。
ここから開始した実行はこのデバイスの中だけで行われ、その内容がモデルに送られることはありません。そのため、クラウドに出さないノートも読めます。試し実行では、読み取るツールは呼び出されますが、アプリで何かを表示したり提案を残したりすることになる呼び出しは、記録されるだけです。
会話の中で
通常の会話では、AIは有効なスクリプトを見つけ、質問に合うときに実行できます。そのとき会話にはスクリプト「word-count」を実行していますと表示されます。スクリプトが読めるのは、その会話が読んでよいものだけです。クラウドに出さないノートは出さないままで、スクリプトが読んだノートはすべて、その実行が読んだものとして数えられます。スクリプトが返すものは、データとしてモデルに渡され、指示として扱われることはありません。ルーティン、スキルのテスト実行、画像を説明するとノートにするの入口では、スクリプトは実行されません。スキルで始めた会話にはスクリプトが提供されず、MCPサーバー経由で接続したAIアプリにも提供されません。
変更を提案する
スクリプトには、提案を行うツールを渡すこともできます。ノートへの変更を提案とプロパティ値を提案というツールは、ノートの余白に提案を置きます。ノートの下書きを作成、データベースの項目の下書きを作成、タスクの下書きを作成、ジャーナルエントリの下書きを作成というツールは、下書きを置きます。提案にも下書きにもスクリプトの名前が付きます。ここから実行で開始したスクリプトは、何も直接書き込みません。提案を適用するか下書きを作成するまで保管庫は何も変わりません——AIの提案とまったく同じです。実行が終わると、ダイアログの提案と下書きの欄にそれらが一覧されます。試し実行で始めた実行は、何も残しません。
スクリプトが何を読んだかによって、提案や下書きを置ける場所が決まります。クラウドに出さないノートに基づく提案や下書きを受け付けるのは、同じルールが適用される場所だけです。会話では、その会話自身が提案できる場合にだけ、提案を行うスクリプトがAIに提供され、スクリプトがそこに残したものにはその会話のモデルの名前が付きます。会話が変更を直接反映する場合(直接反映チップがオンのとき、または確認なしで変更を許可しているフォルダー内の対象のとき)は、そのようなスクリプトが書き込むものも直接反映されます。書き込まれるのは、ノートとそのプロパティの変更、新しいノート、データベースの項目、タスク、ジャーナルの項目で、アシスタント自身の直接の変更と同じ安全策が付きます(AIアシスタントの「直接反映」を参照)。こうして1回の実行で多くのノートが変わることがあります。AI は回答の各ステップでスクリプトを起動でき、起動ごとにスクリプトの上限まで呼び出しができます。どの変更も直前の版を残し、回答にはそのすべてがすべて元に戻すとともに表示されます。この許可がなければ、スクリプトは上で述べたとおり、提案と下書きを残します。
スクリプトを書く
新しいスクリプトでは、次の項目を入力します:
- 名前——使えるのは小文字、数字、ハイフンです。この名前がフォルダー名になります。
- 説明——何のためのスクリプトかを書きます。あなたもAIも、これで見分けます。
- ツール——スクリプトが呼び出してよいツールにチェックを入れます。読み取りの下には読み取るもの、提案の下には提案や下書きを残すものが並びます。スクリプトから見えるのは、チェックしたものだけです。
- 入力——スクリプトが開始時に求めるもの。名前と、テキスト・数値・はい/いいえのどれか、そして必須かどうかを決めます。
- 上限——計算時間(秒)、ツールの呼び出し回数、メモリ。
- コード——プログラム本体。
作成して承認を選ぶと、スクリプトが.agent/scripts/<name>/(manifest.jsonとmain.js)として保管庫に書き込まれ、このデバイスで承認されます。スクリプトのメニューの編集で同じフォームが開き、保存して承認でファイルが置き換えられます。
コードは関数の本体です。inputには入力が名前ごとに入り、tools.<name>(…)はツールを呼び出してその結果を待ち、returnは結果を返し、console.log(…)はログに1行書き込みます。たとえば次のようになります:
const found = await tools.search_vault({ query: "#" + input.tag, limit: 25 });
const notes = [];
for (const hit of found.results) {
const note = await tools.read_note({ path: hit.path });
if (note.text.includes("#" + input.tag)) notes.push(hit.path);
}
return { tag: input.tag, count: notes.length, notes };
言語は現行のJavaScript(ES2024と、ES2025の大部分)で、Intlはありません。fetchもタイマーもimportもなく、ファイルにアクセスすることもできません。スクリプトが返すものは、JSONとして書き出せるデータでなければなりません。ツールが拒否した場合(存在しないノート、その会話が読んではいけないノートなど)は、スクリプトで受け止められるエラーが発生します。
ツールが返す内容
フォームのツールが返す内容でこのページが開きます。どのツールもオブジェクトを1つ受け取り、1つ返します。cursorには前の呼び出しのnextを渡すと、そのリストの続きが返ります。
| ツール | 渡すもの | 返ってくるもの |
|---|---|---|
search_vault——保管庫の検索 | query、任意でfolder、limit(最大25)、cursor | results: { title, path, snippet }のリスト、next |
read_note——ノートの読み取り | path、任意でsection、maxChars(200〜20,000)、cursor | path、text、next |
get_outline——アウトラインの読み取り | path | path、properties: 名前と値、sections: { level, text, section }のリスト |
query_base——データベースの読み取り | base(.baseファイルのパス)、任意でview、limit(最大50)、cursor | base、view、views、rows: { title, path, properties }のリスト、next |
get_tasks——タスクの読み取り | 任意でrange(today、upcoming、overdue、inbox、all、done)、limit(最大50)、cursor | tasks: { state, title, due, priority, path, note, source }のリスト、next |
get_backlinks——バックリンクを読んでいます | path、任意でlimit(最大50)、cursor | path、notes: { title, path, links, places }のリスト、next |
graph_neighborhood——リンクをたどっています | path、任意でdepth(1または2)、limit(最大50) | path、notes: { title, path, fromHere, toHere, via }のリスト |
get_recent——最近のノートを見ています | 任意でkind(openedまたはedited)、limit(最大20) | kind、notes: { title, path, at }のリスト |
get_changes——変更点を見ています | since(YYYY-MM-DDの形式)、任意でuntil、folder、limit(最大20) | since、until、notes: { path, title, kind, made, last, added, removed, gained }のリスト |
get_note_history——ノートの経過をたどっています | path、任意でsinceとuntil(YYYY-MM-DDの形式、間隔は最大31日) | path、since、until、made、days: { day, added, removed, gained }のリスト |
get_calendar——予定を読んでいます | fromとto(YYYY-MM-DDの形式、間隔は最大31日)、任意でdetails、limit(最大100) | events: { day, start, end, allDay, title, cancelled, place, with, others, online, event }のリスト、more |
run_command——アプリの操作 | id(open-note、show-in-graph、open-calendarなどのアプリのコマンド)、任意でargs(path、section、date) | done、command |
propose_edit——ノートへの変更を提案 | path、edits({ find, replace }のリスト)またはappend、任意でsection、note | proposed、path、passages |
set_property——プロパティ値を提案 | path、key、value、任意でnote | proposed、path、property |
create_note——ノートの下書きを作成 | title、content、任意でfolder | drafted、kind、title |
create_entry——データベースの項目の下書きを作成 | base、title、任意でproperties、content | drafted、kind、title、base |
create_task——タスクの下書きを作成 | text | drafted、kind、title |
add_journal_entry——ジャーナルエントリの下書きを作成 | text、任意でtask | drafted、kind |
上限
スクリプトの上限は、そのマニフェストに書かれています。フォームで設定できるのは、次の3つです:
| 上限 | 既定値 | 範囲 |
|---|---|---|
| 計算時間(秒) | 5 | 1〜30 |
| ツールの呼び出し回数 | 20 | 0〜50 |
| メモリ(MB) | 32 | 8〜128 |
数えられるのは、スクリプトが計算している時間だけです。ツールにかかる時間は含まれません。上限——時間、メモリ、ステップ数、呼び出しの回数、1回の呼び出しの引数の大きさ、またはスクリプト自身の結果の大きさ——を超えたスクリプトは終了され、どの上限だったかがダイアログに表示されます。終了したスクリプトは何も返しません。ツールの返答が1回の呼び出しの上限より大きい場合は、終了にはなりません: スクリプトはその呼び出しでエラーを受け取り、そのまま実行を続けます。既定では、1回の呼び出しの引数、呼び出しが返す内容、結果は、それぞれ最大64 KBです。マニフェストで最大256 KBまで許可できます。
承認するまで何も実行されません
スクリプトが新しく届いたか変更された場合(同期によるもの、またはほかのプログラムが書き込んだもの)、このデバイスで承認するまで実行されません。そのスクリプトは、スキルの上部の承認待ちに表示されます。確認して承認では、できること、上限、入力、そしてコードの全体を確認でき、コードがJavaScriptとして読めるかどうかも示されます。読めないコードは承認できません。
承認を押すと、このデバイスがまさにこれらのファイルに署名します。そのためのキーはこのデバイスで作られ、キーチェーンに保管されます。ファイルに少しでも変更があると承認は取り消され、ほかのデバイスではスクリプトがそれぞれの承認を待ちます——承認をあるデバイスから別のデバイスへ持ち運ぶことはできません。スクリプトのメニューの承認を取り消すを選ぶと承認が解除され、コードを見るを選ぶと確認の画面がもう一度表示されます。
ベータ版の制限
スクリプトは提案と下書きを行い、直接書き込むのは、アシスタントに変更の直接反映を許可した会話の中だけです。ノートの名前の変更、移動、削除は行わず、メールや予定も作成しません。スキルからスクリプトを実行することはできず、スキル自身のscripts/フォルダーも実行されません。メール、インターネット、外部サーバーのツールは、スクリプトからは使えません。