引用へのカスタムURLの割当て

エージェントが応答にRAGを使用すると、引用を取得できます。デフォルトでは、引用はファイルが格納されているオブジェクト・ストレージを指しています。参照されているファイルではなくURLを参照するには、そのファイルのmetadataオブジェクトにカスタムURLを追加します。

このトピックでは、OCI CLIを使用してmetadataオブジェクトを追加または更新する方法について説明します。

環境またはクラウド・シェルでOCI CLIを起動します。コマンドに慣れるために、まずCloud Shellで試すことをお薦めします。
コマンドライン・インタフェースの開始を参照してください。
カスタムURLを追加するファイルのオブジェクト名を取得します。
```
oci os object list --bucket-name <the-bucket-name> 
--file <the-file-name>
```
出力例:
```
"data": [
    {
      "archival-state": null,
      "etag": "xxx",
      "md5": "xxx==",
      "name": "<the-object-name>",
      "size": 1117630,
      "storage-tier": "Standard",
      "time-created": "2025-03-12T22:21:26.991000+00:00",
      "time-modified": "2025-03-12T22:38:10.217000+00:00"
    },
Other objects are listed similarly after this comma.
```
コンソールでオブジェクト名を検索することもできます。バケットの詳細ページで、オブジェクトの「アクション」メニュー()を選択し、「オブジェクト詳細の表示」を選択して名前をコピーします。

ノート

ファイルがフォルダにある場合、ファイル名とそのオブジェクト名は異なります。たとえば、file1.pdfという名前のファイルの場合、そのオブジェクト名はfolder1/file1.pdfになります。それ以外の場合、ファイル名とそのオブジェクト名は同じです。
ファイルを現在の作業ディレクトリにダウンロードします。
ファイルのmetadataオブジェクトを追加または更新するには、ファイルを新しいmetadataオブジェクトを持つ同じファイルに置き換えます。そのため、最初にファイルを現在の作業ディレクトリにコピーします。
```
oci os object get 
--bucket-name <the-bucket-name> 
--file <the-file-name>
--name <the-object-name>
```
現在のファイルのmetadataオブジェクト値を検索します。
```
oci os object head 
--bucket-name <the-bucket-name> 
--name <the-object-name>
```
出力例:
```
{
 some data

  "opc-client-request-id": "xxx",
  "opc-meta-key1": "value1",
  "opc-meta-key2": "value2",
  "opc-request-id": "xxx",
 ...
}
```
この例は、metadataオブジェクト値が'{"key1":"value1","key2":"value2"}'であることを示しています。metadata名は接頭辞opc-meta-で保存されますが、次のステップでmetadata名を追加するときに、この接頭辞を追加する必要はありません。この接頭辞は、各metadata名に自動的に追加されます。

オブジェクト・ストレージにあるファイルを現在の作業ディレクトリにあるものと同じファイルに置き換え、新しいmetadataオブジェクトを追加します。

現在のメタデータを保持し、カスタムURLの名前と値'{"customized_url_source":"<the-custom-url>"をmetadataオブジェクトに追加するには:

oci os object put 
--bucket-name <the-bucket-name> 
--file <the-file-name> 
--name <the-object-name>
--force --metadata 
'{"customized_url_source":"<the-custom-url>",
"<existing-metadata-name-1>":"<existing-metadata-value-1>"
"<existing-metadata-name-2>":"<existing-metadata-value-2>"}'

たとえば、ステップ4の例に表示されているmetadataの名前と値を保持するには:

oci os object put 
--bucket-name <the-bucket-name> 
--file <the-file-name> 
--name <the-object-name>
--force --metadata 
'{"customized_url_source":"<the-custom-url>",
"key1":"value1",
"key2":"value2"}'

既存のmetadataオブジェクトをカスタムURLのみを含めるように置換するには、次のコマンドを実行します

oci os object put 
--bucket-name <the-bucket-name> 
--file <the-file-name> 
--name <the-object-name>
--force --metadata '{"customized_url_source":"<the-custom-url>"}'

カスタムURLのmetadataオブジェクトが置換されていることを確認します。

oci os object head 
--bucket-name <the-bucket-name> 
--name <the-object-name>

出力例:

{
 some data

  "opc-meta-customized_url_source": "some-new-link",
 ...
}

重要

デフォルトの引用をオーバーライドするmetadataオブジェクトには、customized_url_sourceという名前が必要です。
customized_url_sourceという名前のmetadataオブジェクトを1つ持つことができます。
各customized_url_sourceにはURLを1つのみ含めることができます。
ステップ5のコマンドは、現在のmetadataオブジェクトの値を置き換えるため、metadataオブジェクトの追加と更新の両方に有効です。
--metadataオブジェクトの値を、ステップ5のコマンドに示されている形式で渡してください。

リンク

Oracle Cloud Infrastructureドキュメント

引用へのカスタムURLの割当て