Affectation d'une URL personnalisée à une citation

Lorsqu'un agent utilise la RAG pour ses réponses, vous pouvez obtenir des citations. Par défaut, les citations pointent vers Object Storage où les fichiers sont stockés. Pour référencer une URL au lieu du fichier référencé, vous pouvez ajouter une URL personnalisée à l'objet metadata pour ce fichier.

Cette rubrique explique comment ajouter ou mettre à jour l'objet metadata via l'interface de ligne de commande OCI.

Démarrez l'interface de ligne de commande OCI dans un environnement ou dans Cloud Shell. Nous vous recommandons de commencer par l'essayer dans Cloud Shell pour vous familiariser avec les commandes.
Reportez-vous à Introduction à l'utilisation de l'interface de ligne de commande.
Obtenez le nom d'objet du fichier auquel vous voulez ajouter une URL personnalisée :
```
oci os object list --bucket-name <the-bucket-name> 
--file <the-file-name>
```
Exemple de sortie :
```
"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.
```
Vous pouvez également trouver le nom de l'objet dans la console. Sur la page de détails du bucket, sélectionnez le menu Actions () de l'objet, sélectionnez Visualiser les détails de l'objet et copiez le nom.

Remarque

Si un fichier se trouve dans un dossier, le nom du fichier et son nom d'objet diffèrent. Par exemple, pour un fichier nommé file1.pdf, son nom d'objet peut être folder1/file1.pdf. Sinon, le nom du fichier et son nom d'objet sont identiques.
Téléchargez le fichier dans le répertoire de travail actuel.
Pour ajouter ou mettre à jour l'objet metadata d'un fichier, remplacez-le par le fichier contenant un nouvel objet metadata. C'est pourquoi vous copiez d'abord le fichier dans le répertoire de travail actuel.
```
oci os object get 
--bucket-name <the-bucket-name> 
--file <the-file-name>
--name <the-object-name>
```
Recherchez les valeurs d'objet metadata pour le fichier en cours.
```
oci os object head 
--bucket-name <the-bucket-name> 
--name <the-object-name>
```
Exemple de sortie :
```
{
 some data

  "opc-client-request-id": "xxx",
  "opc-meta-key1": "value1",
  "opc-meta-key2": "value2",
  "opc-request-id": "xxx",
 ...
}
```
Cet exemple montre que la valeur de l'objet metadata est '{"key1":"value1","key2":"value2"}'. Le nom metadata est enregistré avec le préfixe opc-meta-, mais vous n'avez pas besoin d'ajouter ce préfixe lorsque vous ajoutez le nom metadata dans les étapes suivantes. Ce préfixe est ajouté automatiquement à chaque nom metadata.

Remplacez le fichier situé dans Object Storage par le fichier situé dans le répertoire de travail en cours et ajoutez un nouvel objet metadata.

Pour conserver les métadonnées en cours et ajouter le nom et les valeurs d'URL personnalisés, '{"customized_url_source":"<the-custom-url>" à l'objet 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>"}'

Par exemple, pour conserver les noms et valeurs metadata affichés dans l'exemple d'étape 4 :

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"}'

Pour remplacer l'objet metadata existant pour inclure uniquement l'URL personnalisée, exécutez la commande suivante :

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>"}'

Assurez-vous que l'objet metadata de l'URL personnalisée est remplacé.

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

Exemple de sortie :

{
 some data

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

Important

L'objet metadata qui remplace la citation par défaut doit avoir le nom customized_url_source.
Vous pouvez avoir un objet metadata avec le nom customized_url_source
Chaque customized_url_source ne peut avoir qu'une seule URL.
Les commandes de l'étape 5 permettent d'ajouter et de mettre à jour l'objet metadata, car elles remplacent la valeur de l'objet metadata en cours.
Veillez à transmettre les valeurs de l'objet --metadata avec le format indiqué dans les commandes de l'étape 5.

Liens

Documentation Oracle Cloud Infrastructure

Affectation d'une URL personnalisée à une citation