CData Connect AI 経由で Boomi Agentstudio と Paylocity のデータを統合

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData Connect AI を使用して、Boomi Agentstudio からPaylocity のデータへのセキュアでガバナンスの効いたアクセスを提供し、AI エージェントが統合・自動化ワークフロー内でライブエンタープライズデータに対してアクションを実行できるようにします。

Boomi Agentstudio は、タスクの自動化、統合ワークフローの強化、ビジネスプロセス全体でのインテリジェントな意思決定をサポートする AI エージェントを設計、オーケストレーション、ガバナンスするためのエンタープライズプラットフォームです。CData Connect AI と接続することで、Boomi Agentstudio は標準化された MCP ツールインターフェースを通じて、Paylocity などのライブエンタープライズデータにセキュアにアクセス、クエリ、アクションを実行できます。

CData Connect AI は、エンタープライズデータシステムへのガバナンスが効いたリアルタイムアクセスを提供するマネージド Model Context Protocol（MCP）プラットフォームです。350 以上のデータソースにわたって、カタログ、スキーマ、テーブル、SQL クエリを含む構造化されたメタデータを公開します。Connect AI を使用すると、Boomi Agentstudio は ETL パイプライン、データレプリケーション、カスタム統合コードを必要とせずに、ライブの運用データをエージェントロジックとワークフロー自動化に直接取り込むことができます。

この記事では、Boomi Agentstudio を CData Connect AI MCP エンドポイントに接続し、Paylocity やその他のサポート対象データソースへのアクセスを設定し、エージェント駆動型ワークフロー内からリアルタイムクエリを発行する方法を説明します。

前提条件

ステップ 1：Boomi Agentstudio 用に Paylocity への接続を設定

Boomi Agentstudio が Paylocity にアクセスするには、CData Connect AI で Paylocity への接続を作成します。この接続は Remote MCP Server を介して Boomi に公開されます。

  1. Connect AI にログインし、Sources をクリック、次に + Add Connection をクリック
  2. 利用可能なデータソースから Paylocity を選択
  3. Paylocity に接続するために必要な認証プロパティを入力します。

    Paylocity への接続を確立するには以下を設定します。

    • RSAPublicKey：Paylocity アカウントでRSA 暗号化が有効になっている場合は、Paylocity に関連付けられたRSA キーを設定。

      このプロパティは、Insert およびUpdate ステートメントを実行するために必須です。この機能が無効になっている場合は必須ではありません。

    • UseSandbox：サンドボックスアカウントを使用する場合はTrue に設定。
    • CustomFieldsCategory：Customfields カテゴリに設定。これは、IncludeCustomFields がtrue に設定されている場合は必須です。デフォルト値はPayrollAndHR です。
    • Key：Paylocity の公開鍵で暗号化されたAES 共通鍵（base 64 エンコード）。これはコンテンツを暗号化するためのキーです。

      Paylocity は、RSA 復号化を使用してAES 鍵を復号化します。
      これはオプションのプロパティで、IV の値が指定されていない場合、ドライバーは内部でキーを生成します。

    • IV：コンテンツを暗号化するときに使用するAES IV（base 64 エンコード）。これはオプションのプロパティで、Key の値が指定されていない場合、ドライバーは内部でIV を生成します。

    OAuth

    OAuth を使用してPaylocity で認証する必要があります。OAuth では認証するユーザーにブラウザでPaylocity との通信を要求します。詳しくは、ヘルプドキュメントのOAuth セクションを参照してください。

    Pay Entry API

    Pay Entry API はPaylocity API の他の部分と完全に分離されています。個別のクライアントID とシークレットを使用し、アカウントへのアクセスを許可するにはPaylocity から明示的にリクエストする必要があります。 Pay Entry API を使用すると、個々の従業員の給与情報を自動的に送信できます。 Pay Entry API によって提供されるものの性質が非常に限られているため、CData では個別のスキーマを提供しないことを選択しましたが、UsePayEntryAPI 接続プロパティを介して有効にできます。

    UsePayEntryAPI をtrue に設定する場合は、CreatePayEntryImportBatch、MergePayEntryImportBatch、Input_TimeEntry、およびOAuth ストアドプロシージャのみ利用できることに注意してください。 製品のその他の機能を使用しようとするとエラーが発生します。また、OAuthAccessToken を個別に保存する必要があります。これは、この接続プロパティを使用するときに異なるOAuthSettingsLocation を設定することを意味します。

  4. 「Create & Test」をクリック
  5. 認証が完了したら、Paylocity 接続の Permissions タブを開き、必要に応じてユーザーベースのアクセス許可を設定します。

Personal Access Token（PAT）の生成

Boomi Agentstudio はアカウントのメールアドレスと Personal Access Token（PAT） を使用して Connect AI に認証します。アクセス制御の粒度を維持するために、統合ごとに個別の PAT を作成することをお勧めします。

  1. Connect AI で、右上の 歯車アイコン を選択して Settings を開きます。
  2. Access Tokens で Create PAT を選択します。
  3. トークンの説明的な名前を入力し、Create を選択します。
  4. トークンをコピーして安全に保存します。PAT は作成時にのみ表示されます。

Paylocity 接続と PAT が設定できたので、Boomi Agentstudio は CData Connect AI MCP サーバー経由でPaylocity のデータに接続する準備が整いました。

ステップ 2：CData Connect AI MCP エンドポイントを使用してソースを作成

まず、Boomi Agentstudio 内に新しい MCP データソースを作成します。これにより Boomi と CData Connect AI 間のセキュアな接続が確立され、エージェントが MCP ツールを呼び出してライブエンタープライズデータを操作できるようになります。

Connect AI MCP をソースとして接続するには、以下のプロセスに従います。

  1. Boomi にログインします。
  2. Services を開き、リストから Agentstudio を選択します。
  3. Sources タブに移動し、Create a new source をクリックします。
  4. Agent Designer ウィンドウで Sources タブを開き、ソースタイプとして Model Context Protocol (MCP) を選択します。
  5. Create MCP Source 画面で、以下の Configuration 詳細を入力します。
    • Name: ソースの名前を入力
    • Details: ソースの簡単な説明を追加
    • Transport Type: Streamable HTTP
    • URL: https://mcp.cloud.cdata.com/mcp
    • Authentication: Basic Authentication
    • Username: Connect AI アカウントのユーザー名を入力
    • Password: Connect AI の PAT を入力
  6. Test Connection をクリックします。
  7. 接続が成功したら、Discover Tools をクリックします。Boomi は queryData、getCatalogs、getSchemas、getTables などの CData Connect AI によって公開されているすべての MCP ツールを Tools タブに一覧表示します。
  8. Discover and Select Tools セクションですべてのツールを選択し、Continue をクリックします。
  9. Review セクションで詳細を確認し、Save をクリックします。

Boomi は新しいソースを Sources タブに追加します。

Tools タブをクリックして、CData Connect AI のすべてのツールがリストに表示されていることを確認します。

ステップ 3：新しいエージェントを作成

Paylocity のデータ とやりとりするための新しいエージェントを作成します。エージェントはプロンプトと Connect AI によって公開されたツール間のインターフェースとして機能し、クエリを処理してインテリジェントなレスポンスを返すことができます。

  1. Agents タブに移動し、Create New Agent をクリックします。
  2. Agent Designer ウィンドウで、Agents タブの下にある Blank Template を選択します。
  3. Profile セクションで以下の詳細を入力します。
    • Basic Information: ゴール、エージェント名、エージェント画像を指定
    • Agent Mode: プロンプトへの応答方法に基づいて Conversational または Structured モードを選択し、それに応じてモードを設定
  4. Save and Continue をクリックします。
  5. Tasks セクションで、エージェントが実行するアクションを定義します。
    1. + Add New Task をクリックします。
    2. Description タブでタスク名と説明を入力します。
    3. Instructions タブで + Add New Instruction をクリックし、このタスク内でエージェントがツールを使用する方法を説明します。
    4. Tools タブで + Add New Tool をクリックし、Connect AI によって公開されたツールを選択します。Update Selected Tool をクリックし、Requires Approval と Data Passthrough を有効にして、タスクを保存し、Save and Continue をクリックします。

    注意: すべてのタスクで最大 25 個のツールを追加できます。

  6. Guardrails セクションで、エージェントがセキュアかつ倫理的に動作するためのルール、制限、フィルターを定義します。必要に応じてブロックメッセージ、拒否トピック、ワードフィルター、カスタム正規表現パターンを追加します。Save and Continue をクリックします。
  7. Review セクションですべての詳細を確認し、Deploy をクリックしてエージェントをデプロイします。

エージェントをデプロイしたら、チャットインターフェースでプロンプトに対する正確でコンテキストに沿ったレスポンスを生成するために使用できます。

ステップ 4：エージェントを使用してPaylocity のデータにプロンプトを送信

エージェントを作成してデプロイしたら、自然言語プロンプトを使用してPaylocity のデータとやりとりできます。

Paylocity のデータ にプロンプトを送信するには、以下のステップに従います。

  1. Chat タブに移動し、ドロップダウンリストからエージェントを選択します。
  2. プロンプトを入力します（例: 「Paylocity で利用可能なテーブルはいくつありますか？」）。
  3. エージェントがプロンプトを処理して結果を返します。

CData Connect AI を入手

クラウドアプリケーションから直接 300 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事