> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ja/settings/connection-settings/ai-provider-settings.md).

# AIプロバイダーの設定

本記事では、AIプロバイダーの機能について説明します。

AIプロバイダーの設定には、**マネージドAIプロバイダー** と **BYOK（Bring Your Own Key）** の 2 つのモードがあります。契約時にいずれか一方のモードを選択して利用します。

BYOK モードを使用すると、組織が保有する AI プロバイダーの API キーを Autify Genesis に登録し、チャット生成やナレッジベース検索などの AI 機能に利用できます。

{% hint style="info" %}
契約後にモードの変更を希望する場合は、弊社担当者またはカスタマーサポートにお問い合わせください。
{% endhint %}

## 前提条件

* AIプロバイダーの認証情報を作成・編集・削除できるのは **組織のオーナー** のみです。管理者・メンバーは設定の参照のみ可能です。
* **BYOK モード** を新規に有効にするには、事前に <support@autify.com> までお問い合わせください。有効化後、本記事の手順に沿ってプロバイダーを管理できるようになります。

## マネージドAIプロバイダー

### プロバイダー制限

組織で利用可能な AI プロバイダーを管理します。各プロバイダーのトグルで個別に有効・無効を切り替えられます。

プロバイダーを無効にすると、そのモデルはワークフローとチャットから除外されます。

<figure><img src="/files/r3Pe2zkxVUqHGEP6XxHm" alt="プロバイダー制限のスクリーンショット"><figcaption><p>プロバイダー制限</p></figcaption></figure>

## BYOK（Bring Your Own Key）モード

### チャットプロバイダーを設定する

チャットプロバイダーとは、チャット生成機能で使用する AI プロバイダーです。AI 機能を利用するには、少なくとも 1 つのチャットプロバイダーを設定して有効にする必要があります。

<figure><img src="/files/olYaGmdbnWRuSL8eU8SQ" alt="チャットプロバイダー設定のスクリーンショット"><figcaption><p>チャットプロバイダー設定</p></figcaption></figure>

1. **チャット設定** セクションで、使用するプロバイダー（OpenAI、Azure OpenAI、Google Gemini）の **設定** をクリックします。
2. 設定ダイアログが開いたら、次の情報を入力します。

| フィールド       | 説明                   |
| ----------- | -------------------- |
| **APIキー**   | プロバイダーから発行された API キー |
| **表示名（任意）** | 管理用の任意の名前            |

{% hint style="info" %}
**Azure OpenAI** を使用する場合は、 **APIキー** に加えて **ベースURL** を入力します（例: `https://my-resource.openai.azure.com/openai/v1`）。API バージョンはベース URL のパスに含まれ、既定で `v1` が使われます。

Azure OpenAI のチャット設定では、 **接続テスト** を実行すると、Genesis が Azure リソース上で利用可能なデプロイを検出し、保存前に一覧表示します。デプロイを 1 つも検出できない場合は保存できません。リソースやリージョンを確認するか、 **デプロイメント名の上書き（任意）** を追加して再テストしてください。

Azure 側のデプロイメント名がモデル ID と異なる場合は、 **デプロイメント名の上書き（任意）** に `モデル=デプロイメント` のカンマ区切りで指定します（例: `gpt-5.2=my-gpt52-deploy, gpt-5.4=my-gpt54-deploy`）。指定しないモデルではモデル ID がそのままデプロイメント名として使われます。

Genesis は、自動チャットタイトル生成、メモリ更新、長いワークフローでのコンテキスト圧縮などのバックグラウンド AI 呼び出しでも、組織で利用可能なモデルを使います。
{% endhint %}

3. **接続テスト** をクリックします。
   * **OpenAI** と **Google Gemini** では、「接続に成功しました」と表示されることを確認します。
   * **Azure OpenAI** のチャット設定では、検出されたデプロイが一覧表示されることを確認します。

{% hint style="warning" %}
接続テストが成功するまで **保存** はクリックできません。必ず先にテストを実行してください。
{% endhint %}

4. テストが成功したら **保存** をクリックします。
5. プロバイダーカードに表示されるトグルをオンにして、プロバイダーを有効にします。

複数のチャットプロバイダーを登録できます。各プロバイダーのトグルで個別に有効・無効を切り替えられます。

### Azure OpenAI のデプロイを再検出する

あとから Azure 側でデプロイを追加・削除した場合は、API キーを再入力せずに保存済みの一覧を更新できます。

1. 設定済みの **Azure OpenAI** チャットプロバイダーカードで **デプロイを再検出** をクリックします。
2. プレビューのダイアログで、検出されたデプロイを確認します。
3. **適用** をクリックして、保存済みのデプロイ一覧を置き換えます。

### 埋め込み用プロバイダーを設定する

埋め込み用プロバイダーとは、ナレッジベースの構築（インデックス）や検索に使用するプロバイダーです。ナレッジベース機能を利用する場合は設定が必要です。

<figure><img src="/files/Y4gkWDPmpa7GJwSGEyc0" alt="埋め込み用プロバイダー設定のスクリーンショット"><figcaption><p>埋め込み用プロバイダー設定</p></figcaption></figure>

1. **埋め込み用設定** セクションで、使用するプロバイダーの **設定** をクリックします。
2. チャットプロバイダーと同様に **APIキー** を入力します。Azure OpenAI を使用する場合は、 **ベースURL** に加えて **デプロイメント名** にも入力します。 **デプロイメント名** には `text-embedding-3-small` モデル（1536 次元）の Azure デプロイメント名を指定します。
3. **接続テスト** を実行し、テストが成功したら **保存** をクリックします。
4. 登録済みのプロバイダーを選択します。クリックするとその場で切り替わり、既存のナレッジベースの再構築が始まります。

{% hint style="warning" %}
埋め込み用プロバイダーを切り替えると、すべてのナレッジベースが再構築されます。完了まで数分かかる場合があります。
{% endhint %}

有効にできる埋め込み用プロバイダーは同時に 1 つのみです。

### Other AI Providers

組織で **Other AI Providers** が利用可能な場合は、同じ設定画面から OpenAI 互換エンドポイントも接続できます。検出されたモデルはチャットやワークフローで利用できます。

1. **Other AI Providers** で **Add provider** をクリックします。
2. 名前、OpenAI 互換の **Base URL**、**API Key** を入力します。
3. **Test Connection** をクリックします。Genesis がそのエンドポイントで利用できるモデルを検出します。
4. 検出されたモデルを確認し、**Save** をクリックします。
5. プロバイダーを有効にすると、そのモデルをチャットやワークフローで使えるようになります。

利用できるモデルがあとから変わった場合は、プロバイダーカードの **Refresh models** で保存済み一覧を更新できます。名前や認証情報を変更する場合は **Edit**、削除する場合は **Remove** を使用します。

### プロバイダーの認証情報を編集する

登録済みのプロバイダーの API キーや表示名を変更する場合は、次の手順で更新します。

1. 変更するプロバイダーカードの **編集** をクリックします。
2. 新しい認証情報を入力し、**接続テスト** を実行します。
3. テストが成功したら **保存** をクリックします。

### プロバイダーの認証情報を取り消す

1. 取り消すプロバイダーカードの **取り消し** をクリックします。
2. 確認ダイアログが表示されたら、内容を確認して **取り消し** をクリックします。

{% hint style="danger" %}
認証情報を取り消すと、その認証情報を使用する機能は即座に停止します。プラットフォームが管理するキーへの自動フォールバックはありません。
{% endhint %}

### トラブルシューティング

#### チャットプロバイダーが設定されていない

チャットプロバイダーが 1 つも有効になっていない場合、設定ページに赤い警告メッセージが表示されます。また、設定ページ以外のページを開こうとするとセットアップダイアログが表示され、操作がブロックされます。

| 状況                                                    | 原因                            | 対処方法                                    |
| ----------------------------------------------------- | ----------------------------- | --------------------------------------- |
| 警告「AI機能を使用するには、少なくとも1つのチャットプロバイダーを設定する必要があります。」が表示される | チャットプロバイダーが未設定、またはすべて無効になっている | チャットプロバイダーを 1 つ以上設定し、トグルをオンにして有効にしてください |
| セットアップダイアログが表示されて操作できない（オーナーの場合）                      | BYOK モードでチャットプロバイダーが未設定       | **AIプロバイダー設定へ** をクリックしてプロバイダーを設定してください  |
| セットアップダイアログが表示されて操作できない（管理者・メンバーの場合）                  | チャットプロバイダーが未設定                | 組織のオーナーに AI プロバイダーの設定を依頼してください          |

#### 接続テストが失敗する

| 状況                                 | 原因                                                  | 対処方法                                                                                     |
| ---------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| 「接続テストに失敗しました」が表示される               | API キーが無効、または期限切れになっている                             | プロバイダーの管理画面で有効な API キーを発行し直し、再入力してください                                                   |
| Azure OpenAI で接続テストが失敗する           | ベース URL（リソース・API バージョン部分）またはデプロイ設定の入力誤り             | Azure ポータルでリソース名、リージョン、デプロイ設定を確認し、ベース URL と必要なデプロイメント名の上書きを入力し直してください                    |
| Azure OpenAI の接続テスト後にデプロイが一覧表示されない | 現在のリソースまたはデプロイ設定では、Genesis が対応するチャット用デプロイを見つけられなかった | リソースとリージョンを確認してください。デプロイ名がモデル ID と異なる場合は **デプロイメント名の上書き（任意）** を追加し、 **接続テスト** を再実行してください |

上記以外にも、ネットワーク設定（プロキシ、ファイアウォール）、IP 制限、各プロバイダーの一時的な障害などにより接続テストが失敗する場合があります。エラーメッセージにプロバイダーからの詳細が表示される場合は、その内容もあわせて確認してください。

#### 埋め込み用プロバイダーが選択されていない

登録済みの埋め込み用プロバイダーが存在するにもかかわらず選択されていない場合、黄色の警告メッセージ「埋め込み用プロバイダーが選択されていません。ナレッジベース機能は動作しません。」が表示されます。いずれかのプロバイダーを選択して有効にしてください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ja/settings/connection-settings/ai-provider-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.