Dashboard ガイド
Dashboard は、エージェントの Session を作成、確認、操作するための中心となる場所です。ホスト型の Remote Dashboard は、デバイス上で動作するエージェントに安全に接続します。
Dashboard を開く
app.pontia.dev を開き、登録済みのデバイスを選択します。デバイスをまだ登録していない場合は、リモートアクセスを参照してください。
Local Dashboard
Local Dashboard は http://127.0.0.1:8080/dashboard で利用でき、$PONTIA_HOME/config.toml の external_api_token を使用します。別のデバイスからアクセスするには、安全なトンネルまたはフォワーディングの設定が必要です。
Workspace を有効にする
Workspace は、エージェントが動作するプロジェクトディレクトリです。Session を作成する前に、Workspaces で設定済みのルートのいずれかを参照し、プロジェクトディレクトリを有効にします。
有効にできるのは、設定済みの Workspace Browser のルート内にあるディレクトリです。初回の初期化では、ホームディレクトリがデフォルトのルートになります。利用できるルートを制限または変更するには、Workspace を参照してください。
Session を開始する
- New chat を開きます。
- 有効な Workspace を選択します。
- pi、Codex、Claude Agent、ACP エージェントなど、有効な Agent Client を選択します。
- 作業内容を記述してプロンプトを送信します。
Pontia は永続的な Session を作成し、選択した Agent Client をデバイス上で起動します。チャットから別のページに移動しても、Session は Pontia 上に残ります。
進行中の作業を操作する
チャットページには、会話と、Agent Client が公開する作業ステップがストリーミング表示されます。Session の使用中は、次の操作ができます。
- エージェントがアイドル状態のときに、次のメッセージを送信する。
- 対応する Agent Client がビジー状態のときに、入力をキューに入れる。
- Client が中断に対応している場合に、現在の Turn を中断する。
- Client から求められたときに、コマンドの承認などのツールや権限のリクエストに応答する。
- 配信に失敗した Inbox のメッセージを再試行または破棄する。
- Client がモデルの変更に対応している場合に、
/modelで以降の Turn のモデルを変更する。 @を入力して、有効な Workspace 内のファイルやディレクトリを検索する。- コンポーザーの + ボタンでファイルを添付する（1 ファイルあたり最大 1 GiB）。
- 対象となる以前のユーザーメッセージを編集して、ネイティブの会話履歴をその時点から分岐させる。
Inbox は、配信待ちのメッセージや Agent Client がキューに入れたメッセージを追跡します。
共有ファイル
エージェントは pontia send-file PATH を実行して、Session からファイルを共有できます。ファイルは Turn の最後にカードとして表示され、プレビューまたはダウンロードできます。コンポーザーのメニューで Shared files を開くと、Session で共有されたすべてのファイルが一覧表示されます。Pontia はダウンロード時にデバイスからファイルを読み込むため、移動または削除されたファイルは利用できなくなります。
チャットコマンド
コンポーザーで / を入力すると、現在のコンテキストで使えるコマンドが表示されます。
| コマンド | 結果 |
|---|---|
/new | 新しい Session を開始します。可能な場合は現在の Workspace を維持します |
/rename | 現在の Session の名前を変更します |
/model | 以降の Turn のモデルを選択します（対応している場合） |
/compact | Session がアイドル状態のときに古いコンテキストを要約します（対応している場合） |
/exit | 現在の Session に対する Pontia のアクティブな制御を終了します |
/exit は、Session に対する Pontia の制御を終了します。ネイティブの会話のライフサイクルと保存は Agent Client が管理します。
キーボードショートカット
チャットページでは次のショートカットを使えます。
| ショートカット | 操作 |
|---|---|
Alt+J / Alt+K | 次または前のアクティブなチャットに移動します |
Alt+1 … Alt+9 | サイドバーの位置でアクティブなチャットを開きます |
Alt+N | New chat を開きます |
Alt+L | コンポーザーにフォーカスします |
Alt+? | ショートカット一覧を表示します |
Ctrl+B（macOS では Cmd+B） | サイドバーの表示を切り替えます |
Session を整理する
Session のアクションメニューから、名前の変更、ピン留め、アーカイブ、終了ができます。Sessions ページでは、アクティブ、アーカイブ済み、ピン留めの Session が分けて表示されます。アーカイブすると、記録された制御状態を削除せずに、Session がアクティブな一覧から外れます。
チャットのヘッダーには、Workspace、Git のブランチと状態、モデル、コンテキストの使用量、Client など、利用できるメタデータも表示されます。各項目は、選択した Client が報告する場合にのみ表示されます。
サービスや接続のエラーについては、トラブルシューティングに進んでください。