AMBA
English
✓日本語
한국어
Tiếng Việt

日本語

English
한국어
Tiếng Việt

外観

🔑 AIモデルAPIキーの設定 ​

AMBAは、お客様のPC内のローカル文書および計算処理能力と、世界最高峰の商用AIによる戦略的推論を組み合わせます。AMBAを運用するには、対応するAIプロバイダーのAPIキーが少なくとも1つ必要です。

🔒 キーの保存先：OSキーチェーンのみ ​

IMPORTANT

AMBAはAPIキーをOSのキーチェーンにのみ保存します：

  • macOS: macOS Keychain
  • Windows: Windows Credential Manager
  • Linux: D-Bus経由のSecret Service（GNOME Keyring、KWallet 5.97以降、またはSecret Serviceを有効にしたKeePassXC）

平文やデータベースへの代替保存はありません。キーはログに記録されず、発行元のプロバイダーにのみ送信されます。保存後にキーを読み戻し、キーチェーンに実際に保持された場合にのみ成功と表示します。貼り付けたキーは前後の空白が除去され、改行・不可視文字・非ASCII文字を含むキーは拒否されます。

キーリングが動作していないLinux: 保存は「システムキーチェーンを利用できません…」で失敗し、設定 → システム診断 にキーチェーン利用不可と表示されます。GNOME KeyringまたはKWalletをインストール／有効化してAMBAを再起動してください（詳細）。

TIP

macOSで「AMBA wants to use your confidential information stored in … in your keychain」と表示される場合：AMBAはすべてのキーを1つのキーチェーン項目にまとめ、起動中に読み取るのは多くても1回です。常に許可（Always Allow） を選ぶと、以後は表示されません。署名済みのアップデートでもこの選択は保持されます。ご自身でビルドした開発版は、ビルドごとに署名が変わるため、再ビルドのたびに再度確認されます。0.5.11以前に保存したキーは、初めて使われたときにこの1つの項目へ移行されるため、古いキーごとに一度だけ確認されることがあります。

どの項目か、なぜ「許可」だけでは足りないのか：ダイアログには項目名 AMBA – saved API keys and connections（アカウント amba-vault-v1）が表示されます。以前のバージョンで作成された項目は、次にキーを保存するかサインインするまで amba と表示されます。AMBAのすべてのキーと接続を保持する唯一の項目です。許可（Allow） は1回限りなので、次回の起動時やキーの保存・Googleへのサインイン時に再度確認されます。常に許可（Always Allow） を選ぶと恒久的に許可されます。起動中のAMBAは、キーが実際に変わらない限りキーチェーンに再アクセスしません。Google Driveの1時間ごとのサインイン更新はメモリ内だけで行われ、キーチェーンへの書き戻しは行われなくなりました。

WARNING

0.5.9からアップデートする場合：0.5.9へのアップデート後に保存したキーは保持されていません。設定 → AIモデル で再入力してください。0.5.8以前に保存したキーは、初回起動時に自動でキーチェーンへ移行されます。

📋 対応プロバイダーとAPIキーの取得方法 ​

1. Anthropic Claude（強く推奨） ​

最適用途：戦略の統合、多部門にわたるタスク分解、および高度な論理的推論。

推奨モデル: Claude Opus 5.5（AMBA の既定の Claude モデル）、日常の作業を速く進める Claude Sonnet 5.5、軽くて量の多い作業向けの Claude Haiku 5.5。最も難しい作業には Claude Fable 5.1 も選べます。Claude 3.x モデルはレガシーとして残しています。

  1. Anthropic Console にアクセスします。
  2. アカウントを作成またはログインします。
  3. API Keys セクションへ進み、Create Key をクリックします。
  4. キー名に AMBA Desktop と入力し、発行されたキー文字列（sk-ant-...）をコピーします。

Claude in Amazon Bedrock（AWS をご利用の企業におすすめ） ​

すでに AWS をお使いの場合は、Claude in Amazon Bedrock 経由で Claude を利用できます。利用料金はお客様自身の AWS アカウントに請求・管理され、AMBA は bedrock-mantle.<region>.api.aws にリクエストを送信します（「このデバイスから送信されたデータ」パネルに表示されます）。

  1. AWS コンソールで、利用するリージョン（例: us-east-1）の Amazon Bedrock → Model access を開き、使用する Claude モデル（Claude Opus 5.5、Claude Sonnet 5.5、Claude Haiku 5.5）を有効にします。
  2. 認証情報を作成します: Bedrock API キー（Amazon Bedrock → API keys。短期キーは 12 時間以内に失効）、または bedrock-mantle:CreateInference を呼び出せる IAM アクセスキー。
  3. AMBA で 設定 → モデル → プロバイダーを追加 → AWS Bedrock を開き、キーとリージョンを入力して、(Claude in Amazon Bedrock) と表示されたモデルを選びます。

これらのモデルは Anthropic キーでの Claude と同じように動作します（思考の要約、effort、プロンプトキャッシュ、ネイティブのツール呼び出し）。Bedrock では提供されていない 2 つの機能、拒否されたリクエストを別モデルでサーバー側で再試行する機能と strict ツールスキーマは、AMBA も使用しません。us.anthropic.claude-sonnet-4-5-20250929-v1:0 のような従来の Bedrock モデル ID や Claude 以外の Bedrock モデルは、これまでどおり Bedrock Converse API を使用します。実行が「model access」で失敗した場合は、Amazon Bedrock → Model access でそのモデルを有効にしてから再試行してください。

2. OpenAI ​

最適用途：一般的なエグゼクティブ業務、標準的なビジネス文書のドラフト作成。

  1. OpenAI Platform にアクセスします。
  2. Settings > API Keys に移動します。
  3. Create new secret key をクリックして名前を付け、キー（sk-proj-...）をコピーします。

3. Google Gemini ​

最適用途：超高速なマルチモーダル処理および大容量ドキュメントの一括解析。

  1. Google AI Studio にアクセスします。
  2. Get API key をクリックして新規キーを発行します。

4. OpenRouter ​

最適用途：単一のアカウントで数百の最新商用モデルおよびオープンソースモデルへ統合アクセス。

  1. OpenRouter にアクセスします。
  2. Keys に進み、新規キー（sk-or-...）を発行します。

5. TypeSafe AI（Jev — System 1 Decision Engine） ​

最適用途：サブセカンドでの意図判別および最適な思考モード（Research, Plan, Agent）の自動ルーティング。

  1. TypeSafe AI にアクセスします。
  2. Jev 意思決定エンジン用APIキーを取得します。

⚙️ AMBAへのキー設定手順 ​

  1. お使いのPCで AMBA を起動します。
  2. 左側のナビゲーションメニューから ⚙️ Settings > Model Settings（モデル設定） をクリックします。
  3. 3つのステップに沿って設定します：
    • ステップ1：主要モデル（Primary Model）: メインの推論モデル（例: Claude Opus 5.5 や GPT-4o）を選択し、APIキーを入力します。
    • ステップ2：フォールバック戦略（Fallback）: レート制限や障害発生時に備えたバックアップモデルを設定します。
    • ステップ3：高度・実験的ルーティング（Advanced & Experimental Routing）: OpenRouter または TypeSafe AI (Jev) キーを入力し、思考モードの高速自動ルーティングを有効化します。
  4. Save Key をクリックします。入力欄にキーがキーチェーンに保存済みであることが表示されます。キーチェーンが保持できない場合は理由を示すエラーが表示され、キーは保存されません。

🧭 どのモデルが作業するか ​

設定 → AIモデル → ステップ 2 で選んだモデルがすべてのデフォルトです。個別の選択はそれより優先され、順序は次のとおりです。

  1. エージェント — エージェントのチャットで選んだモデル。そのエージェント（最初の「Bot 1」も含む）に保存され、プロジェクトのモデルは変わりません。エージェントはチャット、プロセスのステップ、ステップのテストでそれを使います。一覧の最初の デフォルトに従う（…） でエージェント独自の選択を解除します。
  2. プロジェクト — プロジェクト設定 → 一般 → AIモデル で選んだモデル。新しいプロジェクトは デフォルトに従う（…） で始まります。
  3. デフォルト — 設定 → AIモデル → ステップ 2。ここを変えると、独自の選択がないすべてのプロジェクトとエージェントが切り替わります。

何も設定されていなければ、キーが設定された最初のモデルを使います。「一文で作成」と エージェントに依頼 ステップには、モデルとその理由が表示されます：Opus 5.5 (Amazon Bedrock) · デフォルト、· プロジェクト、· エージェント。

以前のバージョンのプロジェクトとエージェントは、それまでのモデルを保ちます。一度にすべてをデフォルトに戻すには、ステップ 2 の すべてのプロジェクトでデフォルトモデルを使う を使います。変更されるプロジェクトとエージェントの数を示してから確認を求めます。