Instructions Object Storage de l'outil RAG pour les agents d'IA générative

Consultez les sections suivantes pour préparer les données Object Storage pour les outils RAG dans les agents d'IA générative.

Instructions générales

Suivez ces instructions pour préparer les données des sources de données des agents d'IA générative avant de les télécharger vers Object Storage :

  • Sources de données : les données des agents Generative AI doivent être téléchargées en tant que fichiers vers un bucket Object Storage.
  • Nombre de buckets : un seul bucket est autorisé par source de données.
  • Types de fichier pris en charge : les fichiers PDF, txt, JSON, HTML et Markdown (MD) sont pris en charge.
  • Limite de taille de fichier : chaque fichier ne doit pas dépasser 100 Mo. Les fichiers qui dépassent la limite sont ignorés. Pour connaître les autres conditions requises, reportez-vous à la section File Type Requirements and Support.
  • URL : Tous les liens hypertexte présents dans les documents sont extraits et affichés sous forme de liens hypertexte dans la réponse à la discussion.
  • Données non prêtes : si vos données ne sont pas encore disponibles, créez un dossier vide pour la source de données et renseignez-le ultérieurement. De cette façon, vous pouvez ingérer des données dans la source une fois le dossier renseigné.
Remarque

Configurez les droits d'accès Object Storage suivants avant de continuer.

  • Accès utilisateur aux fichiers Object Storage
  • Accès aux travaux d'ingestion de données aux fichiers Object Storage pour les travaux à longue durée d'exécution

Pour obtenir les droits d'accès, reportez-vous à Obtention de l'accès.

Exigences et prise en charge des types de fichiers

Les fichiers de source de données doivent être téléchargés vers Object Storage. Assurez-vous que les conditions requises pour le type de fichier à inclure sont remplies.

PDF

Les exigences et la prise en charge de l'inclusion des fichiers PDF sont les suivantes :

  • Extension de fichier : doit être .pdf
  • Taille du fichier : un seul fichier ne doit pas dépasser 100 Mo.
  • Mot de passe du fichier : si un fichier PDF est protégé par mot de passe, l'échec d'un fichier est enregistré dans les journaux de statut.
  • Sommaire : un fichier PDF peut inclure des images, des graphiques et des tables de référence, mais ces derniers ne doivent pas dépasser 8 Mo.
  • Préparation de graphique : aucune préparation spéciale n'est nécessaire pour les graphiques, à condition qu'ils soient bidimensionnels avec des axes étiquetés. Le modèle peut répondre aux questions sur les graphiques sans explications explicites.
  • Préparation de table : utilisez des tables de référence comportant plusieurs lignes et colonnes. Par exemple, l'agent peut lire la table sur la page Limites.

txt

Les exigences et la prise en charge de l'inclusion des fichiers txt sont les suivantes :

  • Extension de fichier : doit être .txt
  • Taille du fichier : un seul fichier ne doit pas dépasser 100 Mo.

JSON

Les exigences et la prise en charge de l'inclusion des fichiers JSON sont les suivantes :

  • Extension de fichier : doit être .json
  • Taille du fichier : un seul fichier ne doit pas dépasser 100 Mo.
  • Encodage : seul le codage UTF-8 en anglais est pris en charge. Les données structurées JSON peuvent contenir des paires clé-valeur, des tableaux et des objets imbriqués.
  • Profondeur de l'imbrication : la profondeur de la structure ne doit pas dépasser 50.
  • Limite de liste : une liste dans la structure JSON ne doit pas dépasser 10000 éléments.

HTML

Les exigences et la prise en charge de l'inclusion des fichiers HTML sont les suivantes :

  • Extension de fichier : doit être .html
  • Taille du fichier : un seul fichier ne doit pas dépasser 100 Mo.
  • Sommaire : seul le contenu visible est inclus. Tout contenu dynamique n'est pas inclus et les balises de script sont supprimées.
  • Images : les images référencées dans un fichier peuvent être traitées si la source d'image n'est pas un chemin absolu ou HTTP externe. Toutes les images qui ne répondent pas aux exigences suivantes sont ignorées.
    • Seules les images JPEG (.jpg ou .jpeg) sont prises en charge.
    • La taille des images ne doit pas dépasser 6 Mo. Toutes les images dépassant la limite sont ignorées.
    • Les images doivent être téléchargées vers Object Storage au même niveau que le fichier HTML téléchargé ou en dessous.
    • Le chemin source (attribut src) de chaque image doit être un chemin relatif au fichier HTML parent. Par exemple :
      <img src="./my-image.jpg">
      <img src="./myfolder/my-imagetwo.jpg">
      
    • Le chemin source (attribut src) de chaque image ne doit pas indiquer d'URL (http, https ou data)

MD (Markdown)

Les exigences et la prise en charge de l'assimilation des fichiers MD (Markdown) sont les suivantes :

  • Extension de fichier : doit être .md
  • Taille du fichier : un seul fichier ne doit pas dépasser 100 Mo.
  • Images : les images sont ignorées et ne sont pas traitées.

Amélioration de la compréhension des tables

Une meilleure compréhension des tables, une fonctionnalité des outils RAG, vise à améliorer la précision des réponses aux requêtes avec des réponses intégrées dans les données des tables PDF. Il traite ces tables pour générer des réponses plus précises et pertinentes alignées sur les informations qu'elles contiennent. En général, les outils RAG peuvent lire les tableaux. Pour que l'outil RAG puisse lire les tables avec une meilleure compréhension des tables, assurez-vous que les tables présentent les fonctionnalités suivantes :

  • Toutes les cellules du tableau sont séparées par des lignes visibles ou des limites d'objet des autres cellules, y compris les noms d'en-tête de la première ligne.
  • Toutes les colonnes, y compris la première colonne, ont un nom d'en-tête.
  • Chaque table comporte plusieurs colonnes et plusieurs lignes, à l'exception de la ligne avec des noms d'en-tête.
Les tables qui sont incluses avec une meilleure compréhension des tables sont répertoriées lorsque vous ingérez les données. Exemple de message :
Count of tables that support enhanced table understanding in following PDFs:
      - enhanced_table_test_data/2025_Report1.pdf has 4 tables processed successfully
      - enhanced_table_test_data/2025_Report2.pdf has 3 tables processed successfully
      - enhanced_table_test_data/2025_Report3.pdf has 3 tables processed successfully

Amélioration des réponses avec le filtrage des métadonnées

Utilisez des métadonnées prédéfinies pour appliquer des filtres lors d'une discussion. Lorsque des filtres sont appliqués, les recherches d'un agent dans une session de discussion sont limitées aux fichiers de données associés aux métadonnées, ce qui aide le modèle à générer des réponses pertinentes pour la portée du contenu, améliorant ainsi la précision et la pertinence des réponses de l'agent.

Les étapes suivantes décrivent l'utilisation de la fonctionnalité de filtrage des métadonnées. Une fois que vous avez compris l'aperçu du workflow, vérifiez les détails de votre cas d'emploi dans les sections fournies après les étapes d'aperçu.

  1. Dans un éditeur de texte, créez le schéma de métadonnées, qui est requis pour les filtres que vous voulez rendre disponibles. Ecrivez le schéma au format JSON. Nommez le fichier _metadata_schema.json.

    Exemple :

    {
        "metadataSchema": [
            {
                "name": "publication_year",
                "type": "integer"
            },
            {
                "name": "title",
                "type": "string"
            }
    	]
    }
  2. Téléchargez le fichier _metadata_schema.json créé à l'étape 1 vers le niveau racine du bucket Object Storage qui contient les fichiers de données d'une base de connaissances.
  3. Créez des fichiers JSON pour associer des fichiers de données aux métadonnées prédéfinies et fournir les valeurs de métadonnées.

    Exemple :

    {
        "metadataAttributes": {
            "publication_year": 2020
        }
    } 

    Vous pouvez associer des fichiers de données ou tous les fichiers d'un bucket aux métadonnées. Pour plus d'informations sur les conventions de nom de fichier JSON à utiliser pour les options que vous choisissez, reportez-vous à Options de filtre de métadonnées (nom de fichier et emplacement).

  4. Téléchargez les fichiers JSON créés à l'étape 3 vers le bucket Object Storage qui contient les fichiers de données d'une base de connaissances. Pour chaque option, veillez à enregistrer le fichier à l'emplacement correct dans la hiérarchie.
  5. Créez une base de connaissances. Sélectionnez Object Storage en tant que type de banque de données et choisissez de démarrer automatiquement le travail d'inclusion.

    Lorsque les fichiers de données sont ingérés, les agents d'IA générative créent une liste des noms de métadonnées et des valeurs pouvant être sélectionnées dans une discussion. Pour afficher les noms et les valeurs des métadonnées incluses, reportez-vous à Obtention des détails d'une base de connaissances dans les agents d'IA générative.

  6. Créez un agent avec un outil RAG, en sélectionnant la base de connaissances créée à l'étape 5. Dans l'agent, sélectionnez l'option permettant de créer automatiquement une adresse. Si vous avez besoin d'aide, reportez-vous à Création d'un agent et à Création d'un outil RAG.
  7. Dans une fenêtre de discussion, ajoutez des filtres de métadonnées prédéfinis et sélectionnez les valeurs à appliquer. Reportez-vous à Utilisation de filtres de métadonnées dans une discussion.
Remarque

Consultez les sections suivantes pour en savoir plus sur la préparation des fichiers JSON de métadonnées pour votre cas d'emploi et sur l'ajout et l'application de filtres de métadonnées dans une session de discussion.
Options de filtre de métadonnées (nom et emplacement du fichier)

Sélectionnez une ou plusieurs des méthodes suivantes qui vous conviennent le mieux.

Méthode Nom et emplacement du fichier Syntaxe
Incluez des métadonnées pour tous les fichiers d'un bucket sans mentionner leur nom. Créez un fichier _common.metadata.json au niveau racine Object Storage. Utilisez ce fichier pour les métadonnées communes à tous les fichiers du bucket. Cette méthode évite d'entrer des doublons de métadonnées entre les objets.
Dans un fichier, créez une entrée de métadonnées pour chaque fichier d'un bucket et incluez les noms de fichier. Créez un fichier _all.metadata.json au niveau racine Object Storage. Utilisez cette méthode si vous avez beaucoup de fichiers et la création d'un fichier qui inclut tous les noms de fichier est plus pratique pour vous que la création d'un fichier de métadonnées par fichier.
Créez un fichier de métadonnées pour chaque fichier d'un bucket. Créez un fichier <file-name>.metadata.json pour chaque fichier, au niveau du fichier.

<file-name> doit correspondre au nom du fichier de données dans le bucket.

Utilisez cette méthode lorsque les métadonnées diffèrent pour chaque fichier et qu'il n'y a pas beaucoup de fichiers pour lesquels créer un fichier de métadonnées, ou si vous automatisez la création des fichiers de métadonnées.
Ajoutez des en-têtes de métadonnées Object Storage à chaque fichier. Ajoutez un en-tête de métadonnées via la propriété de métadonnées Object Storage de chaque fichier. Utilisez cette méthode si vous avez peu de propriétés de métadonnées à inclure. Nous vous recommandons d'utiliser les autres méthodes avec les fichiers JSON, car les fichiers sont plus faciles à mettre à jour et à gérer et les en-têtes de métadonnées sont difficiles à mettre à jour.

Pour toutes les méthodes, vous devez définir un fichier de schéma de métadonnées nommé _metadata_schema.json au niveau racine du bucket Object Storage.

Voici un exemple de hiérarchie dans laquelle vous enregistrez les fichiers de métadonnées dont vous avez besoin.

Image représentant la hiérarchie des fichiers de métadonnées dans Object Storage. bucket_root contient les fichiers suivants : _all.metadata.json, _common.metadata.json, _metadata_schema.json, file_0.pdf, file_0.pdf.metadata.json, folder_1 et folder_2. Ensuite, folder_1 comprend file_1.pdf et file_1.pdf.metadata.json et folder_2 comprend file_2.pdf et file_2.pdf.metadata.json.

Exemples de fichiers JSON de métadonnées

Les étapes suivantes utilisent des exemples pour montrer comment formater les fichiers JSON de métadonnées. Reportez-vous également à Limites pour le filtrage des métadonnées.

  1. Créez un fichier de schéma de métadonnées nommé _metadata_schema.json et enregistrez-le au niveau de la racine Object Storage. Exemple :
    {
        "metadataSchema": [
            {
                "name": "field_1",
                "type": "integer"
            },
            {
                "name": "field_2",
                "type": "string"
            },
            {
                "name": "field_3",
                "type": "list_of_string"
            },
            {
                "name": "field_4",
                "type": "double"
            }  
        ]
    }

    Chaque filtre de métadonnées a une valeur name et une valeur type.

    Les valeurs autorisées pour type sont integer, string, list_of_string et double.

    Exemple :

    {
        "metadataSchema": [
            {
                "name": "rating",
                "type": "double"
            },
            {
                "name": "publication_year",
                "type": "integer"
            },
            {
                "name": "title",
                "type": "string"
            },
            {
                "name": "topic",
                "type": "list_of_string"
            }
        ]
    }
    Exemple de mapping d'index pour OpenSearch, integer :
    "publication_year": {
      "type": "integer"         
    }
    Exemple de mapping d'index pour OpenSearch, string :
    "title": {
      "type": "text",
      "fields": {
          "keyword": {
              "type": "keyword"
          },
          "search_as_you_type": {
              "type": "search_as_you_type"
          }
       }
    }
    Exemple de mapping d'index pour OpenSearch, list_of_string :
    "publishers": {
        "type": "text",
        "fields": {
        "keyword": {
            "type": "keyword"
        },
        "search_as_you_type": {
            "type": "search_as_you_type"
        }
      }
    }
    Exemple de mapping d'index pour OpenSearch, double :
    "rating": {
      "type": "double"
    }
  2. (Facultatif) Créez un fichier JSON nommé _commmon.metadata.json pour les métadonnées communes à tous les fichiers d'un bucket. Par exemple :
    {
        "metadataAttributes": {
            "field_1": value_1,
            "field_2": value_2,
            "field_3": value_3,
            ......,
            "field_n": value_n
        }
    }

    Exemple :

    {
        "metadataAttributes": {
            "rating": 3.3,
            "publication_year": "2020",
            "topic": [
                "cooking",
                "health",
                "gardening"
            ]
        }
    }
  3. (Facultatif) Créez un fichier JSON nommé _all.metadata.json. Dans ce fichier, ajoutez les métadonnées de chaque fichier par nom. Par exemple :
    {
        "folder_1/file_1.pdf" : {
            "metadataAttributes": {
                "field_1": value_1,
                "field_2": value_2,
                "field_3": value_3,
                ......,
                "field_n": value_n
            }
        },
        "folder_2/file_2.pdf": {
            "metadataAttributes": {
                "field_1": value_1,
                "field_2": value_2,
                "field_3": value_3,
                ......,
                "field_n": value_n
            }
        }
    }
  4. (Facultatif) Ajoutez des métadonnées séparément pour les fichiers du bucket en créant un fichier JSON nommé <file-name>.metadata.json pour un fichier.

    <file-name> doit correspondre au nom du fichier de données dans le bucket. Par exemple, le fichier de données file1.pdf est associé à des métadonnées définies dans le fichier JSON file1.pdf.metadata.json.

    {
        "metadataAttributes": {
            "field_1": value_1,
            "field_2": value_2,
            "field_3": value_3
        }
    }
Remarque

Vous ne pouvez pas modifier ou enlever les champs de métadonnées une fois les données de la base de connaissances incluses. Vous pouvez ajouter de nouveaux champs à la limite autorisée. Pour supprimer ou mettre à jour un champ, recréez la base de connaissances.

Utiliser des filtres de métadonnées dans une discussion

La procédure suivante suppose que vous avez créé le schéma de métadonnées requis et les fichiers JSON facultatifs de filtre de métadonnées, une base de connaissances et un agent doté d'un outil RAG et d'une adresse.

  1. Lancer une discussion.
  2. Dans le panneau de droite, développez Filtres de métadonnées et sélectionnez Ajouter un filtre pour ajouter des filtres.
    1. Dans le panneau Ajouter un filtre, sélectionnez Ajouter un filtre et utilisez les menus pour sélectionner un filtre de métadonnées prédéfini par nom, opérateur de condition et valeur de métadonnées.

      Par exemple, vous pouvez ajouter le filtre topic contains cooking, où topic est le nom du filtre de métadonnées, contains est l'opérateur de condition et cooking est la valeur de métadonnées.

    2. Sélectionnez Ajouter un filtre pour ajouter d'autres filtres selon vos besoins.

      Pour enlever un filtre, sélectionnez l'icône X située à la fin de la ligne.

    3. Lorsque vous avez terminé, sélectionnez Ajouter.

      Les filtres ajoutés apparaissent sous Filtres de métadonnées dans la fenêtre de discussion. Une coche en regard d'un filtre signifie que le filtre est appliqué. Si vous ne voulez pas appliquer de filtre, décochez la case en regard du filtre.

  3. Lancez une conversation en saisissant un message et en sélectionnant Soumettre.

    Au cours d'une session de discussion, vous pouvez ajouter ou supprimer des filtres de métadonnées, et effacer ou appliquer des filtres pour poursuivre la conversation.

Limites pour le filtrage des métadonnées
Description Limite
Nombre maximal d'entrée dans _all.metadata.json 10 000
Nombre maximal de champs de métadonnées pouvant être spécifiés pour chaque fichier 20
Nombre maximal d'éléments dans un fichier list_of_string type 10
Longueur maximale d'un élément individuel dans un type list_of_string 50
Longueur maximale d'une clé de métadonnées en caractères 25
Longueur maximale de la valeur de métadonnées en caractères 50

Ajout de métadonnées à un en-tête de métadonnées Object Storage

Créez un bucket Object Storage et téléchargez des fichiers source pour les réponses RAG dans les agents OCI Generative AI. Vous pouvez éventuellement ajouter une URL personnalisée à chaque fichier pour la citation.
  1. Dans la barre de navigation de la console, sélectionnez une région qui héberge les agents d'IA générative, par exemple, Midwest des Etats-Unis (Chicago). Si vous ne connaissez pas la région à sélectionner, reportez-vous à Regions avec agents Generative AI.
  2. Ouvrez le menu de navigation et sélectionnez Stockage. Sous Object Storage et Archive Storage, sélectionnez Buckets.
  3. Sélectionnez le compartiment dans lequel créer un bucket ou le compartiment contenant le bucket à utiliser. Vous devez déjà être autorisé à ajouter des ressources Object Storage à ce compartiment.
    allow group <your-group-name> to manage object-family in compartment <compartment-with-bucket>
  4. Pour créer un bucket, procédez comme suit :
    1. Sélectionnez Créer un bucket.
    2. Entrez un nom unique à votre région pour le bucket.
    3. Pour les autres champs, sélectionnez les liens En savoir plus, puis les options qui s'appliquent à vos données. Reportez-vous également à Création d'un bucket Object Storage.
    4. Sélectionnez Créer.
      Par défaut, un nouveau bucket est privé. Vous pouvez modifier la visibilité d'un bucket après l'avoir créé.
  5. Sélectionnez le nom du bucket à utiliser.
  6. Sur la page de détails du bucket, sous Objets, sélectionnez Télécharger vers le serveur.
  7. (Facultatif) Sélectionnez Afficher les métadonnées et les en-têtes facultatifs, puis sélectionnez et entrez les valeurs suivantes.
    • Type : métadonnées
    • Nom : gaas-metadata-filtering-field-<metadata-name>
    • Valeur : <metadata-value>
    Important

    Pour que le filtrage des métadonnées fonctionne, vous devez utiliser le préfixe gaas-metadata-filtering-field- pour le nom des métadonnées.

    Object Storage ajoute ensuite opc-meta- au début du nom des métadonnées, de sorte que l'en-tête s'affiche sous la forme opc-meta-gaas-metadata-filtering-field-<metadata-name>.

    Par exemple, pour ajouter des métadonnées portant le nom publication_year, ajoutez un en-tête de métadonnées portant le nom gaas-metadata-filtering-field-publication_year. Lorsque vous obtenez les détails de ce fichier, le nom des métadonnées apparaît sous la forme opc-meta-gaas-metadata-filtering-field-publication_year.

    Pour les valeurs de liste, utilisez le format suivant :

    _LIST_OF_STRING_|list_value_1|list_value_2, où _LIST_OF_STRING_ est fixe et chaque élément de liste est séparé par un caractère de barre verticale '|'. Ce format est décodé en tant que liste de valeurs : {list_value_1, list_value_2}

  8. Ajoutez des fichiers pour la source de données et sélectionnez Télécharger vers le serveur.
    Remarque

    • Vous ne pouvez pas mettre à jour la propriété metadata des objets existants. A la place, vous pouvez copier un fichier, ajouter de nouvelles métadonnées à ce fichier, puis supprimer l'ancien fichier.

    • Vous pouvez ajouter des filtres à votre conversation de discussion avec un agent à l'aide du filtrage des métadonnées une fois que les données de la base de connaissances d'Object Storage et ses métadonnées ont été ingérées. Pour en savoir plus sur l'ajout de filtres, reportez-vous à l'étape 11 dans Discussion avec les agents dans les agents d'IA générative. Vous pouvez également visualiser les détails des valeurs de métadonnées après avoir ingéré les données dans une base de connaissances. Reportez-vous à la ressource Métadonnées dans Obtention des détails d'une base de connaissances dans les agents d'IA générative.

Ajout de données avec une URL personnalisée à un compartiment Object Storage

Créez un bucket Object Storage et téléchargez des fichiers source pour les réponses RAG dans les agents OCI Generative AI. Vous pouvez éventuellement ajouter une URL personnalisée à chaque fichier pour la citation.
  1. Dans la barre de navigation de la console, sélectionnez une région qui héberge les agents d'IA générative, par exemple, Midwest des Etats-Unis (Chicago). Si vous ne connaissez pas la région à sélectionner, reportez-vous à Regions avec agents Generative AI.
  2. Ouvrez le menu de navigation et sélectionnez Stockage. Sous Object Storage et Archive Storage, sélectionnez Buckets.
  3. Sélectionnez le compartiment dans lequel créer un bucket ou le compartiment contenant le bucket à utiliser. Vous devez déjà être autorisé à ajouter des ressources Object Storage à ce compartiment.
    allow group <your-group-name> to manage object-family in compartment <compartment-with-bucket>
  4. Pour créer un bucket, procédez comme suit :
    1. Sélectionnez Créer un bucket.
    2. Entrez un nom unique à votre région pour le bucket.
    3. Pour les autres champs, sélectionnez les liens En savoir plus, puis les options qui s'appliquent à vos données. Reportez-vous également à Création d'un bucket Object Storage.
    4. Sélectionnez Créer.
      Par défaut, un nouveau bucket est privé. Vous pouvez modifier la visibilité d'un bucket après l'avoir créé.
  5. Sélectionnez le nom du bucket à utiliser.
  6. Sur la page de détails du bucket, sous Objets, sélectionnez Télécharger vers le serveur.
  7. (Facultatif) Sélectionnez Afficher les métadonnées et les en-têtes facultatifs, puis sélectionnez et entrez les valeurs suivantes.
    • Type : métadonnées
    • Nom : customized_url_source
    • Valeur : <Custom-URL-for-the-file>
    Important

    Pour que le remplacement du lien de citation fonctionne, vous devez utiliser Nom : customized_url_source.
  8. Ajoutez des fichiers pour la source de données et sélectionnez Télécharger vers le serveur.
    Remarque

    Si vous avez ajouté les métadonnées customized_url_source à un objet à l'étape 7, cette URL personnalisée s'applique à tous les fichiers que vous téléchargez vers le serveur pour cet objet. Vous ne pouvez pas mettre à jour la propriété metadata des objets existants. A la place, vous pouvez copier un fichier, ajouter de nouvelles métadonnées à ce fichier, puis supprimer l'ancien fichier. Pour ajouter ou mettre à jour un fichier avec les métadonnées customized_url_source, à l'aide de l'interface de ligne de commande OCI, reportez-vous à Affectation d'une URL personnalisée à une citation.
Remarque

Clients bêta :

Si vous avez créé une base de connaissances au cours de la phase bêta, vous devrez peut-être supprimer et recréer la source de données pour que la fonctionnalité de gestion des URL fonctionne.

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.

  1. 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 à la section Get Started with the Command Line Interface.
  2. 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 (trois points) de l'objet, sélectionnez Afficher 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.
  3. 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>
  4. 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.

  5. 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>"}'
  6. 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