🔑 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 モデルはレガシーとして残しています。
- Anthropic Console にアクセスします。
- アカウントを作成またはログインします。
- API Keys セクションへ進み、Create Key をクリックします。
- キー名に
AMBA Desktopと入力し、発行されたキー文字列（sk-ant-...）をコピーします。
Claude in Amazon Bedrock（AWS をご利用の企業におすすめ）
すでに AWS をお使いの場合は、Claude in Amazon Bedrock 経由で Claude を利用できます。利用料金はお客様自身の AWS アカウントに請求・管理され、AMBA は bedrock-mantle.<region>.api.aws にリクエストを送信します（「このデバイスから送信されたデータ」パネルに表示されます）。このエンドポイントがお客様のアカウントに Claude モデルを提供していない場合、AMBA はそのモデルについて bedrock-runtime.<region>.amazonaws.com（Bedrock プレイグラウンドと同じ InvokeModel）を使います。プロバイダーの Claude の呼び出し先 設定でどちらかに固定することもできます。
- AWS コンソールで、利用するリージョン（例:
us-east-1）の Amazon Bedrock → Model access を開き、使用する Claude モデル（Claude Opus 5.5、Claude Sonnet 5.5、Claude Haiku 5.5）を有効にします。 - 認証情報を作成します: Bedrock API キー（Amazon Bedrock → API keys。短期キーは 12 時間以内に失効）、または
bedrock-mantle:CreateInference（InvokeModel 経由のモデルにはbedrock:InvokeModelとbedrock:InvokeModelWithResponseStreamも）を呼び出せる IAM アクセスキー。 - AMBA で 設定 → モデル → プロバイダーを追加 → AWS Bedrock を開き、キーとリージョンを入力して、(Claude in Amazon Bedrock) と表示されたモデルを選びます。
これらのモデルは Anthropic キーでの Claude と同じように動作します（思考の要約、effort、プロンプトキャッシュ、ネイティブのツール呼び出し）。Bedrock では提供されていない 2 つの機能、拒否されたリクエストを別モデルでサーバー側で再試行する機能と strict ツールスキーマは、AMBA も使用しません。us.anthropic.claude-sonnet-4-5-20250929-v1:0 のような従来の Claude モデル ID は、これまでどおり Bedrock Converse API を使用します。Claude 以外の Bedrock モデル（Nova、Llama、Mistral など）は提供を終了しました。更新後の初回起動時にそのプロファイルは削除されます。実行が「model access」で失敗した場合は、Amazon Bedrock → Model access でそのモデルを有効にしてから再試行してください。
2. OpenAI
最適用途：一般的なエグゼクティブ業務、標準的なビジネス文書のドラフト作成。
- OpenAI Platform にアクセスします。
- Settings > API Keys に移動します。
- Create new secret key をクリックして名前を付け、キー（
sk-proj-...）をコピーします。
3. Google Gemini
最適用途：超高速なマルチモーダル処理および大容量ドキュメントの一括解析。
- Google AI Studio にアクセスします。
- Get API key をクリックして新規キーを発行します。
Google Cloud — Gemini Enterprise Agent Platform(旧称 Vertex AI)
Google Cloud 経由で Gemini を利用する企業向けです。Google は 2026 年 4 月に Vertex AI を Gemini Enterprise Agent Platform に改称しました。API ホストは引き続き aiplatform.googleapis.com です。AMBA はサービスアカウントの JSON キーで認証し、キーは OS のキーチェーンにのみ保存します。
- 課金が有効なプロジェクトを選択または作成します。
- Agent Platform API を有効化します(
aiplatform.googleapis.com)。 - IAM と管理 → サービス アカウント → サービス アカウントを作成 に進み、ロール Agent Platform User(
roles/aiplatform.user)を付与します。 - アカウントを開き、鍵 → 鍵を追加 → 新しい鍵を作成 → JSON を選びます。ファイルは一度しかダウンロードできないので、安全に保管してください。
- *「Key creation is not allowed on this service account」*と表示された場合は、組織がキーの作成をブロックしています(2024 年 5 月以降に作成された組織の既定)。組織の管理者に、このプロジェクトを Disable service account key creation ポリシーの対象外にするよう依頼してください(Google のガイド)。
- AMBA で 設定 → モデル → プロバイダーを追加 → Google Cloud を開きます。ダイアログにも同じ手順があり、各手順のボタンで Console のページを開けます。JSON ファイル全体を貼り付けると、AMBA がすぐに確認し(API キー、OAuth クライアント JSON、途中で切れた貼り付けはそれと分かるように表示)、プロジェクト ID を入力してサービスアカウントを表示します。
- 処理を米国(
us)や EU(eu)、特定のリージョン内に保つ必要がなければ、ロケーションは global のままにします。接続をテスト を押すと、AMBA がトークンを取得して短いリクエストを送り、API が無効、ロールや課金の不足、そのロケーションでモデルが提供されていない場合はそう表示します。 - 保存したら、プロバイダーカードで 取得 を押して現在の Gemini モデル(Gemini 4 Argon、3.8 Flash、3.5 Flash、3.5 Flash-Lite、3.1 Pro preview)を表示します。ほかのモデル ID は手動で追加できます。
⚙️ AMBAへのキー設定手順
Claude を接続する最も簡単な方法は、サイドバーの セットアップウィザード です。Anthropic API または Amazon Bedrock を選び、キー（Bedrock の場合は AWS リージョンも）を貼り付けます。Claude Opus 5.5 がデフォルトのモデルになります。その他のプロバイダーは設定で追加します：
- お使いのPCで AMBA を起動します。
- 左側のナビゲーションメニューから ⚙️ Settings > Model Settings（モデル設定） をクリックします。
- 次の手順で設定します：
- ステップ1：主要モデル（Primary Model）: メインの推論モデル（例: Claude Opus 5.5 や GPT-4o）を選択し、APIキーを入力します。
- ステップ2：フォールバック戦略（Fallback）: レート制限や障害発生時に備えたバックアップモデルを設定します。
- Web検索（任意）: Web検索 セクションで Tavily または Brave Search のキーを入力すると、許可されたプロジェクトでエージェントがインターネットを検索できます。AMBAアカウントでWeb検索が有効な場合（設定で確認できます）、キーは不要です。検索はアカウント経由で行われます（1回1クレジット、24時間と30日あたりの検索回数に上限があります）。ご自身のキーを入力した場合は、常にそちらが優先されます。
- Save Key をクリックします。入力欄にキーがキーチェーンに保存済みであることが表示されます。キーチェーンが保持できない場合は理由を示すエラーが表示され、キーは保存されません。
🧭 どのモデルが作業するか
設定 → AIモデル → ステップ 2 で選んだモデルがすべてのデフォルトです。個別の選択はそれより優先され、順序は次のとおりです。
- エージェント — エージェントのチャットで選んだモデル。そのエージェント（最初の「Bot 1」も含む）に保存され、プロジェクトのモデルは変わりません。エージェントはチャット、プロセスのステップ、ステップのテストでそれを使います。一覧の最初の デフォルトに従う（…） でエージェント独自の選択を解除します。
- プロジェクト — プロジェクト設定 → 一般 → AIモデル で選んだモデル。新しいプロジェクトは デフォルトに従う（…） で始まります。
- デフォルト — 設定 → AIモデル → ステップ 2。ここを変えると、独自の選択がないすべてのプロジェクトとエージェントが切り替わります。
何も設定されていなければ、キーが設定された最初のモデルを使います。「一文で作成」と エージェントに依頼 ステップには、モデルとその理由が表示されます：Opus 5.5 (Amazon Bedrock) · デフォルト、· プロジェクト、· エージェント。
以前のバージョンのプロジェクトとエージェントは、それまでのモデルを保ちます。一度にすべてをデフォルトに戻すには、ステップ 2 の すべてのプロジェクトでデフォルトモデルを使う を使います。変更されるプロジェクトとエージェントの数を示してから確認を求めます。