Boomi AgentstudioとConnect AI経由でHubDB を統合
Boomi Agentstudio は、タスクの自動化、統合ワークフローの強化、ビジネスプロセス全体でのインテリジェントな意思決定をサポートする AI エージェントを設計、オーケストレーション、ガバナンスするためのエンタープライズプラットフォームです。CData Connect AI と接続することで、Boomi Agentstudio は標準化された MCP ツールインターフェースを通じて、HubDB などのライブエンタープライズデータにセキュアにアクセス、クエリ、アクションを実行できます。
CData Connect AI は、エンタープライズデータシステムへのガバナンスが効いたリアルタイムアクセスを提供するマネージド Model Context Protocol(MCP)プラットフォームです。数百種類のデータソースにわたって、カタログ、スキーマ、テーブル、SQL クエリを含む構造化されたメタデータを公開します。Connect AI を使用すると、Boomi Agentstudio は ETL パイプライン、データレプリケーション、カスタム統合コードを必要とせずに、ライブの運用データをエージェントロジックとワークフロー自動化に直接取り込むことができます。
この記事では、Boomi Agentstudio を CData Connect AI MCP エンドポイントに接続し、HubDB やその他のサポート対象データソースへのアクセスを設定し、エージェント駆動型ワークフロー内からリアルタイムクエリを発行する方法を説明します。
前提条件
- HubDB のアカウント
- CData Connect AI のアカウント
- Boomi Agentstudio のアカウント
ステップ 1:Boomi Agentstudio 用に HubDB への接続を設定
Boomi Agentstudio が HubDB にアクセスするには、CData Connect AI で HubDB への接続を作成します。この接続は Remote MCP Server を介して Boomi に公開されます。
- Connect AI にログインし、Sources をクリック、次に + Add Connection をクリック
- 利用可能なデータソースから HubDB を選択
-
HubDB に接続するために必要な認証プロパティを入力します。
HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。
カスタムOAuthアプリを使用する
すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを確認してください。
アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。
- HubSpotアプリ開発者アカウントにログインします。
- アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
- 開発者アカウントのホームページで、アプリタブをクリックします。
- アプリを作成をクリックします。
- アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
- 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
- デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
- Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
- アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
- 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。
スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。
テーブルにアクセスするには、最低限以下のスコープが必要です:
- hubdb
- oauth
- crm.objects.owners.read
- 変更を保存をクリックします。
- 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
- 「インストールURL(OAuth)」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
- コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
- アプリを接続をクリックします。結果のタブは閉じて構いません。
プライベートアプリを使用する
HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。
以下の手順に従ってプライベートアプリケーショントークンを生成できます:
- HubDBアカウントで、メインナビゲーションバーの設定アイコン(歯車)をクリックします。
- 左サイドバーメニューで、統合 > プライベートアプリに移動します。
- プライベートアプリを作成をクリックします。
- 基本情報タブで、アプリケーションの詳細(名前、ロゴ、説明)を設定します。
- スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
- テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
- アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
- アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
- コピーをクリックして、プライベートアプリケーショントークンをコピーします。
接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。
- HubSpotアプリ開発者アカウントにログインします。
- 「Create & Test」をクリック
- 認証が完了したら、HubDB 接続の Permissions タブを開き、必要に応じてユーザーベースのアクセス許可を設定します。
Personal Access Token(PAT)の生成
Boomi Agentstudio はアカウントのメールアドレスと Personal Access Token(PAT) を使用して Connect AI に認証します。アクセス制御の粒度を維持するために、統合ごとに個別の PAT を作成することをお勧めします。
- Connect AI で、右上の 歯車アイコン を選択して Settings を開きます。
- Access Tokens で Create PAT を選択します。
- トークンの説明的な名前を入力し、Create を選択します。
- トークンをコピーして安全に保存します。PAT は作成時にのみ表示されます。
HubDB 接続と PAT が設定できたので、Boomi Agentstudio は CData Connect AI MCP サーバー経由でHubDB のデータに接続する準備が整いました。
ステップ 2:CData Connect AI MCP エンドポイントを使用してソースを作成
まず、Boomi Agentstudio 内に新しい MCP データソースを作成します。これにより Boomi と CData Connect AI 間のセキュアな接続が確立され、エージェントが MCP ツールを呼び出してライブエンタープライズデータを操作できるようになります。
Connect AI MCP をソースとして接続するには、以下のプロセスに従います。
- Boomi にログインします。
- Services を開き、リストから Agentstudio を選択します。
- Sources タブに移動し、Create a new source をクリックします。
- Agent Designer ウィンドウで Sources タブを開き、ソースタイプとして Model Context Protocol (MCP) を選択します。
- 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 を入力
- Test Connection をクリックします。
- 接続が成功したら、Discover Tools をクリックします。Boomi は queryData、getCatalogs、getSchemas、getTables などの CData Connect AI によって公開されているすべての MCP ツールを Tools タブに一覧表示します。
- Discover and Select Tools セクションですべてのツールを選択し、Continue をクリックします。
- Review セクションで詳細を確認し、Save をクリックします。
Boomi は新しいソースを Sources タブに追加します。
Tools タブをクリックして、CData Connect AI のすべてのツールがリストに表示されていることを確認します。
ステップ 3:新しいエージェントを作成
HubDB のデータ とやりとりするための新しいエージェントを作成します。エージェントはプロンプトと Connect AI によって公開されたツール間のインターフェースとして機能し、クエリを処理してインテリジェントなレスポンスを返すことができます。
- Agents タブに移動し、Create New Agent をクリックします。
- Agent Designer ウィンドウで、Agents タブの下にある Blank Template を選択します。
- Profile セクションで以下の詳細を入力します。
- Basic Information: ゴール、エージェント名、エージェント画像を指定
- Agent Mode: プロンプトへの応答方法に基づいて Conversational または Structured モードを選択し、それに応じてモードを設定
- Save and Continue をクリックします。
- Tasks セクションで、エージェントが実行するアクションを定義します。
- + Add New Task をクリックします。
- Description タブでタスク名と説明を入力します。
- Instructions タブで + Add New Instruction をクリックし、このタスク内でエージェントがツールを使用する方法を説明します。
- Tools タブで + Add New Tool をクリックし、Connect AI によって公開されたツールを選択します。Update Selected Tool をクリックし、Requires Approval と Data Passthrough を有効にして、タスクを保存し、Save and Continue をクリックします。
注意: すべてのタスクで最大 25 個のツールを追加できます。
- + Add New Task をクリックします。
- Guardrails セクションで、エージェントがセキュアかつ倫理的に動作するためのルール、制限、フィルターを定義します。必要に応じてブロックメッセージ、拒否トピック、ワードフィルター、カスタム正規表現パターンを追加します。Save and Continue をクリックします。
- Review セクションですべての詳細を確認し、Deploy をクリックしてエージェントをデプロイします。
エージェントをデプロイしたら、チャットインターフェースでプロンプトに対する正確でコンテキストに沿ったレスポンスを生成するために使用できます。
ステップ 4:エージェントを使用してHubDB のデータにプロンプトを送信
エージェントを作成してデプロイしたら、自然言語プロンプトを使用してHubDB のデータとやりとりできます。
HubDB のデータ にプロンプトを送信するには、以下のステップに従います。
- Chat タブに移動し、ドロップダウンリストからエージェントを選択します。
- プロンプトを入力します(例: 「HubDB で利用可能なテーブルはいくつありますか?」)。
- エージェントがプロンプトを処理して結果を返します。
CData Connect AI を入手
クラウドアプリケーションから直接 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。