資料の英語版に戻る

APIから参照用ファイルを追加する

最終更新: 2025年3月20日

APIから参照用ファイルを追加する

ファイルを追加する方法を学ぶwatsonx.aiプログラムで参照したいもの。

一部のタスクをプログラムで完了するには、ファイルを追加し、API から参照できる必要があります。例えば、基盤モデルプログラムでチューニングするには、トレーニングデータファイルを提供する必要があります。

次のいずれかの資産を作成することで、ファイルを追加できます

接続アセット (connection asset)
データアセット

詳細については、IBM watsonx.ai as a service API documentation の Data references を参照してください。

UIから資産を作成してファイルを追加する

ファイルを利用可能にする 1 つの方法は、watsonx.ai プロジェクトに関連付けられた IBM Cloud Object Storage サービスインスタンスの新しいバケットにファイルを追加することです。 (ユーザーインターフェイスから watsonx.ai プロジェクトを作成すると、IBM Cloud Object Storage サービスインスタンスが自動的に作成されます)

APIから参照できる資産製品ユーザーインターフェースから作成してファイルを追加するには、以下の手順を実行します

IBM Cloud Object Storage インスタンスに、watsonx.ai プロジェクトに関連付けられているバケットを追加します。

IBM Cloud の Resource list から、Storage を展開し、IBM Cloud Object Storage サービス・インスタンスをクリックして開きます。 バケツを作成をクリックします。
バケツにファイルを追加する。

バケツの Objects タブから、ファイルをアップロードします。

API からファイルを参照するには、IBM Cloud Object Storage サービス・インスタンスへの接続を、ファイルが保存されているバケットで作成する必要があります。

プロジェクトで [New Asset (新規アセット)] > [Connect to data source (データ・ソースに接続)] を選択し、IBM Cloud Object Storageを選択して [Next (次へ)] をクリックします。
接続アセットに名前を付ける。

接続の詳細については、以下の情報を追加する：

ステップ1で作成したバケツの名前。
ログイン情報を取得するには、 URL、 IBM Cloud Object Storage でストレージバケットを開き 、「設定」タブをクリックし、パブリックエンドポイント URL をコピーします。

認証情報には、データ・ソースに接続するためのアクセス・キーと シークレット・キー認証オプションを選択します。 IBM Cloud Object Storageサービス・インスタンスのメイン・サービス・ページから、Service credentialsタブをクリックし、使用するキーを見つけて展開し、キーの詳細を表示します。使用する鍵には、HMACクレデンシャルが含まれていなければならない。 HMACクレデンシャルを持つ既存の鍵がない場合は、作成してください。以下の値をコピーして、接続資産の詳細ページの対応するフィールドに貼り付けます：

バケツからコピー	接続アセットへの貼り付け
access_key_id	アクセス・キー
secret_access_key	秘密鍵

watsonx.ai プロジェクトから IBM Cloud Object Storage サービス・インスタンスへの接続を作成する方法の詳細については、IBM Cloud Object Storage 接続を参照してください。

プロジェクトの Assets ページから、IBM Cloud Object Storage データ接続アセットを開きます。 URL 現在のページの URL で、 /connections/ セグメントの後に表示される接続IDをコピーします。

API からファイルを参照するときに、この接続 ID と、バケット名などのその他の詳細を指定できます。
```
"type": "connection_asset",
   "connection": {
     "id": "<connection_id>"
   }
```

UIからデータ資産を作成してファイルを追加する

APIから参照できる製品ユーザーインターフェースからデータ資産を作成してファイルを追加するには、以下の手順に従います

プロジェクトの概要ページで、「作業用データの追加」 タイルをクリックします。
ローカルファイル をクリックし、次に データ資産 をクリックします。
参照をクリックして、アップロードするファイルを見つけて選択します。
「開く」をクリックし、次に 「完了」 をクリックします。
資産のリストから追加したばかりのファイルをクリックして開きます。
In the location field for the web browser, copy the data asset ID that is displayed between the data-assets/ and /preview segments of the URL for the current page.

An example data asset ID is 1e6591a2-c69d-4716-92e3-73e8c2270956.

このデータ資産は、APIからファイルを参照する際に指定できます。
```
{
  "training_data_references": [
  {
    "type": "data_asset",
    "location": {
      "href": "/v2/assets/<asset_id>?project_id=<project_id>"
    }
  }
 ]
}
```

親トピック ドキュメントからテキストを抽出する

トピックは役に立ちましたか?

0/1000