> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/voxone/uso-do-rag-no-voxone.md).

# Uso do RAG no VoxOne

O RAG (Retrieval-Augmented Generation) é um recurso que permite que o agente responda utilizando como base documentos ou URLs enviados por você.\
Isso significa que, ao subir um PDF, TXT, DOC ou adicionar um link, o Vox One passa a ler esse conteúdo e utilizá-lo como referência nas respostas.

O VoxOne conta com uma aba exclusiva chamada RAG, onde você cria, gerencia e testa seus próprios RAGs.

### Vídeo Demonstrativo

No vídeo, mostramos na prática onde fica a aba RAG, como criar um novo RAG, enviar documentos, testar e vincular a um agente.\
Ao final, você estará pronto para utilizar essa funcionalidade no dia a dia e começar a treinar seus agentes com conteúdos personalizados.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F7oHtGVjuJOoSl9An8Tl7%2FRAG.mp4?alt=media&token=e9dc0632-9736-4265-b061-82b728300f7f>" %}

***

### Como navegar

1. Entre no VoxOne.&#x20;

* No topo da tela, clique na nova aba "RAG".

<figure><img src="/files/FOkLiS6yq7pDHUjZeUgf" alt=""><figcaption></figcaption></figure>

2. Criar um novo RAG

* Clique em “Novo RAG”.
* Dê um nome (ex.: TesteRAG).
* Clique em Salvar.

<figure><img src="/files/Zf1Cu5mo2Vmbn4P176vu" alt=""><figcaption></figcaption></figure>

3\. Enviar o conteúdo para o RAG

Após salvar, será habilitada a área de inclusão de conteúdo.\
Você pode enviar informações de duas formas:

<figure><img src="/files/AYnaKcbSMqkQnSncCILA" alt=""><figcaption></figcaption></figure>

a) WEB

* Clique em Adicionar URL.
* Cole o link da documentação ou site que você quer usar.

<figure><img src="/files/6hkbS2RTIzM4r62RhDQZ" alt=""><figcaption></figcaption></figure>

b) Documento

* Envie um arquivo PDF, TXT, DOC ou similar.

<figure><img src="/files/Q9xG3DwhttitN2fsa6TZ" alt=""><figcaption></figcaption></figure>

O sistema mostrará o status do processamento:<br>

<figure><img src="/files/rxhLIEi6o7IZd39JVTdZ" alt=""><figcaption></figcaption></figure>

4\. Testar o RAG

* Dentro do RAG criado, escreva uma palavra-chave.
* Clique em Executar teste.
* Se estiver tudo certo, a resposta será baseada no conteúdo enviado.

<figure><img src="/files/dSRBPGXe72T8S07quX8b" alt=""><figcaption></figcaption></figure>

5\. Associar o RAG a um Agente

* Vá até a área de Agentes.
* Crie um agente ou edite um existente.
* Selecione o modelo (ex.: Ultravox).
* No campo RAG, escolha o RAG criado.&#x20;
* Salve.

<figure><img src="/files/UXoiWfRG428IzDjdwAZ9" alt=""><figcaption></figcaption></figure>

6\. Testar o agente com o RAG

* Faça um teste ou simule uma conversa.
* O agente deve responder com base no conteúdo que você adicionou ao RAG.

***

### FAQ

<details>

<summary>Posso enviar mais de um arquivo para o mesmo RAG?</summary>

Sim. Você pode enviar múltiplos documentos ou URLs.

</details>

<details>

<summary>O agente vai responder somente com base no RAG?</summary>

Não. Ele usa o RAG como referência, mas ainda combina o conteúdo com o modelo de IA.

</details>

<details>

<summary>Posso editar um RAG depois que ele foi criado?</summary>

Sim, você pode adicionar novos arquivos ou remover documentos antigos.

</details>

<details>

<summary>O que fazer se o teste não retornar a resposta esperada?</summary>

Verifique se o documento subiu corretamente e se a palavra-chave está presente no conteúdo.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/voxone/uso-do-rag-no-voxone.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
