レシピ

エージェントで大きなダウンロードの前にネットワークを確認する

エージェントは、今が大きな転送に適したタイミングかをKilobatに尋ねられます。Kilobatは約2秒で、1行のアドバイスを返します。

アプリとCLIで無料確認日：2026年10月29日

アプリで

  1. Wi-Fiメニューを開きます。従量制ネットワークには「接続済み · 従量制」と表示されます。

  2. Kilobatでのネットワークの扱いを変えるには、その「データコスト」を「自動」「従量制」「定額」のいずれかに設定します。

CLIで

  1. 状況をJSONで取得します。

    kilobat conditions --json

    出力 metered、osMetered、lowDataMode、vpn、internetLatencyMs、internetLossPercent、powerと1行のadvice。例：「Good conditions: online, unmetered, on power.」

  2. ネットワークが従量制なら、先に本人に確認します。その場合、速度テストは指定した予算の範囲内でしかデータを使いません。

    kilobat speedtest --budget-mb 10

  3. ダウンロード中はMacをスリープさせないようにします。

    kilobat awake -- huggingface-cli download org/model

MCPで

claude mcp add kilobat -- kilobat mcpでMCPサーバを一度接続します。他のクライアントについてはドキュメントを参照してください。接続後は、エージェントがこれらのツールを呼び出せます。設定を変更するツールは、先にユーザに確認するようエージェントに伝えます。

ツールと引数機能
get_conditions従量制、省データモード、VPN、遅延、ロス、バッテリー、温度とadvice。
get_updatersこのネットワークで現在アップデータが一時停止されているかどうか。
run_speedtest
{"budget_mb": 10}
データを使います。従量制ネットワークでは、エージェントは先にユーザに確認する必要があります。
keep_awake
{"minutes": 60, "reason": "Downloading the model"}
ダウンロード中のアイドルスリープを防ぎます。

知っておきたいこと

  • meteredはKilobatが動作の基準にする値、osMeteredはmacOSの報告です。meteredSourceはmacOSまたはyouです。
  • 遅延がnullの場合は、pingに応答がなかったことを意味します。インターネットが落ちていることの証明にはなりません。
  • Kilobatのエージェントスキルは、従量制ネットワークで大きな転送をする前に確認するよう、エージェントに指示します。

出典

出典は2026年10月29日に確認しました。manページはmacOSに付属のものです。「ターミナル」でman <name>を実行すると開けます。