〜に関するすべて Ava Supernova

アバとは何ですか？

アバは実際に行動する AI です — 単に話すだけではありません。アプリを作成したり、文書を書いたり、ゼロから何かを教えたり、ロゴをデザインしたり、先延ばしにしている事務作業を処理したりしてくれます。そしてアバはあなたを覚えてくれます：何に取り組んでいるか、どんな風に好むか、先週何を頼んだかまで。

Ava は一人、そしてあなたが作業する場所ならどこでも働きます — コードエディタ内でも、デスクトップアプリとしても、ターミナル上でも。記憶も、性格も、どこでも同じです。

彼女ならではの強み

• デフォルトであなた専用。あなたの仕事はすべて自分のマシン上に残ります。追跡もテレメトリもなし。永久に。
• 誰でも確認可能です。アバのすべての行が公開されています。信用する必要はありません。
• 無料で始められます。毎月 300 クレジット、カード不要、隠れた条件なし — それとも独自の AI キーを接続すれば、私たちに支払う必要もありません。
• 学習機能が内蔵されています。アバにどの科目を教えてと頼めば、レッスン、例題、クイズを含む本格的なコースを作成してくれます。

今までコードを書いたことがない方へ？次のページはあなたのために書かれています。すでに技術に詳しい方へ？先に進んでください — アバについていけます。

コードを書いたことがない方へ？ここから始めましょう

もし一度もコードを書いたことがなければ、あなたはまさにアバのためのユーザーです。始めるために専門用語を学ぶ必要はありません — 知識豊富な友人に尋ねるように、平易な言葉で話しかければいいのです。このページがあなたの最初の入り口です。

今日できること、経験ゼロでも

• 何でも普通に聞いてみてください — 「このファイルは何をするの？」「なぜ私のページが空白なの？」「そもそもデータベースって何？」彼女は平易な言葉で答え、会話を覚えておきます。
• ゼロから学べる — 「ゼロから Python を教えて」と言えば、レッスンとクイズを含む適切なコースを作ってくれます。
• 作ってもらう — 欲しいものを説明する（「メモをダウンロードするボタン」など）と、彼女が書いてくれます。起こる前に変更をすべて表示します。

すべてを理解する必要はありません

アバには裏側で動く多くの仕組みがあります — モード、モデル、スペシャリスト、ルーティング。アプリやドキュメント内でこれらの言葉を目にするかもしれません。秘密をお伝えしましょう：ほとんどは無視して大丈夫です。アバが自動的に正しいツールと正しいお手伝い役を選んでくれます。技術的なページは、あなたが好奇心を持った時用であって、始めるために必要なわけではありません。

優しい最初の道

1. Ava をインストールして（次のページ）、チャットを開いてください。
2. 実際に聞きたいことを入力してみてください。どんなことでも大丈夫です。彼女の答え方を見てみましょう。
3. 学習モードを試してみましょう：「teach me」とトピックを入力してください。ついていきましょう。
4. 実際に何かを作ったり変更したりしたいときは、ただ頼んでください — 彼女はいつも自分が何をしようとしているかを示し、あなたの「はい」を待ちます。

インストール

あなたの働き方に合う画面を選んでください。1 つ以上使えます。同じマシン上では ~/.ava フォルダを共有するので、Ava の記憶もまた、その間を行き来します。

VS Code 拡張機能

1. VS Code の拡張機能パネルを開きます（Ctrl+Shift+X / Cmd+Shift+X）。
2. 「Ava Supernova」と検索して、インストールをクリックします。
3. チャットパネルを開くには、Ctrl+Shift+A を押します（macOS の場合は Cmd+Shift+A）。
4. セットアップウィザードに従ってください。モデルを選び、権限モードを設定したら完了です。

デスクトップ IDE

1. リリースページから、お使いのプラットフォーム用のインストーラーをダウンロードしてください。
2. それを実行してください。初めて起動するときは、ウェルカム画面が表示されます。
3. 無料のプラットフォームトークンを受け取るにはサインインするか、あるいは独自の API キーを貼り付けて、すべてローカルで実行することもできます。

CLI

1. `npm install -g @ava/cli` を実行してください（または pnpm / yarn — お好みで）。
2. 任意のプロジェクトディレクトリで `ava` を実行します。
3. 初回実行時にプロバイダーとモデルを尋ねます。選んで始めましょう。

Ava との最初のステップ

Ava を使いこなす最速の方法は、実際にやりたいことを頼んで、その様子を見ることです。読むべき設定もなければ、最初に覚えることもありません — ただ、欲しいものを普通の言葉で伝えるだけです。

まずはこれを実践してみましょう

1. チャットを開いてください。
2. 本当にやりたいことを入力してください。「このプロジェクトは何をしているか説明して」、あるいは「フォームをクリアするボタンを追加して」などがおすすめです。
3. Ava は自分が何をしようとしているかを表示し — そして待ちます。
4. 気に入りましたか？「はい」と言ってください。彼女が実行する様子を見守りましょう。

これが全体のリズムです：あなたが頼み、彼女は計画を示し、あなたが承認し、彼女が実行します。彼女はまずあなたに見せることなく何も変更しません — だから試しても壊してしまう心配はありません。

頼んでみると良いことのいくつか

• 質問 — 「なぜ私のページは空白なのですか？」「このファイルは何をするのですか？」
• 何か作ってもらう — 「簡単な ToDo リストページを作って」
• 学びたいこと — 「ゼロから Python を教えて」。彼女はあなたのために本物のコースを、一歩ずつ作ります。
• ドキュメント — 「1 ページ分のプロジェクト提案を書いて」。Word ファイルか PDF を手渡します。

ローカルとクラウド、1 つのパラグラフで

Ava が持つ情報はすべてローカルにあります。記憶、タスク、ジャーナル、パーソナリティ、設定 — これらはすべてあなたのマシン内の ~/.ava/ と .ava/（プロジェクトごと）に保存されます。HTTPS を通じてモデルプロバイダーに問い合わせてリクエストを実行し、その後自宅へ戻ります。電話もしなければ、テレメトリも集めず、あなたのコードで学習することもありません。

ログインすれば、両方のサービスで毎月 300 クレジットが無料で使えます — Qwen 上の Maestro と、DeepSeek コーディネーター付きの Supernova です。ログインしても、記憶やタスク、設定がアップロードされることはありません。クラウド同期もありません。API キーを自分で用意すれば、Ava はアカウントなしでもフル機能で使えます。

AI を選ぶ必要がありますか？

ほっとしてください。AI を自分で選ぶ必要はありません。Ava が各ステップに最適なものを自動的に選んでくれるので、考えなくても良い結果が得られます。

あなたが選べるのはルーティングスタイルだけ——デフォルトはほぼすべての人に合います。特別な理由がない限り、他のスタイルは必要ありません。

2 つのスタイル

• Maestro —— デフォルト。安定しており、信頼でき、予測可能。迷ったらこれを選んでください。
• Supernova —— 重く複雑なマルチステップ作業向け。仕事の各パートに異なる専門家を配置する価値がある場合。

チャット上部のモデルピッカーからいつでも切り替えられます。何も固定されていません。

わかりやすい用語集

Ava に関連して出てくるかもしれない言葉すべてを、前提知識ゼロで解説しています。これを全部覚える必要はありません — 用語で詰まったときはいつでもここに戻ってきてください。

ルーティング — Ava がモデルを選ぶ方法

簡単に言うと：使用する AI モデルを選ぶ必要はありません。Ava が代わりにやってくれます。仕事の各部分に最適なツールを選ぶ——優れたマネージャーが適切なタスクを適切な人に任せるようなものです。

2 つのスタイル（Maestro または Supernova）からお選びください。Ava がそれぞれの作業を最も得意とするモデルに送ります。Maestro がデフォルトで、すべてのプランで利用可能であり、ほぼすべての人に最適な選択肢です。

なぜルーティングが必要なのか？

各ステップに適切なモデルを配置する方が、1 つの高額なモデルですべてを実行するよりコストが安く、結果も良くなります。なぜなら、各モデルは得意なことを行うからです。どのモデルが何かを知る必要なく、安定したコストと高品質が得られます。

Ava クレジット — 請求の仕組みについて

クレジットは、Ava が使用量をカウントする方法です — 携帯電話プランの分単位のようなものです。無料プランを含むすべてのプランにクレジットプールが付与され、Ava が行うことすべて（回答、画像作成など）に少量のクレジットがかかります。それが基本理念です。詳細は、何にいくらかかるか正確に知りたい場合向けです。

Ava はトークン数ではなく、クレジットで請求します。（「トークン」は AI モデルが読み書きする小さなテキストの断片 — およそ数文字程度 — のことです。多くのサービスではトークン単位で課金されますが、これは予測が難しいものです。）1 クレジットは 1 つの作業ユニットをカバーします — チャット 1 回、ペルソナの起動（タスクの一部を担う 1 人のアシスタント）、画像生成などです。トークン単位の課金方式から切り離されているため、どのモデルが動いているかを知らなくても、アクションにかかるコストがわかります。同じチャット 1 回でも、Maestro が Qwen 3.7 Plus にルーティングする場合も、Supernova が DeepSeek Flash にルーティングする場合も、コストは同じです。

プラン

すべてのプランで全機能にアクセス可能です — モデルアクセス、Creative Studio、すべての 7 つモード、フルペルソナオーケストレーション。上位ティアはより多くのクレジットと高いレート制限上限を購入するだけで、ロック解除される機能はありません。

• フリー — 月額$0。300 クレジット。1 分あたり 20 リクエストのレート制限。カード登録不要。
• プロ — 月額$19。5,000 クレジット。1 分あたり 60 リクエスト。
• ウルトラ — 月額$39。10,000 クレジット。1 分あたり 120 リクエスト。
• エンタープライズ — 月額$79。20,000 クレジット。1 分あたり 200 リクエスト。

各アクションの料金

アクションごとのコスト表 — 各アクションが実行された際に、あなたのクレジット残高から差し引かれる金額です。（「キャッシュヒット」とは、Ava がすでに実施済みの作業を再利用してやり直さないことを指します。その場合は支払いが減り — 請求額は 70% 下がります。DeepSeek Flash のような出力量の多いモデルでは 50% です。）

• チャットターン — 2 クレジット。どのモードでも 1 往復。
• ライトコール — 1 クレジット。意図ゲート、分類、シングルショット読み込み。
• ヘビーペルソナ — クレジット 3 点。アーキテクト、リサーチャー、CVE リサーチャー、イディエーター（深度 ≥ 4）。
• ライトペルソナ — クレジット 1 点。スカウト、ベリファイア、シーケンサー、チャレンジャー（深度 ≤ 2）。
• オーケストレーション — クレジット 10 点。フルペルソナパイプラインの起動（コンダクター＋マルチペルソナタスク）。
• 画像生成 — クレジット 12 点。Creative Studio.
• 動画生成 — 150 クレジット（720p）、1080p では 300。Creative Studio、Wan を経由して。
• 音声生成 — クレジット 10 点。Creative Studio、Qwen3-TTS を経由して。
• 背景削除 — クレジット 2 点。

モデルごとの乗数

これは好奇心旺盛な方のための情報 — Ava を使うのに必要ではありません。乗数は、アクション背後にあるモデルのコストが高いか低いかに応じて、クレジットコストを上下に調整するだけです。つまり、重いモデルは少し高くなります。（「ネットマージン」とは、プロジェクトが自社の経費を支払った後に残す利益の割合のことです。私たちはこれを低く抑えることで、価値があなたに戻るようにしています。）

各モデルには、実際に動かすコストに合わせて料金を調整する「乗数」が付いています。軽量なモデルは基本枠よりも安く、重いモデルはそれ以上かかります。純利益率は約 30% に設定されており、以前は 55%、次いで 40% から見直されました。目標値が下がるたびに乗数も下がり、その差額がすべてお客様へ戻ってきます。

• 1.0× — 乗数が記載されていない任意のモデル。基本レートです。
• フリート自体が追加料金を発生させることはありません。すべてのルーティングスタイルは設計上 1.0× です。ターンのコストは、実際に使用されるモデルによってのみ決まります。そのため、フリートをより安いリードモデルに変更しても、料金体系を変更せずに請求額を下げることができます。
• DeepSeek について一点だけお知らせです：UTC 時間 01:00～04:00 と 06:00～10:00 の間は料金が倍になります。ここに記載されている DeepSeek の価格やコスト計算機で表示される金額はすべてオフピーク料金であり、24 時間のうち 17 時間に適用されるものです。

BYOK とクレジット

BYOK（「bring your own key」— AI プロバイダーのアカウントと、その有料アカウントを利用するための秘密のパスワードであるキーを自分で用意する方式）は、すでに AI プロバイダーに直接お支払い済みの方向けです。もし該当しない場合は、このセクションは読み飛ばしていただいて大丈夫です。

BYOK のリクエストはプラットフォームのインフラを経由せず、Ava からプロバイダーへ直接接続されます。そのため、プロバイダーに直接支払いが行われ、クレジットは消費されません。ただし例外があり、BYOK セッション内でサブタスクのためにマネージド型のペルソナが起動された場合のみ、Ava のオーケストレーション機能が利用されるため、クレジットの差し引きが発生します。

残高の確認方法

• エクステンション — 設定 → アカウント、またはチャットヘッダーにあるクレジット表示。
• IDE — アカウントダッシュボードのウィジェットに、現在の残高と消費ペースが表示されます。
• Web — avasupernova.com/dashboard で残高、利用履歴、更新日を確認できます。

モード — Ava の思考状態

モードとは、Ava がいる心の状態のことです — 同僚が帽子を替えるようなものです。同じ人、あなたへの記憶も同じですが、ビルダーは教師とは違う考え方をします。モードを選ぶと、彼女の振る舞いや連れてくるヘルパーが変わります。モードセレクターでいつでも切り替えられますし、2 文字のショートカットを入力してもいいでしょう。

どれを選びますか？

やりたいことから始めてください — モードはそこから決まります：

• 何かを作ったり変更したい → コード (>>)。あなたが説明すると、彼女は作ってくれます。まず全ての変更を見せます。大きな仕事にはフルヘルパーチームが出動します。
• 何も変える前に計画が欲しい → プラン (::)。よく考えてから、承認や編集用の計画を渡します。このモードではファイルに触れません。
• ただ話したり聞きたいだけ → チャット (..) 。記憶、ニュース、天気を持った思考パートナー。ファイル変更もコードもなし — 会話だけです。
• 何か学びたい → ティーチ (??)。あなた専用の本格的なコース：レッスン、クイズ、すべて揃っています。すべてのプランで利用可能。初めての方にも最適です。
• プロジェクトのセキュリティ穴をチェックしたい → セキュリティ (!!)。チームが一般的なウェブ脆弱性の標準リスト（「OWASP」カテゴリ）と既知の報告された欠陥（「CVE」と呼ばれるもの）を確認し、各問題の深刻度順にレポートを渡します。これは開発者向けです — あなたがそうでなければスキップしてください。
• アイデアが欲しい → ブレインストーミング (**)。実際の状況に基づいた選択肢を生成し、弱い点を突っ込み、残りを次のステップに磨き上げます。
• ドキュメントを書きたい → 執筆 (<<)。レポート、提案書、手紙、記事 — Markdown で下書きし、ブランド付きの Word ドキュメントや PDF にエクスポートして、セクションごとに磨き上げます。コードなし、文章だけです。

メモリー — Ava があなたをどう覚えているか

簡単に言うと：Ava はあなたを覚えています。一度何か伝えてください — 好きなことや決めたこと — すると彼女はそれを覚えておき、次のチャットでも来週にも繰り返す必要がありません。これが基本です。以下の詳細は、時間が経ってもその記憶を整理する方法を説明しています。

Ava には「永続的な記憶」があります（「永続的」とはアプリを閉じても消えないという意味）。これは会話やプロジェクトを超えて続き、あなたのマシン上だけにあります。単なるチャットの履歴ではありません。あなたという人が、何を好み、何を決めたのかを理解した、構造化され検索可能な知識なのです。

5 つの層

1. 抽出 — 毎回のメッセージからリアルタイムで重要な事実をキャプチャします。
2. 振り返り — 有意義なセッションの終わりに、より深い分析が行われます。パターン、テーマ、矛盾点など。
3. 蓄積 — 修正や好みが数週間、数ヶ月をかけて積み重なっていきます。
4. 分析 — グラフエンジンが関連するメモリをつなぎ合わせ、新しい情報が古い情報と矛盾する場合に警告を出します。
5. 統合 — 似たメモリは結合され、古くなったものは整理されます。メモリは時間とともにノイズが増えるのではなく、より鋭くなります。

検索・想起

質問をすると、Ava は単語の一致だけでなく、意味に基づいてメモリを検索します（「セマンティック検索」— あなたが何を意図しているかを理解するため、表現が変わっても正しいメモリが見つかります）。モード固有のフィルターも同時に動作します。チャットモードでは個人コンテキストを、ワークモードではプロジェクトの決定事項やコードパターンを引き出します。

タスクとジャーナル

Ava はあなたのために 3 種類のメモを残しています。混同しやすいので、覚え方のコツ：記憶は Ava があなたについて知っていること、タスクはまだやるべきこと、ジャーナルは出来事の日記です。それぞれいつ使うかはこちら。

• 記憶 — 永続的な事実。好み、決定、パターン。繰り返し聞かれることが多く、手動で作られることはほとんどありません。
• タスク — やること。期限とステータスのあるアクションアイテム。終わったらチェックを入れます。
• ジャーナル — 振り返り。日々のログ、ダブルエントリー（あなたとセッションに関する Ava の観察）。気分トラッキング、セッションレビュー、明日のための文脈に役立ちます。

Ava は意味があるときは 3 つすべてに記録します。ダッシュボードから直接どれにも書き込めます。Ava を使う場所は一つに限定されていません。ある場所（例えばコマンドラインツール）で作成したタスクは、他の場所（デスクトップアプリなど）にも自動的に表示されます。

パーミッション — あなたの安全ダイヤル

パーミッションはあなたの安全ダイヤルです。Ava がコンピュータ上で何かをする前に許可を求めるときか、そのまま進めるかを決めます。すべて聞く設定、危険なものだけ聞く設定、信頼して任せる設定ができ、いつでも変更できます。わからない場合はデフォルトのままにしておけば大丈夫です。

Ava には 120 以上のツールがあります（「ツール」とは、ファイルの読み込みやウェブ検索など、Ava が実行できるアクションのことです）。各ツールはカテゴリに属しています（ファイル操作、シェル、Git、Web、メディア、データベース、システム、ドキュメント、メモリ、学習）。ツール呼び出しは実行前に許可ゲート（まずあなたに確認するか決めるチェックポイント）を通ります。どのツールが自動承認され、どれが一度確認を求めるか、どれが常に確認を求めるかはあなたがコントロールできます。

デフォルトはバランス型です。監査中（各ステップを細かく確認したいとき）は厳格型。ただ任せたいときは自律型。

Ava の操縦と停止

あなたがいつも主導権を持っています。Ava が作業中の間、方向転換を促して流れを壊さずに進めたり、完全に停止させたりできます。2 つのボタン、2 つの結果 — これがこのページのすべてです。

Ava は計画が完了するか、あなたが停止するまで実行を続けます。実行中に介入（この行為の用語は「インタージェクト」です）するには、2 つの方法があります。

インタージェクト — キャンセルせずに方向転換

Ava が作業中にある新しいメッセージを入力してください。彼女は現在のツール呼び出しを完了し、あなたのメッセージを読み取り、計画を調整します。コンテキストは失われません。実行中にリダイレクトしたい場合、情報を追加したい場合、優先順位を変更したい場合にこれを使用してください。

ハードストップ — キャンセルしてクリア

Escape キーを押す（CLI）、クリックで停止（拡張機能、IDE）、または停止コマンドを入力します。現在のランがキャンセルされ、保留中のツール呼び出しは破棄され、会話は新しいターンに向けて準備が整います。

デスクトップ・ペルソナ

このページは、詳しく知りたい方や上級者向けです。「デスクトップ自動化」（「コンピューター操作」とも呼ばれます）とは、Ava が実際に画面をクリックしてアプリを操作できることを意味します — Gmail を開いたり、フォームに入力したり、メッセージを送信したり — キーボードの前にいる人間のよう。安全に行うために、仕事は 5 つの小さなアシスタントに分担されます。それぞれが特定の役割を持ちます。あなたが直接関わることはありません。ここでは、それぞれの担当者が何をするのかをご紹介します。

デスクトップの軌跡（Ava が画面を操作して目標に向かう 1 つの実行）のすべてのステップで、5 つのペルソナによる一連の動きが実行されます。各ペルソナには 1 つの仕事しかありません。この分離により、プロンプトは簡潔に、出力は構造化され、推論は意図的に慎重に行われます。

スカウト

現在画面に表示されているものを報告します。要素を発明しません。計画も立てません。要素 ID、名前、バウンディングボックス、信頼度、およびグラウンディングソース（UIA、Playwright DOM、または OmniParser ビジョン）を含む ScreenState JSON を返します。

プランナー

次の単一のアクションを決定します。ステップごとに 1 つのアクション — バッチ処理はしません。元に戻せる経路を好みます。安全性オントロジーに基づいてリスクを分類します。種別、ターゲット、パラメータ、riskClass、推論、および予想される後状態予測を含む ProposedAction JSON を出力します。

アクター

承認ゲートを通過した後、プランナーが提案した内容を正確に実行します。即興はしません。再試行もしません。失敗は忠実に報告され、次なる動きは Verifier が処理します。

ベリファイア

アクションが成功したかどうかを確認します。最新の ScreenState をプランナーの予測と比較します。検証済み、逸脱、またはロールバックが必要と判断します。また、ループ検出を実行します — すでに成功したアクションを繰り返すことは、検証ではなく逸脱です。

ナレーター

一連の作業の間、ユーザーが聞く唯一の声です。ステップごとに過去形の文を 1 つ（「Gmail を開きました。」、「Compose をクリックしました。」）。構造化された監査ログも作成します。何か問題があったときは言います — 問題を隠すことはありません。

デスクトップ・セーフティ・オントロジー

簡単に言うと：Ava が画面の何かをクリックする前に、そのアクションのリスクレベルで分類します。画面を読むだけ？無害です。送金や削除？彼女は必ず一度止めてあなたに確認します — 毎回例外なく。以下の 5 つのラベルは、そのリスク梯子の段にすぎません。これはパワーユーザー向けの詳細ですが、要点はシンプルです：危険なものは常にあなたの許可が必要です。

提案されたすべてのアクションは、5 つのリスククラスのいずれかに分類されます。分類は 3 つの信号を組み合わせたものです — 画面上のターゲットが何であるか、それの平易な言語での説明（「セマンティックキャプション」— Ava が見ているものについての自分の言葉）、そしてアクションの設定 — そしてそれらが不一致の場合はエスカレーションします（より危険だと扱います）。偽陽性（必要ないのに尋ねる）はただの煩わしさです。偽陰性（尋ねるべきなのに尋ねない）はサービス終了につながる事故です。

5 つのクラス

• 観測的 — UIA ツリー、スクリーンショット、ホバーを読む。常に自動許可。
• 移動的 — スクロール、フォーカスを移動、メニューを開く。ドライブモードでは自動許可。
• 変更可能で元に戻せる — フィールドへの入力、貼り付け、アプリの起動、URL の移動。Ask モードでは確認が必要ですが、ホワイトリスト内の Drive では自動で行われます。
• 変更不可（元に戻せない） — 送信、提出、支払い、削除、確認、公開。許可レベルに関わらず、毎回必ず確認が必要です。承認内容はキャッシュされません。
• 特権操作 — UAC 昇格、sudo、レジストリ編集、認証プロンプト。デフォルトでは禁止されています。セッションごとに一度限りのオプトインが必要です。

承認はキャッシュされません

すべての競合他社は承認をキャッシュします（あなたの「はい」を覚えて、次回再利用してしまいます）。これがプロンプトインジェクション攻撃の最大の足掛かりです — 罠を仕掛けられた Web ページが AI に隠れた指示を忍ばせ、あなたに不利な行動をとらせる攻撃のことです。承認がキャッシュされていれば、乗っ取られたページが以前与えた「はい」に乗っかることができます。Ava は決してキャッシュしません。それぞれの変更不可アクションは、毎回新鮮に（新たに）確認を求めます。

シークレットの扱い

パスワード、API キー、2FA コード（ログイン時に別のアプリやテキストメッセージから受け取るワンタイムコード）は、実体を見せないハンドル（実際の値に代わるプレースホルダー）を通じて扱われます。Ava が目にするのは「{secret}」だけで、実際のパスワードではありません。実際の値は、Ava のメモリやアクティビティログ、あるいは彼女が「読み込む」内容には一切入りません — 別の低レベルのレイヤーが最後の瞬間、キーを押したタイミングで直接入力するため、AI 部分がそれに触れることはありません。

デスクトップ・グラウンディング階層（プレビュー）

Ava がボタンをクリックする前に、画面にあるものが何で、どこにあるかを実際に理解する必要があります — これが「グラウンディング」（画面にある各ものが何で、正確な位置はどこかを見つけること）です。やり方は 3 つあり、あなたが使っているアプリに適した最も信頼できるものを選びます。これは深いパワーユーザー向けの詳細ですが、ポイントはただ一つ、彼女は写真から推測するよりも、確実で正確な方法を好むということです。

3 つの段階があり、順番に評価されます。最も軽量で信頼できるソースが勝ちます。

1. ブラウザウィンドウ → Playwright DOM

アクティブなウィンドウが Web ブラウザの場合、Ava は画像から推測するのではなく、ページ自体の構造（「DOM」— ページにあるものの背後にあるリスト）を読み取ります。構造を読むことは、ピクセルを目視するよりも約 10 倍信頼性が高いです — ボタンの位置やページの読み込み完了を正確に知っています。これは Web 上のあらゆるものに適用されるメインの経路であり、バックアップではありません。

2. UIA 対応ネイティブアプリ → Windows UI Automation

Windows の一般的なデスクトップアプリの場合、Ava は組み込みのアクセシビリティマップ（「UIA」、画面リーダーがウィンドウを説明するために使用する同じデータ）を読み取ります — それぞれのコントロール、名前、位置をリストします。そのマップが少なくとも 5 つの有用な名前付きアイテムを返す場合、彼女はそれを信頼して使用します。

3. UIA が空または無効 → OmniParser ビジョン

そのマップがないか役に立たない場合（一部のアプリ、ゲーム、リモート画面は提供しない）、Ava は実際にはスクリーンショットを見ることに戻ります。ビジョンツール（OmniParser）がクリック可能な領域を見つけ、それぞれが何かをラベル付けし、画像を再び行動可能なリストに変換します — アクセシビリティマップが提供してくれたわずかな情報と組み合わせられます。

デスクトップ・キルスイッチ（プレビュー）

「キルスイッチ」とは名前の通り — Ava があなたの画面を制御しているときに即座に停止させる緊急手段です。安心できる点：3 つあります。それぞれ別々に作られているので、一つが失敗してももう一つが働きます。すべてを覚える必要はありません。何かおかしいと思ったらいつでも止められることだけ知っておいてください。そして最も強力な停止（下のパニックキル）は Ava の協力を頼りにしません。

公的な自律性のトラブル事例（AI エージェントが停止コマンドを無視したり、メールアーカイブを削除したり、ドライブを消去したりした実際のケース）をすべて読んだ後、私たちは 3 つの異なるレイヤーに 3 つのキルスイッチを構築しました。それらのいずれも AI モデル自体に依存していません — Ava が固まって動かなかったとしても、あなたは依然として彼女を止めることができます。

一時停止 — スペースキーまたは一時停止ボタン

次のステップの区切りで一時停止します。再開できます。進行方向を維持したまま、途中で介入したい場合に使いましょう。

停止 — Escape キーまたは「停止」ボタン

きれいな中止処理です。ナレーターがこれまでに実行した内容をまとめます。再開はできません。監査ログに記録されます。

パニック終了 — Escape を 3 回押すか Ctrl+Shift+K

これが最も強力な停止方法です。小さな独立した監視プログラムが、あなたの画面を操作している Ava の一部を強制終了します。AI の応答を待たず、アプリウィンドウが正常でなくても構いません。何らかの状態であっても関係なく、強制的に止めます。本当に何か問題が起きた時用の機能です。

ツールリファレンス

これは Ava が持っているすべてのツールの完全なリストです。「ツール」とは、ファイルの読み込みや検索の実行など、Ava が取ることのできる特定のアクションのことです。このページを読む必要はありません。Ava は毎回適切なツールを自分で選んでくれます。Ava が具体的に何ができるのか気になった時のために用意されています。

完全な組み込みツールボックスです。ここにあるすべてのツールはコアランタイム（3 つのインターフェースを支えるエンジン）に登録されており、モードと権限設定が許可する限り Ava が利用できます。カテゴリやリスクレベルで絞り込んでください。

これらをすべて覚える必要はありません。下の表はあくまで参照用カードです。

リスクレベル

• セーフ — 何も変更せず読み取るだけです。`file_read`, `glob`（名前のパターンでファイルを探す）, `grep`（ファイル内からテキストを検索）, `git_status`（`Git` はプロジェクトの変更を追跡するシステム）。
• 書き込み — ファイルを変更したり、作業のチェックポイント（「コミット」）を保存したり、新しいものを生成したりします。`file_edit`, `git_commit`, `generate_image`。
• ダンジャー — コンピューター上でコマンドを実行（「シェル」）、デスクトップを制御、インターネットにアクセス、またはデータベースを照会します。`bash`, `browser`, `desktop_*`。

モデル

「モデル」とは、考える AI の頭脳のことです — Qwen, DeepSeek, Mistral など。このページでは Ava が使用できるすべてのモデルをリストしています。簡単に言うと：あなたが一つを選ぶ必要はありません。Ava は各ステップごとに最適なモデルを自分で選んでくれます。理解したい場合や、その選択を上書きしたい場合のみお読みください。

Ava がルーティングできるすべてのモデルに加え、3 つのオーケストレーション戦略（ジョブの各部分をどのモデルが担当するかを決めるルール）も記載しています。ルーティングモードを選んで Ava に任せるか、単一のモデルを選んでルーティングを完全にスキップすることもできます。

ルーティングモード

2 つの協調型戦略です。どちらも同じペルソナ・パイプライン（裏側で Ava が動かす専門家の小さなチーム）を走らせていますが、変わるのは基盤となるモデルのフリートです。モデルセレクトでモードを選ぶと、Ava が残りをすべて処理します。以下の各カードには、指揮者がルーティングする各スペシャリストが示されています。

下のカードを覚える必要はありません。各戦略が何で構成されているかを確認できるように用意されています。

プラットフォーム管理モデル

すべてのプラン、無料プランも含めてご利用いただけます。トークン（AI がテキスト量を測る単位で、およそ単語の 3/4 文字分）は、プランの利用枠から差し引かれます。キー（各有料モデルへのアクセスに必要な秘密のパスワード）はプラットフォームが自動的に更新・管理するため、お客様が設定する必要はありません。

お手持ちのキーを使用

「API キー」とは、ソフトウェアがお客様のアカウントで有料サービスを利用できるようにする秘密のパスワードのことです。「BYOK」とは「お手持ちのキーを使用する」という意味で — 私たちが用意したものではなく、ご自身のもので使います。設定画面に API キーを入力してください。BYOK のリクエストは、Ava からプロバイダー（モデルを運営する企業）へ直接送られます — 私たちのインフラを経由せず、プラットフォームトークンも消費しません。料金はプロバイダーにお支払いいただき、当社は通信内容を確認することはありません。

ペルソナ・オーケストレーション

「ペルソナ」とは、難しいタスクのために裏側で活躍する Ava のお手伝い役のことです。探検家、プランナー、事実確認係などです。あなたが直接話すことはなく、このページを理解しなくても Ava を使うことができます。これは、Ava が大きな仕事を小さな専門家チームにどのように分解するか、詳しく知りたい方のためにあります。

5 つのモードチームにわたる 24 名の専門家。指揮者（Conductor：残りを調整するお手伝い役）が、どのチームが動き、どのような順序で、どのようなコンテキストで動くかを決定します。チャットモードにはペルソナはありません——それは Ava そのものです。

オーケストレーションの実行方法

1. Plan、Teach、Security、Brainstorm モード（または複雑な Work リクエスト）でメッセージを送信します。
2. 指揮者がリクエストを読み取り、モードチームを選び、実行計画を立てます。一部のペルソナは順次、一部は並列波で実行されます。
3. 各ペルソナには独自のシステムプロンプト、制限されたツール許可リスト、および以前のペルソナが見つけたことの共有コンテキストプールがあります。
4. 最後のペルソナが、モードに応じて要約、計画、またはレポートを作成します。
5. Ava が結果をあなたに提示します。承認、修正、または指示を変更できます。

以下の完全な名簿は参考のみです——誰が何をするか暗記する必要はありません。Ava があなたに必要なチームを組み立てます。

CLI コマンド

このページは CLI 向けです — ボタンをクリックするのではなく、ターミナルウィンドウで文字を入力して使う Ava のバージョンです。拡張機能やデスクトップアプリをお使いの場合は、このページを完全に飛ばしても問題ありません。こちらはキーボード操作を好む方のために用意されています。

CLI は REPL（対話型プロンプト）です — 入力を待ち、実行し、また待機するというサイクルです。これらのスラッシュコマンド（「/」で始まる指示）は、このプロンプトから使用できます。

• /help — コマンド一覧と現在のモードを表示。
• /mode <名前> — モードを切り替えます（work, write, plan, chat, teach, security, brainstorm）。
• /model <ID> — セッションを離れずにモデルを切り替えます。
• /clear — 現在の会話をクリアします。メモリは影響を受けません。
• /history — このプロジェクト内の過去の会話の一覧を表示。
• /memory — メモリブラウザを開きます。
• /tasks — タスクの一覧表示と管理。
• /journal — 今日のジャーナルエントリを開きます。
• /settings — 設定メニューを開きます。
• /exit — REPL を終了します。

起動フラグ

フラグは、Ava を起動する際に加えるオプションです。それぞれ「--」で始まり、どのように起動するかを設定します。

• --mode <名前> — 特定のモードで開始します。
• --model <ID> — 特定のモデルで開始します。
• --permission <モード> — 厳格 / バランス / オートノマス。
• --project <path> — プロジェクトのルートディレクトリを明示的に設定します。

設定

このページでは、Ava があなたのコンピュータ上で設定やファイルをどこに保存しているかを確認できます。ほとんど手動で触る必要はありません——アプリが自動的に管理してくれます。自分で確認したり、バックアップしたり、共有したい場合のためにここに用意されています。

Ava は設定（保存された設定）を 2 つの範囲から読み取ります。グローバル設定（どこでも適用される設定）は、`~/.ava/` というフォルダにあります（「~」はホームフォルダの略語です）。プロジェクトごとの設定は、プロジェクト内の `.ava/` フォルダにあります。

グローバル — ~/.ava/

• settings.json — モデルの好み、許可モード、性格、言語。
• memory/ — グローバルメモリ（全体的な好みや、どこでも適用される決定など）。
• tasks.json — プロジェクト間共通のタスクリスト。
• journal/ — 日付ごとに整理された日々の日記エントリ。

プロジェクト — .ava/

• instructions.md — Ava が常に読み込むプロジェクト固有の指示。永続的なコンテキスト（「pnpm を使い、npm は使わない」「API キーは 1Password に保存されている」など）。
• context.md — オプションの自由記述形式のプロジェクトメモ。
• memory/ — このプロジェクトに限定されたメモリ。
• datasets/config.json — オプトイン型のデータセット収集設定。

キーボードショートカット

キーボードショートカットは任意の高速化機能です——すべてクリックできるボタンでもあります。キーボードから Ava を操作する速度を上げたい場合のみこちらをご覧ください。

画面ごとのショートカット（Ava が動作する 3 つの場所：VS Code 拡張機能、デスクトップアプリ、ターミナル）。各画面の設定でカスタマイズできます。以下のリストを覚える必要はありません。

プロジェクトのコンテキスト

これは、Ava が作業を開始する前にプロジェクトについてどう調べるか、つまりあなたが何に取り組んでいるかを理解するために参照するファイルについて説明しています。これらを自分で設定する必要はありません。Ava が自動で行います。Ava が必ず見てくれるようにメモを置く場所を知りたい場合はこちらをお読みください。

プロジェクトを開くと、Ava は複数の層のコンテキスト（頭の中にある背景情報）を読み込みます。これらの層を理解することで、情報を適切な場所に配置しやすくなります。

自動的に読み込まれるもの

• .ava/instructions.md — 永続的で優先度の高いガイドラインとして扱われます。常にコンテキストに含まれます。
• .ava/context.md — フリーフォームのメモです。読み込まれますが、優先度は低めです。
• README.md — 初回実行時にスキャンされ、プロジェクトの概要を取得します。
• package.json / pyproject.toml / Cargo.toml — プロジェクトの設定を列挙した小さなファイルです。言語、フレームワーク、テストコマンドを検出するために読み取ります。
• .gitignore — バージョン管理から除外するファイルのリストです。すべてのファイルツール（glob, grep, project_index）で尊重されます。

必要に応じて読み込まれるもの

「必要に応じて」とは、Ava がタスクで実際に必要とする時だけこれらを取得することを意味し、最初からすべて取得するわけではありません。

• プロジェクトインデックス — ファイルとその内部の名前付き部品（関数、クラス — "シンボル"）およびそれらがどのように接続しているか（"インポート"）の構造化されたマップです。必要な時だけ構築されるため、遅延ロードされます。
• Git の履歴 — 過去の変更の記録です。git_status、git_diff、または git_create_pr が呼び出されたときに取得されます（Git はプロジェクトへの変更をすべて追跡するツールです。"PR" はプルリクエスト、提案された変更のバッチです）。
• メモリ — エントリは意味に基づいて（"意味的に"）一致し、一度にすべてではなく、1 ターンずつ注入されます。

デスクトップ予算の上限

Ava があなたの代わりにデスクトップを操作するときは——クリックやタイピング、アプリの起動など——それぞれの実行を「トラジェクトリ」と呼びます。このページでは、一度の実行が長く続いたりコストがかさんだりしないよう、安全な制限を設けています。結論から言うと、彼女はオーバーランする前に必ず止まって確認します。詳しい数字はここにあります。

すべてのトラジェクトリは、同時に適用される 3 つの上限（ハードリミット）の下で実行されます。最初に到達したものが有効になります。違反してもトラジェクトリは静かに続行せず、ナレーター（進行状況を教えてくれるお手伝い役）が一時停止して、どうするか尋ねます。

3 つのハード上限（デフォルト）

• ステップ数 — 30 ステップ
• トークン予算 — 500,000 トークン
• 実時間 — 5 分

タスクのコスト帯域

• シンプル（ドキュメント検索、ページを開く）— 5〜10 ステップ、約 70–135K トークン、約 $0.04–0.08
• ミディアム（ログイン、ログ確認、出力のダウンロード）— 15〜25 ステップ、約 205–340K トークン、約 $0.12–0.21
• 複雑（GitHub の課題 3 つの整理）— 25〜30 ステップ、約 340–410K トークン、約 $0.21–0.25

上記のトークン数は、1 回の実行あたりの技術的な上限であり、月間の利用枠ではありません。月間枠はクレジットでカウントされ、無料プランの月 300 は、チャット、コード、そしていくつかの自動化を組み合わせても十分にカバーできます。

デスクトップセッションのホワイトリスト

`ホワイトリスト`とは、Ava がデスクトップを操作している間に触れてよいとあなたが許可したアプリとウェブサイトのリストのことです。このページでは、その許可を与える方法と、なぜ毎回リセットされるのかを説明しています。簡単に言うと：彼女はあなたが許可した場所でのみ行動でき、新しい場所に行く前には必ず聞いてきます。

デスクトップセッションの開始時、Ava はどこで行動できるか尋ねてきます。簡単な英語で構いません：「Gmail、Cursor、Azure ポータル」。彼女はそれを読み取り、あなたに一致を確認します（「Gmail ウェブ、Cursor アプリ、portal.azure.com」）。

どのように管理するか

見るだけのアクション——スクリーンショットの取得、画面上のボタンやフィールドのリストを読むこと（「UIA ツリー」、Windows が持つウィンドウ内のマッピング）——はどこでも許可されています。なぜなら、アプリをホワイトリストに追加するかどうかを決めるために画面にあるものを見る必要があるからです。何かを変更するものはリスト外ではブロックされ、Ava が一時停止して追加するか尋ねます。

意図的にセッション限定

ホワイトリストはセッション間で継続しません。「このアプリを記憶する」というオプションはありません。新しいトラジェクトリは常に新しいスコープから始まります。あえて不便にしています——再承認を忘れるのはバグではなく、機能なのです。

実行中の追加

実行中、ヘッダーからアプリを追加できます：「+ アプリを許可」を開くと小さな入力欄が表示されます。「追加」をタップすると、新しいアプリはそのセッション残りで有効になります。

ナレッジパック

簡単に言うと：Ava に自分自身のドキュメントが入ったフォルダーを手渡すと、彼女はそれらを読んで質問にお答えします。「ナレッジパック」とはまさにそのファイルの束のこと——彼女が参照してもよい参考資料です。

参考資料（仕様書、RFC、議事録、API ドキュメント）のディレクトリをナレッジパックにドロップしてください。会話がそのトピックに触れたとき、Ava は関連する部分をコンテキストに引き出せます。

パックはローカルでインデックス化されます。検索は意味的（セマンティック）です——Ava はファイル名ではなく意味で正しいドキュメントを見つけます。（「意味的」とは、ドキュメントの内容に基づいて一致させることを意味するため、正確な言葉やファイル名を覚える必要がないということです。）パックはチームと共有することも、プライベートに保つこともできます。

Creative Studio

簡単に言うと：作りたいアイコン、画像、動画、ボイスオーバーを説明するだけで、Ava が一緒にデザインしてくれます — デザインソフトも不要、プロンプト操作も不要です。

Creative Studio はガイド付きのデザイン作業スペースです。3 つのパネルで開きます — 左側にデザインタイプ、中央にキャンバス、右側に作業中の作品のコントロールがあります。「生成」ボタンを探す必要はありません：画面下部のデザインアーキテクト（デザイナー役の Ava）に話しかけると、彼女がツールを動かしてくれ、いくつかの明確なコントロールで磨き上げることができます。

今日作れるもの

• アイコン — 主力機能。実際のラインアイコン形状から始めます（1,990 種内蔵）、素材とブランドカラーを選び、Ava がスタイルを変更してクリーンな透明 PNG に切り出します。
• 画像 — フリーフォーム、説明から。正方形、横長、縦長（1:1、16:9、9:16）。
• 動画 — プロンプトからの短い AI クリップ。5 秒または 10 秒、最大 1080p、横長、縦長、または正方形。
• ボイスオーバー — テキストから自然な音声に変換し、波形プレビューも表示されます。10 言語に対応した 11 種類のボイスがあります。
• ブランドキット — あなたのカラーパレットを手元に置き、すべてのアセットがブランドに沿うようにします。

より多くのデザインタイプ — アプリのアイコン、ロゴ、バッジ、アバター、バナー、ヒーロー画像やソーシャル画像、イラスト、パターン、そしてゲーム開発向けのフルセット — が追加されつつあり、左側のレールでは「近日」と表示されます。

何で動いているか

アイコンと画像は Qwen-Image で生成され、動画は Wan、音声ナレーションは Qwen3-TTS で作られます。あなたが作ったものはすべてライブラリに保管され、作成した種類ごとに分類されます。

Creative Studio は有料オプションではなく、すべてのプラン（Free を含む）で利用可能です。生成には通常のクレジットプールから引かれ、Ava の他の機能と同じ数値です。

ヘルスケア＆栄養

簡単に言うと：Ava に目標と利用可能なものを伝えれば、実際に実行できるトレーニングと食事計画を立ててくれます。その後、日ごとにその計画を守るお手伝いをします。

ヘルスケア＆栄養はダッシュボード内の集中的なエリアです。Ava はあなたについていくつか尋ねます — 目標、利用可能な機材、制限事項など — その後、実際の実践エクササイズとレシピのライブラリを基に、あなたに合った計画を作成します。計画はフィットネス、食事、あるいはその両方を含めることができます。

仕組み

1. Ava はシンプルな操作で目標と設定について聞いてきます — 目標カード、機材選択、数値入力ボックスなど — 大量の質問リストではありません。
2. カタログから複数週分の計画を立ててくれます。持っているもので実際に実行できる内容です。
3. 日ごとにそれを実行してください。Ava は状況に合わせて、特定の日付の内容を補充したり調整したりできます。

すべての内容は、あなた自身のマシンにあるローカルの計画ライブラリに保存されます。レシピとエクササイズのカタログは、実際に厳選されたコンテンツであり、その場で適当に作られたものではありません。

プランを実際の食材に

プランが役立つのは、実際に買い物ができるときだけです。この買い物リストは週全体の材料を集め、お店のレイアウトに合わせて整理します（野菜、肉・魚、乳製品、パン、調味料など）。そうすれば、店内を二度歩き回る必要がありません。

• 表現が異なる同じ食材は統合されます。「玉ねぎ」と「刻んだ玉ねぎ」は一行にまとめられ、どの料理に使われるかもわかります。
• 分量はご家庭の人数に合わせて調整されます。この設定は買い物リストのみで適用され、プラン自体は「1 人分」のままです。そのため、4 人家族でも毎日のカロリーを自動的に 4 倍することはありません。
• 単位は読みやすいように選ばれています。例えば「半キロのご飯」は「500g」と表示されます。
• 計測されていない項目もそのまま残ります。「お好みで塩」のように量っていないものでも、単に無視されることはありません。
• 買い物する料理を選択できます。最初はすべて選択されていますが、すでにあるものはオフにしてください。これにより、「すでに手持ちのもの」と「購入済みのもの」を区別できます（チェックボックスだけでは表現できない違いです）。
• リストで対応できない項目がある場合は、その旨と理由を明確に伝えます。まるで完璧に見えるのに、実は足りないという事態を防ぎます。

実際の調理スケジュール

準備計画では、週のどのタイミングに作業がかかるかがわかります。手を動かす時間と放置する時間を分けています。4 時間も鍋の前には立てませんし、調理時間は最大 1 時間までしかカウントしないからです。だから、長時間煮込む料理は実際より負担が軽く表示されます。これが本当の労力です。

• 最も忙しい日がどれか一目でわかり、大変な火曜日に直面する前に知ることができます。
• 前夜に仕込んでおく必要があるもの（オーツミールなど）を示します。本当に夕食の予定が変わる場合のみです。90 分間の生地休ませなどは、わざわざ気にする必要はありません。
• 一度作れば十分なものも提案します。同じ料理を週に二度作るより、作り置きできる日を含めて「月曜日に作って水曜日までカバー」とすれば、1 時間が節約できます。
• もし Ava に調理可能時間を伝えていれば、超過する日は警告されます。伝えていなければ、特に重いとは呼びません。指定されていない制限は「不明」であって「ゼロ」ではないからです。

実行状況の記録

プランと現実生活をつなぎます。過去の日付を開き、各項目にチェックを入れます（完了、スキップ、代替品を食べた、など）。横にはメモ欄があり、「Ava がこれを読みます」とはっきり書かれています。自分が読まれているとわかると人は書き方が変わるからです。後から気づかれると、まるで監視されているようで気を使ってしまいます。

空白は「未記録」を意味します。「スキップ」ではありません。これは異なる事実であり、Ava はそれぞれを区別して扱います。空欄の日を「失敗」として認識することはありません。

トレーニング記録には詳細なログもあります。セット、回数、重量はプランに基づいて自動入力されます。通常は数回のタップだけで済み、変更点だけをタイプすればいいのです。スキップも記録も同等に簡単に行えるよう設計しています。もしスキップが隠されていたら、人は行を空白にしてしまい、区別が失われてしまいます。

あなたの記録が、Ava の「実際のトレーニングや食事」に関する記憶を育てます。そのため、来週のアドバイスは、Ava が作ったプランではなく、実際のあなたに基づいて作成されます。

繰り返しと進歩

1 日単位または丸ごと 1 週間単位でコピーできます。必要に応じて強度を上げ（例：レップスを 1 つ増やす、セットを 1 つ増やす）、コピー版のみが強化されます。元の内容は書き換わらないため、既に達成した成果が上書きされることはありません。

ウォームアップ、クールダウン、モビリティ、完全な回復日はそのままにされます。回復日にセットを追加しても進歩にはなりません。それは意図せずセッション化してしまうことで、その日が防ごうとしていることそのものです。負荷も自動的に増加しません。重量は自由記述なので、「自重」に対してパーセンテージを加えるのはナンセンスです。

1 日のサポート依頼

木曜日で行き詰まりましたか？Ava に追加、フィニッシャーの追加、簡単化、タンパク質増加、短縮などを提案させましょう。Ava が提案し、現在のプランと並べて表示するので、変更点を事前に確認できます。承認するまで何も保存されません。

すべての情報は、ご自身の端末にあるローカルプランライブラリに保存されます。レシピやエクササイズのカタログは、実際に厳選された本物のコンテンツです。レシピには 3 つの難易度と完全な手順が記載されており、エクササイズにはテクニックガイド、よくあるミス、そしてデモ用の画像が含まれています。これらすべては、その場で即興的に作られたものではありません。

学習

簡単に言うと：Ava に何かを教えてほしいと言えば、レッスン、解説例、クイズを含む適切なコースを作成し、自分のペースで進めてくれます。

学習はダッシュボード内の集中的なエリアです。Ava は学びたい内容のカリキュラムを計画し、レッスンごとに指導し、クイズで理解度を確認します。また、学習進捗を追跡して、中断した場所から続けられるようにします。

仕組み

1. テーマを Ava に伝えてください — 「ゼロから Python を教えて」、あるいは「データベースの理解を手伝って」など。
2. 構造化されたコースを作成します：モジュール、レッスン、チェックポイントです。
3. 一度に一つのレッスンを学びます。彼女は説明し、例を示し、定着させるためにクイズを出します。
4. 進捗は保存されるため、次のセッションは止まった場所から続きます。

裏側ではこれはティーチモードです — カリキュラムアーキテクト、コンテンツライター、ファクトチェッカー、クイズマスター、チューターという専門家チームを、Ava があなたのためにコーディネートしています。

Office Suite

レポート、メール、ドキュメントの作成にお困りですか？Ava が下書きを作成し、実際に使える Word、Excel、PDF ファイルをお渡しします。いつものように開いて編集可能です。

レポート、メール、ドキュメント — 下書き作成、書式設定、ネイティブ形式でのエクスポート（.docx は Word、.xlsx は Excel、.pdf は PDF）。

• report_generate — タスク、ジャーナル、記憶、プロジェクトの状態から情報を引き出した構造化された .docx ファイル。
• email_draft — トーンを調整したメールを .docx ファイルとして出力。
• document_manage — Word、Excel、PDF、CSV、Markdown に対応した作成、閲覧、編集、エクスポート機能。

Ava が代わりに文章を書く際に便利です。ステータスレポート、キックオフ資料、クライアントへの連絡など。.docx ファイルはプロジェクト内に保存され、そのまま手を加えることができます。

ライブラリ

簡単に言うと、あなたが大切にするものをしまう、ひとつの棚のようなものです。読んでいる論文、作成したアセット、書き上げたドキュメントなど、すべてがここにまとまるので、大切なものがどこかへ消えてしまう心配はありません。

ライブラリは、3 つのタブで構成される、見やすいダッシュボードです。

• Papers — 保存した学術論文。arXiv、OpenAlex、Crossref から取得しており、全文をその場で読むことができます。
• Assets — Creative Studio で作成したすべてのもの。作成時に使ったデザインタイプ（Open Canvas、Web / App、Game Dev）と同じく分類されています。グループやタイプで絞り込みができ、各タイプごとに保有数が表示されます。
• ドキュメント — Word、Excel、PDF、そして Ava があなたと一緒に作成したその他のファイル。種類ごとにフィルタリングできます。

上部にはストレージバーがあり、ローカルファイルがどのくらい容量を使っているか示します。「保存フォルダを開く」ボタンを押すと、ディスク上のフォルダが直接開きます。これはローカルファースト設計なので、ライブラリはあくまであなたのマシン上にあるものを読み取ります。

デイリーブリーフィング

簡単に言うと：毎朝、「前回の続きはどこでしたか」という短いメモが届きます。すべてを読み返す必要なく、すぐに作業を再開できます。

朝のサマリー：昨日の記録、未完了のタスク、プロジェクトの状態、そして Ava が設定したリマインダー。オプション機能です — 設定で有効にできます。

このブリーフィングは記憶を活用して、必要な文脈を提示します（"last time you worked on the auth flow, you noted you wanted to revisit the refresh token strategy"）。ニュースフィードではなく、要点をまとめた再確認です。

ワークフロー

わかりやすく言うと：Ava に繰り返す作業を教え、名前をつければ、いつでも実行できます。「ワークフロー」とは、保存されたその手順のことです。Ava があなたのために繰り返す一連のステップです。

繰り返し行う一連のステップを保存しましょう。PR のレビュー → テストの実行 → リリースノートの作成 → メールの下書きなど。ワークフローとは、異なる入力でも再生できる再利用可能な計画です。

ワークフローはプロジェクトごとに、プロジェクト内の .ava/workflows/ フォルダに保存されます。チームと共有するには、ディレクトリをコミット（共有プロジェクトに保存）してください。そうすればチームメイトも受け取れます。

イベントと通知

わかりやすく言うと：Ava が作業している間、彼女が何をしているかの整理されたステップバイステップのリストが表示され、長いジョブが終わると通知が来るので、離席しても安心です。

Ava が実行中は、テキストの壁ではなく構造化された更新情報が見えます。各ツール呼び出し、各ペルソナ引き継ぎ、各ストリーミングデルタは UI 内の個別イベントです。詳細は展開可能、概要は折りたたみ可能です。

バックグラウンド実行では完了時に OS レベルの通知が発信されます。長いビルドから離れていても、Ava が終わったら知らせてくれます。

パーソンナリティデザイナー

わかりやすく言うと：Ava の話し方を調整できます。チャット好きか簡潔か、フォーマルかカジュアルか、ジョーク多めか少なめか — あなた好みの声になるように設定します。

Ava の話し方を形作ります。トーン、エネルギー、発言量、形式ばり具合、ユーモア。スライダーとプリセットで設定可能 — 簡潔なエンジニア、温かいメンター、ドライな同僚、または独自のブレンド。

パーソナリティは表現に影響しますが、能力には影響しません。同じツールを実行し、同じ権限ルールに従います。名前は Ava に固定されています — これは変更できません。

デスクトップ操作の自動化

簡単に言うと：Ava がマウスやキーボードを代わりに操作してタスクをこなしてくれます — アプリを開いたり、ボタンを押したり、フォームに入力したり。あなたは見守りつつ、重要な決定だけを手動で承認できます。

Ava の新モード「@@」です。デスクトップを観察し、何をするべきかを判断して UI 自動化を駆動します（画面上のアプリをあなたのために操作）。クラウドブラウザではなく、実際のマシン上で実際のアカウント情報を使って動作します。リリース後はすべてのプランで利用可能です。

他の製品との違い

ほとんどのデスクトップ自動化ツールは、言われた通りにクリックするだけのものです。Ava はまず計画を立てます：手順を見せ、あなたの許可を待ち、二度と元に戻せない操作の前には、毎回必ずもう一度確認します — 決してキャッシュしません。

さらに、Ava はセッションを超えてアプリの操作方法も記憶しています。他のエージェントは毎回最初から学び直しますが、Ava の記憶機能は使うほどにその価値を高めていきます。

仕組みについて

各ステップでは 5 つの役割が連携します：Scout が状況を観察し、Planner が次の行動を決め、Actor が実行し、Verifier が確認し、Narrator が結果を伝えます。サイドカーが最も安価で確実な手段を選びます — ネイティブアプリなら UIA、ブラウザなら Playwright、それ以外に適した構造がない場合は OmniParser のビジョン機能を使います。

安全性の概念、基盤の階層、緊急停止スイッチ、セッションホワイトリストモデルについては、コンセプトページをご覧ください。

よくあるエラー

ほとんどのエラーには、短い特定の理由があります。ここではよくあるものとその対処法をご紹介します。言葉が技術的だと感じても心配しないでください。以下に実際に何が見えているか、そしてどうすべきかを具体的に説明しています。

モデルが反応しない

表示される内容：Ava が沈黙し、返信してきません。

チャットヘッダーのステータスインジケーターを確認してください。「connecting」と表示されている場合、プロバイダー（Ava が話している AI サービス）は接続できているが遅れています — 30 秒ほどお待ちください。「unavailable」と表示されている場合、Ava は自動的に次のモデルにフォールバックしました（バックアップモデルに切り替わりました）。何も表示されない場合は、設定で API キーを確認し、接続をテストしてください。（API キーとは、Ava が有料 AI サービスを利用するための秘密のパスワードです。）

ツールの呼び出しに失敗

表示される内容：Ava の手順の一つ（「ツール呼び出し」— ファイルを読む、コマンドを実行するなど）が完了する代わりに赤いエラーを表示します。

失敗したツール呼び出しをクリックしてエラーを確認してください。一般的な原因：プロジェクトフォルダ外のファイルに触れようとした（これはあなたの安全のために意図的にブロックされています。このガードは「パストラバーサル」保護と呼ばれます — あなたが作業しているフォルダの外に彼女が行き渡るのを防ぎます）、別のフォルダで実行が必要なコマンド、または Ava が最後に確認してから移動されたファイルなどです。何が起きたか教えてあげてください — 修正して再試行します。

メモリが思い出せない

表示される内容：Ava が、あなたが確実に覚えていてほしいものを発見できません。

メモリは正確な単語ではなく意味に基づいて機能します（これが「セマンティック」の意味です）。なので、「認証について何を決めた？」と聞く方が、「私の認証決定を見つけて」と探すよりも効果的です。メモリが確かにあるのに表示されない場合は、メモリブラウザを開いて検索してください — もしそこにないなら、最初から保存されていなかったということです。

サインインのループ

表示される内容：サインインしましたが、Ava が何度も再度サインインを求めてきます — 決して進めないループ状態です。

解決策は保存されたサインイン情報をクリアして新しく始めることです：拡張機能ではコマンドパレットから「Ava: Sign Out」を実行し、IDE では 設定 → アカウント → サインアウト を使い、CLI では `~/.ava/auth.json` ファイルを削除してください（ホームディレクトリ内の `.ava` フォルダにある小さなサインインファイルです）。その後、再度サインインしてください。

トークン切れ

表示される内容：今月の無料利用枠を使い切ったというメッセージが表示されます。（「トークン」は AI の使用量を測る単位です — 「exhausted」は単に今月の無料枠を使い果たしたという意味です。）

無料プランの月間予算は毎月 1 日にリセットされます。それまでは、動作を続けるために BYOK プロバイダー（自分の API キーを使用）に切り替えてください。アカウントは有効のままです — 無料のプラットフォーム管理リクエストのみが一時停止されます。

ログの場所

「ログ」とは、コンピューターが何か起きたときに記録する日記のようなものです — 何か壊れたときや、あなた（またはサポート）が詳細を確認する必要がある場合に役立ちます。

生の状況を知りたい場合 — どのツールが呼び出されたか、どんな情報を受け取ったか、AI サービスが何を返したか — ログは、コンピューター上のフォルダにあるプレーンテキストファイルです。場所は `~/.ava/logs/` です（ホームディレクトリ内の `.ava` フォルダの中に `logs` フォルダが入っています）。

• `~/.ava/logs/session-<date>.log` — ツール呼び出し、ストリーミングされた応答、エラーを含むセッションごとのトランスクリプト。
• `~/.ava/logs/extension.log` — VS Code 拡張機能ホストログ。アクティベーションの失敗、パネルエラー。
• `~/.ava/logs/ide.log` — デスクトップ IDE ログ。サイドカープロセスのメッセージ、Rust パニック。
• `~/.ava/logs/cli.log` — CLI REPL ログ。

拡張機能では、コマンドパレットの「Ava: Show Logs」で関連するログがエディタタブで開きます。IDE では、設定 → 診断 に「ログを開く」ボタンがあります。CLI は `ava logs --follow` コマンドで自身のログをフォローできます。

サポートへの問い合わせ

簡単に言うと：なにかおかしくなって、上の方法でも直らない場合は、私たちにお知らせください。一番簡単なのは、Ava に頼むことです。

よくあるエラーリストにない問題の場合は、サポートチケットを発行してください（サポートチームへのお手伝い依頼です）。Ava 内（フォーム入力不要）か、Web サイトから行えます。

Ava 内から

Ava に頼んでください。「Ava、これについてサポートチケットを起こしてくれますか？」と。Ava は support_request を実行し、関連するセッションの状況（パスワードなどの機密情報は隠した状態）を添付して送信します。これが一番速い道です。

Web サイトから

avasupernova.com/support にアクセスしてください。カテゴリ（バグ、機能、アカウント、セキュリティ、全般）を選んで、何が起きたかを説明してください。1 営業日以内に返信いたします。

記載すべき内容

• 何をしようとしていたか。
• 実際にどうなったか。
• どの環境（拡張機能、IDE、CLI）と、どのバージョンでしょうか。
• エラーメッセージやログの一部など。その際、認証情報は事前に伏字にしてください。

セキュリティ上の問題について

簡単に言うと：Ava の抜け穴や悪用の可能性（「脆弱性」— セキュリティ上の弱点）を見つけたら、だれかに悪用される前に直すため、まず私たちだけに知らせてください。このページがその方法です。

脆弱性を見つけましたか？ありがとうございます。私たちはすべての報告を真摯に受け止め、問題が公に発表される前の段階で、あなたと一緒に修正に取り組みます。

報告方法

1. security@ava-supernova.com にメールを送ってください。内容は説明、再現手順、希望する公開までの期間などです。
2. また、「セキュリティ」カテゴリでサポートチケットを発行してください——処理順は同じです。
3. 24 時間以内に返信いたします。

私たちの約束事

• 調整された公開 — 何も公表する前に、あなたと日程を合わせます。標準は 90 日間です。
• 謝辞 — 修正に関するノートに記載されます（匿名を希望しない限り）。
• 法的な報復はありません — 善意での調査は大歓迎です。弁護士を派遣することはありません。