• English

AIプロバイダーとの連携

AIプロバイダーとの連携により、音声およびチャットシナリオにおいて、サードパーティのAIプロバイダーが提供する言語モデルを活用することができます。これらのモデルにより、 AIエージェントシナリオブロックが、顧客と目的を持った会話を行い、関連データを抽出してシナリオ変数に格納できるようになり、そのデータはさらなる自動化に使用できます。

各AIプロバイダーは、さまざまな機能を持つ複数の言語モデルを提供しています。以下のAIプロバイダーがサポートされています：

OpenAI

Google Vertex AI

Anthropic Claude AI

カスタム AI ゲートウェイ


	AI連携アカウントの追加方法、および AIエージェントのシナリオブロックをシナリオで活用する方法については、 AIエージェントチュートリアルを参照してください

共通のプロパティ

以下のプロパティは、すべてのAIプロバイダー連携アカウントで利用可能です。

名前

この連携アカウントの一意の名前で、システム内の他の場所でこのアカウントを識別するために使用されます。同じタイプの連携アカウントを複数持つことができるため、意味がわかる名前を使用することをお勧めします。

タイプ

連携アカウントのタイプ（例：OpenAI や Google Vertex）を示す読み取り専用のプロパティです。

構造化出力

このアカウントを使用する「AIエージェント」および「Ask AI」ブロックに対して構造化出力フォーマットを強制するオプションを有効化すると、システムは「求める結果」（AIエージェント）または「抽出するデータ」（Ask AI）の設定に基づいた特定のスキーマ定義をAIモデルに提供します。これにより、AIの応答が有効なJSONであり、期待されるフォーマットに厳密に適合することが保証され、解析不能な応答や非標準の応答を防ぐことで信頼性が向上します。

注：この機能を使用するには、構造化出力をサポートするモデルが必要です。このオプションを有効にする場合は、「接続のテスト」ボタンを使用して、選択済モデルがこの機能をサポートしていることを確認してください。

詳細オプション

[詳細オプション] プロパティを使用して、JSON フォーマットのオブジェクトを入力し、標準の統合設定で明示的に提供されていない API パラメータを設定します。これにより、特定のモデル機能（例：「思考」モード、reasoning_effort）へのアクセス、トークン制限（例：max_completion_tokens）の調整、または統合への変更を待つことなくその他のAPIパラメータの修正が可能になります。このプロパティを変更するには、「システム全体の設定を構成する」権限が必要です。

「詳細オプション」で指定された設定が有効であることを確認するために、必ず「接続のテスト」ボタンを使用してください。

検証および使用に関しては、以下の点にご注意ください：

特定の設定、特に「思考モード」を有効にするものや、「思考バジェット」や「最大トークン数」を増やすものは、モデルの使用コストに大きな影響を与える可能性があります。詳細オプションを変更する前に、その影響を十分に理解しておいてください。

ここで定義された設定は、この連携アカウントが使用されるすべての場所（例：AIエージェントブロック、インテリジェンスエンジン）にグローバルに適用されます。

入力は有効な JSON オブジェクトでなければなりません（例：{"temperature": 0.5, "top_p": 0.9}）。

システムは、JSONの構文および制限されたキーの妥当性を検証します。ただし、パラメータが意味的に正しいか、またはご利用の特定のAIプロバイダーやモデルでサポートされているかについては検証しません。選択済モデルに対してオプションが有効であることを確認するのは、ユーザーの責任となります。

以下のオプションはシステムによって管理されており、「詳細オプション」経由では設定できません。これらのいずれかが「詳細オプション」に含まれている場合、検証に失敗します：model、response_format、responseMimeType 、responseSchema 、または tools。

APIリクエストのペイロードからパラメータを明示的に除外するには、その値をnullに設定してください（例："max_tokens": null）。

オプションの適用順序：
1. ブロック設定：シナリオブロック（具体的には「Temperature」）で明示的に定義されたパラメータが最優先されます。
2. 詳細オプション：ここで定義された有効なオプションは、システムにハードコードされた既定値を上書きします。
3. 統合値：パラメータがブロックまたは詳細オプションで定義されていない場合、連携アカウントで定義された値が使用されます。

プロバイダーごとの詳細：
- OpenAI、Anthropic、カスタム：オプションは、最上位の JSON リクエストペイロードに統合されます。
- Google Vertex AI：オプションは、generationConfig サブ JSON の一部として扱われます。

詳細オプションの例

以下の例は、詳細オプションの設定を変更する一般的な使用例を示しています。ただし、これらの例がすべてのモデルで動作するとは限りません。詳細オプションを設定する前に、対象のモデルおよびAIプロバイダーのAPIドキュメントをご確認ください。

モデルパラメータの除外と調整

モデルが max_tokens を非推奨とし max_completion_tokens を使用するよう変更された場合や、固定の温度設定が必須である場合、古いパラメータを無効化し、新しい要件を設定するようにアカウントを設定できます。

{
"max_tokens": null,
"max_completion_tokens": 1000,
"temperature": 1
}

Vertex AIの「Thinking」機能の無効化

既定で「Thinking」機能が有効になっているGoogle Vertexモデル（例：Gemini-2.5-flash）については、コストやレイテンシを管理するために、予算をゼロに設定することでこの機能を無効にすることができます。

{
"thinkingConfig": {
"thinkingBudget": 0
}
}

トークン制限の引き上げ

初期のディスカバリーが、モデルの既定のトークン制限（例：1000）が低すぎるために失敗した場合は、制限値を増やすことができます。

{
"max_tokens": 8096
}

接続のテスト

クリックして、Bright Pattern Contact Center がその認証情報を使用してAIプロバイダーのアカウントに接続できることを確認してください。

OpenAIのプロパティ

OpenAIアカウントを追加すると、プロパティダイアログが表示されます。OpenAIアカウントのAPIキーを入力し、「モデルを読み込む」ボタンをクリックして、アカウントからアクセス可能なGPTモデルのリストを取得してください。設定が完了すると、AIエージェントのシナリオブロックで、そのアカウントをAIプロバイダーとして選択できるようになります。

APIキー

この連携アカウントで使用する OpenAI API キーです。 OpenAIアカウントの「APIキー」ページからAPIキーを生成できます。

GPTモデル

この連携アカウントで提供するGPTモデルを選択してください。リストが空の場合は、「モデルを読み込む」ボタンをクリックして、モデルのリストを取得してください。モデルの機能や料金については、 OpenAIモデルのドキュメントを参照してください。

モデルを読み込む

このボタンをクリックすると、OpenAIアカウントで利用可能なGPTモデルのリストが更新されます。

Google Vertex AI のプロパティ

Google Vertex AI アカウントを追加すると、プロパティダイアログが表示されます。「プロパティ」で、サービスアカウント用のJSONフォーマットのキーファイルをアップロードし、希望するリージョンを選択して、モデルを選択してください。設定が完了すると、AIエージェントのシナリオブロックで、そのアカウントをAIプロバイダーとして選択できるようになります。なお、連携で使用するサービスアカウントに関連付けられたGoogle Cloud Platformプロジェクトでは、 Vertex AIが有効になっている必要があります。

リージョン

ドロップダウンリストから、Vertex AI インスタンス用のGoogle Cloudリージョンを選択してください。リストには、利用可能なリージョンが自動的に表示されます。

認証情報 JSON

モデルを提供するGoogle CloudサービスアカウントのJSONフォーマットのキーファイルをアップロードしてください。認証情報の取得方法の詳細については、 Vertex AI の FAQ 記事を参照してください。

モデル

この連携アカウントによって提供される、ご希望のVertex AIモデルを選択してください。モデルの機能や料金については、 Google モデルのドキュメントをご参照ください。

Anthropic Claude AI のプロパティ

Anthropic Claude AI アカウントを追加すると、プロパティダイアログが表示されます。お使いの Anthropic 開発者アカウントのAPIキーを入力し、「モデルを読み込む」ボタンをクリックして、アカウントからアクセス可能なClaudeモデルのリストを取得してください。設定が完了すると、 AIエージェントや Ask AI のシナリオブロックなど、関連する機能でこのアカウントをAIプロバイダーとして選択できるようになります。

APIキー

この連携アカウントで使用するAnthropic APIキーです。APIキーの作成および管理は、 Anthropicアカウントコンソールから行うことができます。

モデル

この連携アカウントで提供する Claude モデルを選択してください。リストが空の場合は、「モデルを読み込む」ボタンをクリックして、モデルのリストを取得してください。モデルの機能や料金については、Anthropic のモデルに関するドキュメントをご参照ください。

モデルを読み込む

このボタンをクリックすると、Anthropicアカウントで利用可能なClaudeモデルのリストが更新されます。

カスタム AI ゲートウェイのプロパティ

カスタムAIゲートウェイアカウントを追加すると、プロパティダイアログが表示されます。このアカウントタイプでは、 OpenAI チャットCompletions APIエンドポイントと互換性のあるAPIメソッドを提供しているAIプロバイダーであれば、どのようなものでも連携できます。設定が完了すると、 AIエージェントや Ask AI のシナリオブロックなど、関連する機能でこのアカウントをAIプロバイダーとして選択できるようになります。

URL

チャット補完用のカスタムAIプロバイダーのAPIエンドポイントへの完全なパス（例：https://api.example.com/v1/chat/completions）。エンドポイントは、 OpenAI チャット補完 API 仕様に準拠している必要があります。プロトコル（http:// または https://）が省略された場合、https:// が使用されます。

API キー

カスタムAIプロバイダーで使用するAPIキーです。

モデル

この連携アカウントが提供する正確なモデルIDを入力してください（例：llama3-70b-8192）。この値は、ご利用のAIプロバイダーによって定義されます。

推奨文献

AI連携の使用に関する詳細については、以下をご参照ください：

AIエージェントのシナリオブロック

シナリオでのAIエージェントの使用方法

「Ask AI」シナリオブロック< 前へ | 次へ >