Diretrizes de Armazenamento de Objetos da Ferramenta RAG para Agentes de IA Generativa

Revise as seções a seguir para preparar dados do Object Storage para ferramentas RAG em Generative AI Agents.

Diretrizes Gerais

Siga estas diretrizes para preparar dados para origens de dados do Generative AI Agents antes de fazer upload para o Object Storage:

  • Origens de Dados: Os dados para Agentes de IA Generativa devem ser submetidos a upload como arquivos para um bucket do Object Storage.
  • Número de Buckets: Somente um bucket é permitido por origem de dados.
  • Tipos de Arquivo Suportados: Arquivos PDF, txt, JSON, HTML e de Markdown (MD) são suportados.
  • Limite de Tamanho do Arquivo: Cada arquivo deve ter no máximo 100 MB. Todos os arquivos que excederem o limite serão ignorados. Para outros requisitos, consulte File Type Requirements and Support.
  • URLs: Todos os hiperlinks presentes nos documentos são extraídos e exibidos como hiperlinks na resposta de chat.
  • Dados Não Prontos: Se seus dados ainda não estiverem disponíveis, crie uma pasta vazia para a origem de dados e preencha-a posteriormente. Dessa forma, você pode ingerir dados na origem depois que a pasta for preenchida.
Observação

Configure as permissões do Object Storage a seguir antes de continuar.

  • Acesso do usuário aos arquivos do Object Storage
  • Acesso do job de ingestão de dados aos arquivos do Object Storage para jobs de longa execução

Consulte Obtendo Acesso para obter as permissões.

Requisitos e Suporte de Tipo de Arquivo

Os arquivos de origem de dados devem ser submetidos a upload para o Object Storage. Certifique-se de que os requisitos sejam atendidos para o tipo de arquivo a ser ingerido.

PDF

Os requisitos e o suporte para ingestão de arquivos PDF são os seguintes:

  • Extensão de arquivo: Deve ser .pdf
  • Tamanho do arquivo: Um único arquivo não deve exceder 100 MB.
  • Senha do arquivo: Se um arquivo PDF for protegido por senha, uma falha no arquivo será registrada nos logs de status.
  • Conteúdo: Um arquivo PDF pode incluir imagens, gráficos e tabelas de referência, mas não deve exceder 8 MB.
  • Preparação de gráfico: nenhuma preparação especial é necessária para gráficos, desde que sejam bidimensionais com eixos rotulados. O modelo pode responder a perguntas sobre os gráficos sem explicações explícitas.
  • Preparação de tabela: Use tabelas de referência com várias linhas e colunas. Por exemplo, o agente pode ler a tabela na página limites.

texto

Os requisitos e o suporte para ingestão de arquivos txt são os seguintes:

  • Extensão de arquivo: Deve ser .txt
  • Tamanho do arquivo: Um único arquivo não deve exceder 100 MB.

JSON

Os requisitos e o suporte para ingestão de arquivos JSON são os seguintes:

  • Extensão de arquivo: Deve ser .json
  • Tamanho do arquivo: Um único arquivo não deve exceder 100 MB.
  • Codificação: Somente a codificação UTF-8 em inglês é suportada. Os dados estruturados JSON podem conter pares de chave/valor, matrizes e objetos aninhados.
  • Profundidade do aninhamento: A profundidade da estrutura não deve exceder 50.
  • Limite de lista: Uma lista dentro da estrutura JSON não deve ter mais de 10000 itens.

HTML

Os requisitos e o suporte para ingestão de arquivos HTML são os seguintes:

  • Extensão de arquivo: Deve ser .html
  • Tamanho do arquivo: Um único arquivo não deve exceder 100 MB.
  • Conteúdo: Somente o conteúdo visível é ingerido. Qualquer conteúdo dinâmico não é ingerido e as tags de script são removidas.
  • Imagens: As imagens que são referenciadas em um arquivo poderão ser processadas se a origem da imagem não for um HTTP externo ou um caminho absoluto. Todas as imagens que não atenderem aos requisitos a seguir serão ignoradas.
    • Somente imagens JPEG (.jpg ou .jpeg) são suportadas.
    • Uma única imagem não deve exceder 6 MB. Todas as imagens que excedam o limite são ignoradas.
    • As imagens devem ser carregadas no Object Storage no mesmo nível do arquivo HTML carregado ou abaixo dele.
    • O caminho de origem (atributo src) para cada imagem deve ser um caminho relativo ao arquivo HTML pai. Por exemplo:
      <img src="./my-image.jpg">
      <img src="./myfolder/my-imagetwo.jpg">
      
    • O caminho de origem (atributo src) para cada imagem não deve especificar URLs (http, https ou data)

MD (Markdown)

Os requisitos e o suporte para ingestão de arquivos MD (Markdown) são os seguintes:

  • Extensão de arquivo: Deve ser .md
  • Tamanho do arquivo: Um único arquivo não deve exceder 100 MB.
  • Imagens: As imagens são ignoradas e não processadas.

Garantindo uma melhor compreensão da tabela

A compreensão aprimorada da tabela, um recurso das ferramentas RAG, visa melhorar a precisão das respostas às consultas com respostas incorporadas nos dados da tabela PDF. Ele processa essas tabelas para gerar respostas mais precisas e relevantes alinhadas com as informações que elas contêm. Em geral, as ferramentas RAG podem ler as tabelas. Para que a ferramenta RAG leia as tabelas com melhor compreensão de tabelas, certifique-se de que elas tenham os seguintes recursos:

  • Todas as células da tabela são separadas por linhas visíveis ou limites de objetos de outras células, incluindo os nomes de cabeçalho na primeira linha.
  • Todas as colunas, incluindo a primeira coluna, têm um nome de cabeçalho.
  • Cada tabela tem mais de uma coluna e mais de uma linha, excluindo a linha com nomes de cabeçalho.
As tabelas ingeridas com melhor compreensão de tabelas são listadas quando você ingere os dados. Mensagem de exemplo:
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

Aprimorando Respostas com Filtragem de Metadados

Use metadados predefinidos para aplicar filtros durante um chat. Quando os filtros são aplicados, as pesquisas de um agente em uma sessão de chat são limitadas a arquivos de dados associados aos metadados, ajudando o modelo a gerar respostas relevantes ao escopo do conteúdo, aumentando assim a precisão e a relevância da resposta do agente.

As etapas a seguir descrevem uma visão geral de como usar o recurso de filtragem de metadados. Depois de entender a visão geral do workflow, revise os detalhes do seu caso de uso nas seções fornecidas após as etapas de visão geral.

  1. Em um editor de texto, crie o esquema de metadados, que é necessário para os filtros que você deseja disponibilizar. Grave o esquema no formato JSON. Nomeie o arquivo como _metadata_schema.json.

    Exemplo:

    {
        "metadataSchema": [
            {
                "name": "publication_year",
                "type": "integer"
            },
            {
                "name": "title",
                "type": "string"
            }
    	]
    }
  2. Faça upload do arquivo _metadata_schema.json criado na etapa 1 para o nível raiz do bucket do Object Storage que contém os arquivos de dados de uma base de conhecimento.
  3. Crie arquivos JSON para associar arquivos de dados aos metadados predefinidos e fornecer os valores de metadados.

    Exemplo:

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

    Você pode associar um ou mais arquivos de dados ou todos os arquivos de um bucket aos metadados. Para obter detalhes sobre as convenções de nome de arquivo JSON a serem usadas para as opções escolhidas, consulte Opções de Filtro de Metadados (Nome e Local do Arquivo).

  4. Faça upload dos arquivos JSON criados na etapa 3 para o bucket do Object Storage que contém os arquivos de dados de uma base de conhecimento. Para cada opção, certifique-se de salvar o arquivo no local correto na hierarquia.
  5. Criar uma base de conhecimento. Selecione Object Storage como o tipo de armazenamento de dados e a opção para iniciar automaticamente o job de ingestão.

    Quando os arquivos de dados são ingeridos, os Agentes de IA Generativa criam uma lista dos nomes de metadados e dos valores que podem ser selecionados em um chat. Para exibir os nomes e valores de metadados ingeridos, consulte Obtendo Detalhes de uma Base de Conhecimento em Agentes de IA Generativa.

  6. Crie um agente com uma ferramenta RAG, selecionando a base de conhecimento criada na etapa 5. No agente, selecione a opção para criar automaticamente um ponto final. Se precisar de ajuda, consulte Criando um Agente e Criando uma ferramenta RAG.
  7. Em uma janela de chat, adicione um ou mais filtros de metadados predefinidos e selecione os valores a serem aplicados. Consulte Usar Filtros de Metadados em um Chat.
Observação

Analise as seções a seguir para saber mais sobre como preparar arquivos JSON de metadados para seu caso de uso e como adicionar e aplicar filtros de metadados em uma sessão de chat.
Opções de Filtro de Metadados (Nome e Local do Arquivo)

Selecione um ou mais dos seguintes métodos que funcionem melhor para você.

Método Nome e Localização do Arquivo Uso
Inclua metadados para todos os arquivos em um bucket sem mencionar os nomes dos arquivos. Crie um arquivo _common.metadata.json no nível raiz do Object Storage. Use esse arquivo para metadados comuns a todos os arquivos do bucket. Esse método ajuda a evitar a inserção de duplicatas de metadados entre objetos.
Em um arquivo, crie uma entrada de metadados para cada arquivo em um bucket e inclua os nomes dos arquivos. Crie um arquivo _all.metadata.json no nível raiz do Object Storage. Use este método se você tiver muitos arquivos e criar um arquivo que inclua todos os nomes de arquivo é mais conveniente para você do que criar um arquivo de metadados por arquivo.
Crie um arquivo de metadados para cada arquivo em um bucket. Crie um arquivo <file-name>.metadata.json para cada arquivo, no nível do arquivo.

<file-name> deve corresponder ao nome do arquivo de dados no bucket.

Use esse método quando os metadados forem diferentes para cada arquivo e não houver muitos arquivos para criar um arquivo de metadados ou se você estiver automatizando a criação dos arquivos de metadados.
Adicione cabeçalhos de metadados do Object Storage a cada arquivo. Adicione o cabeçalho de metadados por meio da propriedade de metadados do Object Storage de cada arquivo. Use este método, se você tiver poucas propriedades de metadados a serem incluídas. Recomendamos que você use os outros métodos com arquivos JSON, porque os arquivos são mais fáceis de atualizar e gerenciar e os cabeçalhos de metadados são difíceis de atualizar.

Para todos os métodos, você deve definir um arquivo de esquema de metadados chamado _metadata_schema.json no nível raiz do bucket do Object Storage.

Aqui está um exemplo de hierarquia de onde você salva os arquivos de metadados necessários.

Uma imagem que mostra a hierarquia dos arquivos de metadados no Object Storage. O bucket_root tem os seguintes arquivos: _all.metadata.json, _common.metadata.json, _metadata_schema.json, file_0.pdf, file_0.pdf.metadata.json, folder_1 e folder_2. Em seguida, o folder_1 inclui file_1.pdf e file_1.pdf.metadata.json e o folder_2 inclui file_2.pdf e file_2.pdf.metadata.json.

Exemplos de Arquivo JSON de Metadados

As etapas a seguir usam exemplos para mostrar como formatar os arquivos JSON de metadados. Consulte também Limites para Filtragem de Metadados.

  1. Crie um arquivo de esquema de metadados chamado _metadata_schema.json e salve-o no nível raiz do Object Storage. Por exemplo:
    {
        "metadataSchema": [
            {
                "name": "field_1",
                "type": "integer"
            },
            {
                "name": "field_2",
                "type": "string"
            },
            {
                "name": "field_3",
                "type": "list_of_string"
            },
            {
                "name": "field_4",
                "type": "double"
            }  
        ]
    }

    Cada filtro de metadados tem uma name e uma type.

    Os valores permitidos para o type são integer, string, list_of_string e double.

    Exemplo:

    {
        "metadataSchema": [
            {
                "name": "rating",
                "type": "double"
            },
            {
                "name": "publication_year",
                "type": "integer"
            },
            {
                "name": "title",
                "type": "string"
            },
            {
                "name": "topic",
                "type": "list_of_string"
            }
        ]
    }
    Exemplo de mapeamento de índice para OpenSearch, integer:
    "publication_year": {
      "type": "integer"         
    }
    Exemplo de mapeamento de índice para OpenSearch, string:
    "title": {
      "type": "text",
      "fields": {
          "keyword": {
              "type": "keyword"
          },
          "search_as_you_type": {
              "type": "search_as_you_type"
          }
       }
    }
    Exemplo de mapeamento de índice para OpenSearch, list_of_string:
    "publishers": {
        "type": "text",
        "fields": {
        "keyword": {
            "type": "keyword"
        },
        "search_as_you_type": {
            "type": "search_as_you_type"
        }
      }
    }
    Exemplo de mapeamento de índice para OpenSearch, double:
    "rating": {
      "type": "double"
    }
  2. (Opcional) Crie um arquivo JSON chamado _commmon.metadata.json para metadados que sejam comuns a todos os arquivos de um bucket. Por exemplo:
    {
        "metadataAttributes": {
            "field_1": value_1,
            "field_2": value_2,
            "field_3": value_3,
            ......,
            "field_n": value_n
        }
    }

    Exemplo:

    {
        "metadataAttributes": {
            "rating": 3.3,
            "publication_year": "2020",
            "topic": [
                "cooking",
                "health",
                "gardening"
            ]
        }
    }
  3. (Opcional) Crie um arquivo JSON chamado _all.metadata.json. Neste arquivo, adicione metadados para cada arquivo por nome. Por exemplo:
    {
        "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. (Opcional) Adicione metadados separadamente para arquivos no bucket criando um arquivo JSON chamado <file-name>.metadata.json para um arquivo.

    <file-name> deve corresponder ao nome do arquivo de dados no bucket. Por exemplo, o arquivo de dados file1.pdf está associado aos metadados definidos no arquivo JSON file1.pdf.metadata.json.

    {
        "metadataAttributes": {
            "field_1": value_1,
            "field_2": value_2,
            "field_3": value_3
        }
    }
Observação

Não é possível alterar ou remover os campos de metadados após a ingestão dos dados da base de conhecimento. Você pode adicionar novos campos ao limite permitido. Para remover ou atualizar um campo, recrie a base de conhecimento.

Usar Filtros de Metadados em um Chat

O procedimento a seguir pressupõe que você tenha criado o esquema de metadados necessário e os arquivos JSON de filtro de metadados opcionais, uma base de conhecimento e um agente com uma ferramenta RAG e um ponto final.

  1. Iniciar um bate-papo.
  2. No painel à direita, expanda Filtros de metadados e selecione Adicionar filtro para adicionar um ou mais filtros.
    1. No painel Adicionar filtro, selecione Adicionar filtro e use os menus para selecionar um filtro de metadados predefinido por nome, um operador de condição e um valor de metadados.

      Por exemplo, você pode adicionar o filtro topic contains cooking, em que topic é o nome do filtro de metadados, contains é o operador de condição e cooking é o valor de metadados.

    2. Selecione Adicionar filtro para adicionar mais filtros conforme necessário.

      Para remover um filtro, selecione o ícone X que está no final da linha.

    3. Quando terminar, selecione Adicionar.

      Os filtros adicionados aparecem em Filtros de metadados na janela de chat. Uma marca de seleção ao lado de um filtro significa que o filtro é aplicado. Se você não quiser aplicar um filtro, desmarque a caixa de seleção ao lado do filtro.

  3. Inicie uma conversa digitando uma mensagem e selecionando Enviar.

    Durante uma sessão de bate-papo, você pode adicionar ou remover filtros de metadados e limpar ou aplicar filtros para continuar a conversa.

Limites para Filtragem de Metadados
Descrição: Limite
Número máximo de entradas em _all.metadata.json 10,000
Número máximo de campos de metadados que podem ser especificados para cada arquivo 20
Número máximo de itens em um list_of_string type 10
Tamanho máximo de item individual em um tipo list_of_string 50
Tamanho máximo de uma chave de metadados em caracteres 25
Tamanho máximo do valor de metadados em caracteres 50

Adicionando Metadados a um Cabeçalho de Metadados do Serviço Object Storage

Crie um bucket do Object Storage e faça upload dos arquivos de origem para respostas RAG nos OCI Generative AI Agents. Opcionalmente, adicione um URL personalizado a cada arquivo para citação.
  1. Na barra de navegação da Console, selecione uma região que hospede Agentes de IA Generativa, por exemplo, Centro-Oeste dos EUA (Chicago). Se você não saber qual região selecionar, consulte Regiões com Agentes do Serviço Generative AI.
  2. Abra o menu de navegação e selecione Armazenamento. Em Object Storage & Archive Storage, selecione Buckets.
  3. Selecione o compartimento no qual deseja criar um bucket ou o compartimento que contém o bucket que deseja usar. Você já deve ter a permissão a seguir para adicionar recursos do Object Storage a este compartimento.
    allow group <your-group-name> to manage object-family in compartment <compartment-with-bucket>
  4. Para criar um bucket, siga estas etapas:
    1. Selecione Criar Bucket.
    2. Informe um nome exclusivo para sua região do bucket.
    3. Para outros campos, selecione os links Saiba mais e, em seguida, selecione as opções que se aplicam aos seus dados. Consulte também Criando um Bucket de Armazenamento de Objetos.
    4. Selecione Criar.
      Por padrão, um novo bucket é privado. Você pode alterar a visibilidade de um bloco depois de criá-lo.
  5. Selecione o nome do bucket que deseja usar.
  6. Na página de detalhes do bucket, em Objetos, selecione Fazer Upload.
  7. (Opcional) Selecione Mostrar Cabeçalhos e Metadados Opcionais e selecione e informe os valores a seguir.
    • Tipo: Metadados
    • Nome: gaas-metadata-filtering-field-<metadata-name>
    • Valor: <metadata-value>
    Importante

    Para que a filtragem de metadados funcione, use o prefixo gaas-metadata-filtering-field- para o Nome de metadados.

    Em seguida, o Object Storage anexa opc-meta- ao nome dos metadados, de modo que o cabeçalho seja exibido como opc-meta-gaas-metadata-filtering-field-<metadata-name>.

    Por exemplo, para adicionar metadados com o nome publication_year, adicione um cabeçalho de metadados com o nome gaas-metadata-filtering-field-publication_year. Quando você obtém os detalhes desse arquivo, o nome dos metadados é exibido como opc-meta-gaas-metadata-filtering-field-publication_year.

    Para valores de lista, use o seguinte formato:

    _LIST_OF_STRING_|list_value_1|list_value_2, em que _LIST_OF_STRING_ é fixo, e cada item da lista é separado por um caractere de pipe '|'. Este formato é decodificado como uma lista de valores: {list_value_1, list_value_2}

  8. Adicione um ou mais arquivos para a origem de dados e selecione Fazer Upload.
    Observação

    • Não é possível atualizar a propriedade metadata de objetos existentes. Em vez disso, você pode copiar um arquivo, adicionar novos metadados a esse arquivo e, em seguida, excluir o arquivo antigo.

    • Você pode adicionar filtros à sua conversa de chat com um agente usando a filtragem de metadados depois que os dados da base de conhecimento do Object Storage e seus metadados forem ingeridos. Para saber mais sobre como adicionar filtros, consulte a etapa 11 em Conversando com Agentes em Agentes de IA Generativa. Você também pode exibir detalhes de valores de metadados depois de ingerir os dados em uma base de conhecimento. Consulte o recurso Metadados em Obtendo Detalhes de uma Base de Conhecimento em Agentes de IA Generativa.

Adicionando Dados com URL Personalizado a um Bucket do Object Storage

Crie um bucket do Object Storage e faça upload dos arquivos de origem para respostas RAG nos OCI Generative AI Agents. Opcionalmente, adicione um URL personalizado a cada arquivo para citação.
  1. Na barra de navegação da Console, selecione uma região que hospede Agentes de IA Generativa, por exemplo, Centro-Oeste dos EUA (Chicago). Se você não saber qual região selecionar, consulte Regiões com Agentes do Serviço Generative AI.
  2. Abra o menu de navegação e selecione Armazenamento. Em Object Storage & Archive Storage, selecione Buckets.
  3. Selecione o compartimento no qual deseja criar um bucket ou o compartimento que contém o bucket que deseja usar. Você já deve ter a permissão a seguir para adicionar recursos do Object Storage a este compartimento.
    allow group <your-group-name> to manage object-family in compartment <compartment-with-bucket>
  4. Para criar um bucket, siga estas etapas:
    1. Selecione Criar Bucket.
    2. Informe um nome exclusivo para sua região do bucket.
    3. Para outros campos, selecione os links Saiba mais e, em seguida, selecione as opções que se aplicam aos seus dados. Consulte também Criando um Bucket de Armazenamento de Objetos.
    4. Selecione Criar.
      Por padrão, um novo bucket é privado. Você pode alterar a visibilidade de um bloco depois de criá-lo.
  5. Selecione o nome do bucket que deseja usar.
  6. Na página de detalhes do bucket, em Objetos, selecione Fazer Upload.
  7. (Opcional) Selecione Mostrar Cabeçalhos e Metadados Opcionais e selecione e informe os valores a seguir.
    • Tipo: Metadados
    • Nome: customized_url_source
    • Valor: <Custom-URL-for-the-file>
    Importante

    Para que a substituição do link de citação funcione, use Nome: customized_url_source.
  8. Adicione um ou mais arquivos para a origem de dados e selecione Fazer Upload.
    Observação

    Se você tiver adicionado os metadados customized_url_source a um objeto na etapa 7, esse URL personalizado se aplicará a todos os arquivos carregados para esse objeto. Não é possível atualizar a propriedade metadata de objetos existentes. Em vez disso, você pode copiar um arquivo, adicionar novos metadados a esse arquivo e, em seguida, excluir o arquivo antigo. Para adicionar ou atualizar um arquivo com os metadados customized_url_source, usando a CLI do OCI, consulte Designando um URL Personalizado a uma Citação.
Observação

Clientes beta:

Se você criou uma base de conhecimento na fase Beta, talvez seja necessário excluir e recriar a origem de dados para que o recurso de tratamento de URL funcione.

Atribuindo um URL Personalizado a uma Citação

Quando um agente usa a RAG para suas respostas, você pode obter citações. Por padrão, as citações apontam para o Object Storage no qual os arquivos são armazenados. Para fazer referência a um URL em vez do arquivo que está sendo referenciado, você pode adicionar um URL personalizado ao objeto metadata desse arquivo.

Este tópico mostra como adicionar ou atualizar o objeto metadata por meio da CLI do OCI.

  1. Inicie a CLI do OCI em um ambiente ou no Cloud Shell. Recomendamos que você tente primeiro no Cloud Shell para se familiarizar com os comandos.
  2. Obtenha o nome do objeto do arquivo ao qual você deseja adicionar um URL personalizado:
    oci os object list --bucket-name <the-bucket-name> 
    --file <the-file-name>
    Exemplo de saída:
    "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.

    Você também pode encontrar o nome do objeto na Console. Na página de detalhes do bucket, selecione o menu Ações (três pontos) do objeto, selecione Exibir Detalhes do Objeto e copie o nome.

    Observação

    Se um arquivo estiver em uma pasta, o nome do arquivo e seu nome de objeto serão diferentes. Por exemplo, para um arquivo chamado file1.pdf, seu nome de objeto pode ser folder1/file1.pdf. Caso contrário, o nome do arquivo e seu nome de objeto serão iguais.
  3. Faça download do arquivo no diretório de trabalho atual.

    Para adicionar ou atualizar o objeto metadata de um arquivo, substitua o arquivo pelo mesmo arquivo que tem um novo objeto metadata. É por isso que você está copiando o arquivo para o diretório de trabalho atual primeiro.

    oci os object get 
    --bucket-name <the-bucket-name> 
    --file <the-file-name>
    --name <the-object-name>
  4. Localize os valores do objeto metadata para o arquivo atual.
    oci os object head 
    --bucket-name <the-bucket-name> 
    --name <the-object-name>
    Exemplo de saída:
    {
     some data
    
      "opc-client-request-id": "xxx",
      "opc-meta-key1": "value1",
      "opc-meta-key2": "value2",
      "opc-request-id": "xxx",
     ...
    }
    

    Este exemplo mostra que o valor do objeto metadata é '{"key1":"value1","key2":"value2"}'. O nome metadata é salvo com um prefixo opc-meta-, mas você não precisa adicionar esse prefixo ao adicionar o nome metadata nas próximas etapas. Esse prefixo é adicionado automaticamente a cada nome metadata.

  5. Substitua o arquivo que está no Object Storage pelo mesmo arquivo que está no diretório de trabalho atual e adicione um novo objeto metadata.

    Para manter os metadados atuais e adicionar o nome e os valores do URL personalizado, '{"customized_url_source":"<the-custom-url>" para o objeto 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>"}'

    Por exemplo, para manter os nomes e valores metadata exibidos no exemplo da etapa 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"}'

    Para substituir o objeto metadata existente para incluir apenas o URL personalizado, execute o seguinte comando

    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. Certifique-se de que o objeto metadata da URL personalizada seja substituído.
    oci os object head 
    --bucket-name <the-bucket-name> 
    --name <the-object-name>
    Exemplo de saída:
    {
     some data
    
      "opc-meta-customized_url_source": "some-new-link",
     ...
    }
    
Importante

  • O objeto metadata que substitui a citação padrão deve ter o nome customized_url_source.
  • Você pode ter um objeto metadata com o nome, customized_url_source
  • Cada customized_url_source pode ter apenas um URL.
  • Os comandos na etapa 5 funcionam tanto para adicionar quanto para atualizar o objeto metadata, porque substituem o valor do objeto metadata atual.
  • Certifique-se de informar os valores do objeto --metadata com o formato mostrado nos comandos na etapa 5.
Links Úteis