Sourcegraph Amp からライブ JSON データに接続する方法(CData Connect AI 経由)
Sourcegraph Amp は、ステートフルな推論、自動コンテキスト管理、ネイティブ MCP(Model Context Protocol)統合を備えた、インテリジェントで本番環境対応のアシスタントを構築するための最新の AI エージェント環境です。CData Connect AI と組み合わせることで、Amp を活用してJSON servicesに自然言語または SQL ベースのクエリでリアルタイムにやりとりするエージェントを作成できます。
CData Connect AI はJSON servicesにアクセスするためのセキュアなクラウド間インターフェースを提供します。Connect AI Remote MCP Server を介して、Amp は JSON に直接接続し、レプリケーションなしでライブデータのクエリと操作を実行できます。最適化されたプッシュダウン機能により、CData Connect AI はフィルタ、集計、JOIN を含む SQL 操作を JSON で直接実行し、高速なリアルタイムパフォーマンスを実現します。
この記事では、Amp エージェントを設定して自然言語または SQL を使ってJSON servicesを会話的に探索する方法を説明します。Connect AI を使用すると、JSON を含む数百のエンタープライズデータソースにセキュアかつリアルタイムにアクセスできるエージェントを簡単に構築できます。
前提条件
- アクティブな CData Connect AI アカウント
- Sourcegraph Amp VS Code 拡張機能または Amp CLI がインストールされていること
- Node.js v20 以上がインストールされていること
- JSON へのアクセス
ステップ 1:Sourcegraph Amp 用に JSON への接続を設定
Amp から JSON への接続は CData Connect AI Remote MCP を介して行います。Amp でJSON servicesを操作するには、まず CData Connect AI で JSON への接続を作成・設定します。
- Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック
- 接続を追加パネルから「JSON」を選択
-
JSON に接続するために必要な認証プロパティを入力します。
データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。CData 製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー(ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー)としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。
URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。
DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。
- Document(デフォルト):JSON データのトップレベルのドキュメントビューをモデル化します。CData 製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
- FlattenedDocuments:ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
- Relational:階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。
リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。
Amazon S3 内のJSON への接続
URI をバケット内のJSON ドキュメントに設定します。さらに、次のプロパティを設定して認証します。
- AWSAccessKey:AWS アクセスキー(username)に設定。
- AWSSecretKey:AWS シークレットキーに設定。
Box 内のJSON への接続
URI をJSON ファイルへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。 認証方法については、Box への接続 を参照してください。
Dropbox 内のJSON への接続
URI をJSON ファイルへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。 認証方法については、Dropbox への接続 を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。 URI=dropbox://folder1/file.json; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;
SharePoint Online SOAP 内のJSON への接続
URI をJSON ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。
SharePoint Online REST 内のJSON への接続
URI をJSON ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。 認証するには、OAuth 認証標準を使用します。
FTP 内のJSON への接続
URI をJSON ファイルへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。
Google Drive 内のJSON への接続
デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。
- 「Save & Test」をクリック
ステップ 2:CData Connect AI 用に Amp を設定
MCP エンドポイントをコピー
Amp はホストされた MCP エンドポイントを介して Connect AI と通信します。
https://mcp.cloud.cdata.com/mcp
このエンドポイントにより、Amp と Connect AI ワークスペース間のセキュアなクラウド間通信が可能になります。
Base64 資格情報を生成
Amp で Connect AI に認証するには、Base64 エンコードされた資格情報を生成します。例えば PowerShell では以下のようになります。
{Convert}::ToBase64String{(Text.Encoding)}::ASCII.GetBytes("[email protected]:yourPAT")
[email protected] を Connect AI のメールアドレスに、yourPAT を Personal Access Token に置き換えてください。
Amp に MCP Server を登録
Base64 文字列を取得したら、以下のコマンドで CData Connect AI MCP サーバーを Amp に登録します。
amp mcp add cdata-connect-ai -- npx -y mcp-remote@latest https://mcp.cloud.cdata.com/mcp --header "Authorization: Basic "
これにより Connect AI の設定が Amp の設定ファイルに追加され、CData Connect AI との通信が有効になります。
接続を確認してデータを探索
- 新しいスレッドを作成
- インタラクティブチャットに入る
- MCP サーバーを確認
- データソースを確認
新しい Amp セッションを開始してデータとのやりとりを始めます。
amp thread new
以下のコマンドで新しいスレッドに接続します:
amp
Amp シェル内で登録された MCP サーバーを確認します:
list mcp
getCatalogsを実行して、接続されたJSON servicesがカタログとして表示されることを確認します。
ステップ 3:ライブ JSON データアクセスでインテリジェントエージェントを構築
Amp アプリケーションが設定され CData Connect AI に接続されたので、自然言語を使ってJSON servicesとやりとりする高度なエージェントを構築できます。MCP 統合により、エージェントに強力なデータアクセス機能が提供されます。
エージェントで利用可能な MCP ツール
Amp アプリケーションは以下の CData Connect AI MCP ツールにアクセスできます。
- getCatalogs: すべてのデータソースカタログを一覧表示(例: JSON1)
- getSchemas: 接続されたカタログ内のデータベーススキーマを返却
- getTables: 指定したスキーマで利用可能なすべてのテーブルとビューを一覧表示
- getColumns: 特定のテーブルまたはビューのカラム定義を返却
- queryData: SQL クエリ(SELECT、INSERT、UPDATE、DELETE)を実行
- getProcedures: ストアドプロシージャまたは API エンドポイントを一覧表示
- getProcedureParameters: ストアドプロシージャのパラメータメタデータを返却
- executeProcedure: ストアドプロシージャを実行(例: JSON アクション)
Amp の主な機能
Amp はインテリジェントでデータ対応の AI エージェント構築に最適な、本番環境対応の機能を提供します。
- 自動コンテキスト管理: Amp は会話コンテキストを自動的に維持・呼び出し、手動での状態追跡なしにシームレスなマルチターンインタラクションを実現
- ステートフルな会話: 複数のクエリにわたってコンテキストとメモリを保持し、自然で人間らしい会話を作成
- ネイティブ MCP 統合: Amp は Model Context Protocol(MCP)をネイティブサポートし、CData Connect AI や他の MCP 対応サーバーからライブデータにセキュアかつリアルタイムにアクセス可能
- ツール指向アーキテクチャ: ツールは管理された呼び出し、入力検証、エラー処理を備えたファーストクラスコンポーネントとして扱われる
- 効率的なコンテキスト処理: Amp はプロンプトを動的に最適化し、モデルのトークン制限に近づいても関連情報を保持
- クロスソースクエリ: 単一の会話ワークフロー内で複数の接続データソースを組み合わせてクエリ可能
- きめ細かいアクセス許可制御: ツールアクセスレベルを定義・適用してデータガバナンスとセキュアな統合を維持
- 開発者フレンドリーな CLI と SDK: Amp CLI または VS Code 拡張機能から MCP 接続の管理、エージェントの設定、ワークフローのテストを簡単に実行
使用例
CData Connect AI を通じたライブデータアクセスで Amp エージェントができることの例を紹介します。
- データ分析エージェント:JSON servicesのトレンドや異常を特定
- レポート生成エージェント: 自然言語プロンプトからレポートを生成
- インタラクティブチャットボット: ライブデータを使ってインサイトを会話形式で説明
- データ品質エージェント: リアルタイムでデータの不整合を監視・フラグ付け
- 自動化ワークフローエージェント: 定義されたデータ条件に基づいてアラートをトリガー
エージェントのテスト
エージェントが動作したら、自然言語クエリでやりとりできます。例えば:
- 「過去 30 日間のすべての新規リードを表示して」
- 「今四半期で最もパフォーマンスの高いキャンペーンは?」
- 「売上の成長を分析して異常を特定して」
- 「現在のオポチュニティのサマリーレポートを生成して」
- 「ステータスが承認待ちのすべてのレコードを検索して」
CData Connect AI を入手
Amp エージェント環境から直接 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを取得するには、CData Connect AI をお試しください。