メインコンテンツまでスキップ
に最終更新

モデルAPI（モデルサービス）の作成と管理

Unity Catalogで独自のモデル APIs（モデルサービス）を作成、共有、管理します。

ヒント

system.ai スキーマ内のシステム提供モデルAPIは、セットアップなしでクエリーを実行できます。追加のモデルを管理する場合や、カスタムEndpointを公開する場合にのみ、独自のモデルAPIを作成してください。

要件​

  • Unity AI GatewayでサポートされているリージョンにあるDatabricksワークスペース。
  • ワークスペースでUnity Catalog有効化されていること。 Unity Catalog のワークスペースを有効にする方法をご覧ください。
  • モデルサービスを作成するには、以下が必要です:
    • USE CATALOG、モデルサービスを作成するカタログとスキーマで、USE SCHEMA および CREATE SERVICE。
    • EXECUTE モデルサービスが宛先として参照する各モデルで。
    • EXECUTE、USE CATALOG、およびUSE SCHEMAを、モデルサービスが宛先として参照する各モデルプロバイダーサービス上で設定します。
    • USE CATALOG推論ログを有効にする場合、推論テーブルが作成されるカタログとスキーマにUSE SCHEMAとCREATE TABLEが設定されます。

モデルサービスを作成​

モデルサービスは、Unity AI Gateway UI または Catalog Explorer で作成できます。

モデルサービスとモデルプロバイダーサービスは、Unity Catalogスキーマ内で単一の名前空間を共有します。スキーマ内のモデルプロバイダーサービスがすでに使用している場合、モデルサービスにその名前を使用することはできません。その逆も同様です。

UIを使用してください​

  1. 以下のいずれかを実行します。

    • ワークスペースサイドバーで、 AI Gateway をクリックし、次に 作成 をクリックします。
    • カタログエクスプローラーで、モデルサービスを作成するスキーマに移動し、 作成 > サービス > モデルサービス をクリックします。

  2. モデルサービスの名前を入力し、作成するカタログとスキーマを選択します。カタログエクスプローラーから開始すると、カタログエクスプローラーがカタログとスキーマを事前に設定します。

  3. 提供するプライマリ送信先を選択します。この送信先は、ユーザーが EXECUTE を持ち、Unity AI Gateway が提供可能な Databricks ホスト型モデルか、またはユーザーが EXECUTE、USE CATALOG、および USE SCHEMA を持つ モデルプロバイダーサービス のいずれかになります。

  4. 作成 をクリックします。

モデルサービスを作成すると、Databricks はその概要ページを開き、そこで開始したり、推論ログなどの追加機能を構成したりできます。

モデルサービスへのアクセスを許可する​

他のユーザーがモデルサービスをクエリできるようにするには、モデルサービスに対するEXECUTE、およびそのカタログとスキーマに対するUSE CATALOGとUSE SCHEMAを付与します。モデルサービスが推論テーブルにログを記録する場合、ログに記録されたリクエストと応答を読み取れるように、テーブルに対するSELECTを付与します。

カタログエクスプローラーでアクセスを付与するには:

  1. カタログエクスプローラーで、モデルサービスを開きます。
  2. アクセス許可 タブで、 許可 をクリックします。
  3. アクセスを付与するユーザーまたはグループを選択し、EXECUTE権限を選択して、 付与 をクリックします。

同じプリンシパルにも、モデル サービスのカタログとスキーマに対するUSE CATALOGとUSE SCHEMAが付与されていることを確認してください。ログに記録されたリクエストと応答を読めるようにするには、推論テーブルの Permissions tabからSELECTを付与します。

アクセス権の付与と発見の詳細については、モデルサービスを管理するを参照してください。

モデルサービスで機能を設定する​

Unity AI Gateway UIから、レート制限、推論ログ記録、ガードレールなどの機能をモデルサービスで構成します。これはUnity AI Gatewayエンドポイントで構成するのと同じ方法です。以下を参照してください:

推論ロギング​

推論ロギングを有効にすると、Databricksは、指定した場所に事前定義されたスキーマを持つ新しい空のUnity Catalogテーブルを作成します。次の点に注意してください:

  • ターゲットカタログとスキーマに対して、USE CATALOG、USE SCHEMA、およびCREATE TABLEを持っている必要があります。
  • モデルサービスの作成者が推論テーブルの所有者です。あなたが許可しない限り、他のユーザーはアクセスできません。
  • 指定された場所にテーブルがすでに存在する場合、モデルサービスの作成は失敗します。
  • 推論テーブルは、モデルサービスとは独立したライフサイクルを持ちます。テーブルを削除すると、モデルサービスは動作を継続しますが、ログの記録を停止します。

推論テーブルの詳細については、「Logs 推論テーブルへのリクエストと応答」を参照してください。

モデルサービスを削除​

モデルサービスを削除するには、それに対する少なくともMANAGEの権限が必要です。所有者はMANAGEのスーパーセットを持っています。

モデルサービスを削除するには、Catalog Explorer で開いてケバブメニューから 削除 を選択します。

system.ai のシステム提供のモデルサービスは削除できません。

次のステップ​

このページの見出し