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.

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.
Consulte Get Started with the Command Line Interface.
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 () 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.
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>
```
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.

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

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

Documentação do Oracle Cloud Infrastructure

Atribuindo um URL Personalizado a uma Citação