Oracle AI Data Platform (AIDP)開発者拡張機能

Oracle AI Data Platform (AIDP) Developer拡張機能は、統合開発環境(IDE)から直接エージェント・フローを操作するのに役立ちます。

AI Data Platform Workbenchは現在、Microsoft Visual Studio CodeおよびCursorをIDEとしてサポートしています。Visual Studio Code Marketplaceを介してインストールすると、開発者の拡張機能が最新の状態に保たれます。IDEに開発拡張機能を手動でインストールする場合は、更新を適用するときにVSIXをダウンロードして再インストールする必要があります。

開発者拡張機能を使用すると、リモート・ワークスペース・ファイルの参照、変更の同期、フローのデプロイ、エンドポイントのテスト、および組込みのログとトレースによるトラブルシューティングを行うことができます。開発者の拡張機能は、開発者がエージェント・フローを構築および反復し、データ・エンジニアがワークスペース・アセットを管理し、チームが本番ロールアウト前にエンドポイントの動作を検証するのに役立ちます。

開発者拡張機能には、次の主要な機能があります。
  • IDEサイドバーでのワークスペースおよびカタログの参照
  • リモート・ファイルのプレビュー、ダウンロード、比較およびアップロード
  • デプロイ、再デプロイ、アンデプロイおよびステータス・チェック
  • 組込みのエンドポイント・テスト・チャット
  • トレースおよびデバッグの可視性により、トラブルシューティングを迅速化

ベスト・プラクティス

開発者拡張機能を使用する場合は、次のガイドラインに従って最善の結果を得てください。
  • テストを開始し、PRODに昇格します。
  • 共有プロジェクトにアップロードする前に比較/差分を使用してください。
  • ノイズを低減するためにポーリング間隔を合理的に保ちます。
  • デバッグ設定/トークンを機密として扱います。

前提条件

開発者拡張機能を設定する前に、次のものがあることを確認してください。
  • AI Data Platform Workbenchインスタンスへのアクセス
  • マシン上の有効なOCIプロファイル/構成
  • 必要なワークスペースおよびエージェント権限
  • リージョンおよびワークスペースの詳細

Visual Studio CodeへのOracle AI Data Platform (AIDP) Developer Extensionのインストール

Oracle AI Data Platform (AIDP) Developer Extensionは、Visual Studio Codeのマーケットプレイスからダウンロードおよびインストールできます。

  1. Visual Studio Codeを開きます。
  2. 「拡張機能」をクリックします。
  3. Oracle AI Data Platform (AIDP) Developer Extensionを検索します。
  4. 「インストール」をクリックします
  5. プロンプトが表示されたら、Visual Studio Codeを再起動します。
  6. サイドバーにAI Data Platform (AIDP) Developer Extensionが表示されることを確認します。

Oracle AI Data Platform (AIDP) Developer Extensionの手動インストール

Oracle AI Data Platform (AIDP) Developer Extension用のVSIXファイルをダウンロードし、IDEに手動でインストールできます。

  1. IDEで、コマンド・パレットを開きます。CursorおよびVisual Studio Codeでは、このホットキーはCtrl+Shift+P (MacOSではCmd+Shift+P)です。
  2. 「Install from VSIX」と入力し、「 ⁇ Extensions: Install from VSIX... 」を選択します。
  3. ⁇.vsix⁇ ファイルを参照し、 ⁇ 「インストール」をクリックします。
  4. プロンプトが表示されたらIDEを再起動します。
  5. サイドバーにAI Data Platform (AIDP) Developer Extensionが表示されることを確認します。

Visual Studio CodeでのOracle AI Data Platform (AIDP) Developer Extensionの設定

Oracle AI Data Platform (AIDP) Developer Extensionをインストールした後、それをAI Data Platform Workbenchインスタンスに接続するように設定する必要があります。

  1. Visual Studio Codeでフォルダを開き、「Oracle AI Data Platform (AIDP) Developer Extension」をクリックします。
  2. セットアップウィザードを起動します。
  3. 提供されているフィールドにOracle AI Data Platform WorkbenchコンソールURLをコピーして貼り付け、[Enter]を押します。
  4. 検出されたリージョンを確認するか、手動で設定します。[Enter]を押します。
  5. ワークスペース、デフォルトのエージェント・フローおよびオプションのコンピュートを選択します。
  6. 構成を保存し、接続ステータスを確認します。