現在、LLM 接続を使用できるのは、ABBYY Advanced Designer を介した Document Skills のみです。接続はテナントレベルで管理され、組織内のすべての Skill Designer が利用できます。
前提条件
- ABBYY Vantage Configuration への管理者アクセス権。
- 選択した LLM プロバイダー の有効なサブスクリプション。
- 各 provider のAPI 認証情報：
- Anthropic - Anthropic アカウントの API key。
- Google AI Studio - Google AI Studio アカウントの API key。
- Microsoft Foundry - API key、完全な エンドポイント URL (
/chat/completionsパスおよび API バージョンを含む) 、Azure にデプロイしたモデル名。 - Mistral AI - Mistral AI アカウントの API key。
- OpenAI - OpenAI アカウントの API key。
LLM 接続を追加する
1
Connections ページを開く
左側のサイドバーで、ADMIN の Configuration (歯車アイコン) をクリックし、Connections をクリックします。
2
プロバイダーを選択する
+ Add Connection をクリックします。Add Connection ダイアログには、Anthropic、Microsoft Foundry、Google AI Studio、Mistral AI、OpenAI の利用可能なプロバイダーが表示されます。
3
一般設定を入力する
接続名とオプションの説明を入力します。
- Name - 接続の一意の名前です。この名前は、Skill Designer が Document Skill で接続を選択する際に表示されるため、
Production ClaudeやMistral AIなど、わかりやすい名前を指定してください。 - Description - 接続の目的や環境に関する任意の説明です。API キーやその他の認証情報は入力しないでください。
4
接続設定を入力する
プロバイダーの認証情報を入力します。必須の field は、選択したプロバイダーによって異なります。プロバイダーごとの field については、プロバイダー別の接続設定を参照してください。
5
接続をテストする
Test をクリックします。Vantage は、入力した認証情報を使用してプロバイダーへの接続を試行します。
6
接続を保存する
テストが成功したら、Add をクリックします。接続が Connections リストに表示され、テナント内のすべての Skill Designer がすぐに利用できるようになります。
この接続を参照する Skill が公開されると、Vantage Web Portal の Skill Catalog → [skill] → Parameters で、この接続が default として設定されます。テナント管理者は、Skill を再公開せずに環境ごとの default を上書きできます。詳細については、Document skill パラメーターを参照してください。
プロバイダー別の接続設定
Anthropic
- Model Name - 使用するAnthropicモデルを指定します。アカウントで利用可能なモデルを選択してください。
- API Key - Anthropic APIキー (
sk-で始まります) 。
Google AI Studio (Gemini)
- Model Name - 使用する Gemini モデル。例:
gemini-2.0-flash。 - API キー - Google AI Studio → Get API key で取得した Google AI Studio の API キー。
Microsoft Foundry
- Model Name - Azure ポータル → Microsoft Foundry リソース → Deployments で確認できる、デプロイしたモデルの名前です。デプロイメント名と完全に一致している必要があります。
- URL - Azure ポータル → Microsoft Foundry リソース → Keys and Endpoint で確認できる Microsoft Foundry のエンドポイントです。デプロイメント パスと API バージョンを含めてください。例:
https://<resource>.cognitiveservices.azure.com/openai/deployments/<model-name>/chat/completions?api-version=2025-01-01-preview。 - API Key - 同じ Keys and Endpoint ページで確認できる Microsoft Foundry の API キーです。
Mistral AI
- Model Name - 使用する Mistral AI モデルを選択します。アカウントでサポートされているモデルを選択してください。
- API Key - Mistral AI の API キー。
OpenAI ChatGPT
- Model Name - 使用するOpenAIモデル (例：
gpt-4) 。 - API Key - OpenAI Platform → API Keys から取得したOpenAI APIキー (
sk-で始まるキー) 。
接続を管理する
接続を編集する
1
接続を選択する
Connections ページで接続を選択し、Edit (鉛筆アイコン) をクリックします。
2
更新してテストする
field を更新し、Test をクリックして接続が引き続き機能することを確認してから、Save をクリックします。
接続をテストする
Connection を削除する
トラブルシューティング
接続テストに失敗する
- 無効な API キー - 余分なスペースを入れずに、キー全体をコピーしていることを確認してください。必要に応じて、プロバイダーのポータルでキーを再生成してください。
- 無効なエンドポイント URL (Microsoft Foundry) - URL が完全で、Azure リソースと一致しており、デプロイメント パスに誤字がないことを確認してください。
- モデル名が正しくない - モデルまたはデプロイが存在し、有効になっていることを確認してください。また、スペルと大文字・小文字が正しいことも確認してください (大文字・小文字は区別されます) 。
- ネットワークの問題 - アウトバウンド HTTPS が許可されており、Vantage インスタンスからプロバイダーに接続できることを確認してください。
- クォータまたは権限の問題 - サブスクリプションが有効であること、レート制限内であること、キーに必要な権限が付与されていることを確認してください。
Test では Connection が機能するが、Skill では失敗する
- Skill Designer ページを更新し、Skill で Connection を選択し直します。
- Skill が公開済みで、ドラフトではないことを確認します。
- Skill のエラーログで具体的なメッセージを確認します。
APIコストが予想より高い
- Connectionを使用しているSkillとその処理量を確認します。
- 単純なタスクには、小型で高速なモデルを使用します。
- 使用状況を監視し、プロバイダーのダッシュボードで予算アラートを設定します。
ベストプラクティス
- 認証情報を安全に管理してください。 API キーを共有したり、説明欄に記載したりしないでください。キーは定期的にローテーションし、各キーには必要最小限の権限のみを付与してください。開発環境用と本番環境用には別々の接続を使用します。
- 接続にはわかりやすい名前を付けてください。
Connection 1ではなく、Production GPT-4やDevelopment Foundryのように、用途や環境がわかる名前を使用してください。説明欄には、環境、ユースケース、所有者を記録してください。 - 接続を定期的に確認してください。 定期的に、また認証情報を変更した後にも接続をテストし、Used in Skills 列を使用して、使用されなくなった接続を見つけて削除してください。
- コストを管理してください。 単純なタスクには小型で高速なモデルを使用し、プロンプトは簡潔に保ち、プロバイダーのダッシュボードで予算アラートを設定してください。