> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタートガイド

> Connect AI Embed is a way for customers to integrate Connect AI live data access capabilities for their end users within their own applications.

Connect AI Embed アカウントにご興味がある場合は、CData セールスまでお問い合わせください。

Connect AI Embed は、2レベルのアカウント構造を使用します：

* **Parent Account**—CData がお客様の組織のために作成します。ISV として、Parent Account を使用して、Connect AI Embed インターフェースまたはAPI を介してSub-Account の作成、表示、モニタリングを含む、Connect AI Embed のデプロイメント全体を管理します。
* **Sub-Account**—お客様の各顧客に対して1つのSub-Account が作成されます。Sub-Account 内で、エンドユーザーはデータソースに接続し、データをクエリできます。付与したアクセス権限により、各エンドユーザーが作成、編集、または削除できる内容が決まります。

Connect AI Embed の **Accounts** ページには、参考用にSub-Account 名、external Id、およびaccount Ids が含まれています。

<Frame>
  <img src="https://mintcdn.com/cdata/HOeYFcOXFWrs5HMW/ja/images/powered_by_cdata_accounts.png?fit=max&auto=format&n=HOeYFcOXFWrs5HMW&q=85&s=7dc9c7ad2a8aebd52ecf818ce542d566" alt="" width="1477" height="429" data-path="ja/images/powered_by_cdata_accounts.png" />
</Frame>

編集アイコンをクリックして、アカウント名またはexternal Id を変更します。
削除アイコンをクリックして、Sub-Account を削除します。

## Connect AI Embed クイックスタート

以下は、Connect AI Embed を設定する概要です。主に5つのステップがあります。

### ステップ1：Parent Account の作成

<Steps>
  <Step>
    CData は、お客様用にParent Account を設定し、アカウント名とaccount Id を含むアカウント情報をお送りします。
  </Step>

  <Step>
    Connect AI Embed のParent Account の管理者は、秘密鍵とそれに対応する公開鍵で構成される [JSON Web Token（JWT）を作成します](/ja/API/Authentication-Embedded)。秘密鍵は、Connect AI Embed と統合される製品のセキュリティ要件に従って保管する必要があります。
  </Step>

  <Step>
    管理者は、管理アカウントを登録するために、Privacy-Enhanced Mail（PEM）形式の公開鍵証明書を提供します。Connect AI のサポートチケットを開くことで公開鍵を登録できます。
  </Step>

  <Step>
    登録されると、Parent Account の管理者はアカウントにサインインできます。利用規約に同意してください。
  </Step>

  <Step>
    Parent Account の管理者がSub-Account を作成および管理します。
  </Step>
</Steps>

### ステップ2：Sub-Account の作成

Parent Account を作成したら、次の2つの方法のいずれかでSub-Account を作成できます：

* **Accounts** ページで **+Add account** をクリックします。Sub-Account の **Account Name** および **External ID** を入力し、**Confirm** をクリックします。

* [Connect AI Embed API](/ja/API/REST-API-Embedded) の [Create Account](/ja/API/Account-API) を使用してSub-Account を作成します。[Parent Account の作成](#step-1:-create-a-parent-account) で作成したJWT と、Sub-Account のExternal ID を指定する必要があります。

### ステップ3：コネクション設定の構成（オプション）

Connect AI Embed では、Sub-Account 全体でコネクション設定を一元的に構成する2つの方法を提供します。

* Connection Overrides：Parent Account レベルでコネクション設定を一度構成し、すべてのSub-Account に自動的にプッシュします。これにより、スケール時のテナントごとのメンテナンスが不要になります。構成手順については、**Settings** ドキュメントの [Sources](/ja/Settings-Embedded#sources) セクションを参照してください。
* Branded OAuth Apps：データソースプロバイダーに独自のOAuth アプリケーションを登録し、お客様の顧客がCData ではなく自社のブランドで認証できるようにします。Sub-Account ユーザーがSalesforce または他のOAuth ソースに接続すると、CData ではなく自社のアプリケーション名が表示されます。構成手順については、**Settings** ドキュメントの [Sources](/ja/Settings-Embedded#sources) セクションを参照してください。

以下に説明する既存のCustom Overrides 機能も、他のコネクションプロパティのオーバーライドのために引き続き利用可能です。

Custom Overrides により、エンドユーザーはCData の認証情報ではなく、自分の組織のOAuth 認証情報でログインできるようになります。コネクションオーバーライドを追加するには、以下の手順に従います：

<Steps>
  <Step>
    **Settings** ページの **Sources** タブで、**+Add Override** をクリックします。
  </Step>

  <Step>
    オーバーライドするデータソースを検索します。**Next** をクリックします。
  </Step>

  <Step>
    オーバーライドする **Setting** を選択します。
  </Step>

  <Step>
    **Override Value** を入力します。
  </Step>

  <Step>
    値を新規コネクションのみに適用するか、すべてのコネクション（新規および既存）に適用するかを選択します。
  </Step>

  <Step>
    **Confirm** をクリックします。
  </Step>
</Steps>

これでエンドユーザーはカスタム認証情報を使用できるようになります。

### ステップ4：コネクションの構成

Sub-Account のエンドユーザーは、Web ページで **Add Connection** をクリックします。バックエンドでは、Web サイトが [Create Connection](/ja/API/Connection-API) を呼び出し、Connect AI Embed のWeb ページへのリダイレクトURL を生成します。エンドユーザーは、Salesforce コネクションなどの特定のタイプのコネクションを構成し、コネクションを保存してテストできます。エンドユーザーが完了すると、Connect AI Embed がコネクションのリストを含むWeb ページへリダイレクトします。詳細については [Connection Flow](/ja/Connection-Flow) を参照してください。

### ステップ5：AI を使用したデータのクエリ

データソースが接続されると、アプリケーションはAI を使用して自然言語でエンドユーザーのデータを操作できます。Connect AI Embed のMCP サーバーは、AI エージェントと顧客の接続されたアカウント（Jira やSalesforce など）を橋渡しします。各Sub-Account のコネクションは分離されており、あるSub-Account のAI ワークフローは他のSub-Account のデータにアクセスできません。サーバーで生成された `connection_ids` クレームを含むJWT が、各リクエストを正しいエンドユーザーにスコープします。詳しくは [MCP](/ja/API/MCP-Embedded) を参照してください。

データをクエリするために、以下のConnect AI ドライバーのいずれかを使用することもできます：

* [ADO.NET](/ja/Clients/ADO.NET-Client-Embedded)
* [ODBC](/ja/Clients/ODBC-Client-Embedded)
* [JDBC](/ja/Clients/JDBC-Client-Embedded)
* [Python](/ja/Clients/Python-Client-Embedded)

さらに、Connect AI Embed はフル機能の [REST API](/ja/API/REST-API-Embedded) を提供します。HTTP リクエストを作成できる任意のREST 互換アプリケーションまたは統合ツールで、データを直接クエリできます。

### ログの表示

Connect AI Embed アカウントのログのリストを表示およびダウンロードするには、[**Logs**](/ja/Logs-Embedded) ページまたは [Log API](/ja/API/Log-API-Embedded) を使用します。