# Agentes

Os “**Agentes**” são responsáveis por orquestrar a interação entre modelos, Skills e fluxos de automação no Studio AI. Eles atuam como "**intérpretes**" que recebem comandos, processam a lógica configurada e retornam a resposta final ao usuário.

Cada agente:

* Está vinculado a um modelo;
* Pode utilizar uma ou mais **Skills;**
* Pode operar isoladamente ou em **cooperação** com outros agentes.

### Criar um Agente

1. Acesse o menu lateral e clique em “**Agentes**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FcIyNBCnyD6Xmqxol90H9%2Fkuysce2Gpe.png?alt=media&#x26;token=a216c791-7d64-4f2e-8b47-8111d034f7f3" alt=""><figcaption></figcaption></figure>

2. Clique em "**Novo Agente**".

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FVcOE6k6xGPGJ3xTBRro5%2F6qkdTrdBBF.png?alt=media&#x26;token=04f8bdcc-faa9-4696-8bab-4c78f892ec2a" alt=""><figcaption></figcaption></figure>

3. Preencha as configurações principais:
   1. **Nome do agente**: Usado para identificação interna.
   2. **Modelo vinculado**: Selecione um modelo já existente. Ele será a base de interpretação do agente.
4. Adicione uma ou mais **Skills** (funções que o agente poderá executar).
5. **Base de Conhecimento** **(RAG)**: Essa funcionalidade permite carregar documentos (como PDFs) para que o agente consulte durante a execução.&#x20;
6. **(novo) Parâmetros avançados:** Esses ajustes controlam como o modelo de IA gera suas respostas, permitindo encontrar um equilíbrio entre criatividade, precisão, velocidade e custo.
7. **(novo) top\_k**: Seleção de palavras mais prováveis\
   **Exemplo**: O modelo pode escolher entre as x palavras mais prováveis dentro do contexto.&#x20;
8. **(novo) top\_p**: Amostragem de núcleo (Nucleus Sampling)\
   **Exemplo**: O modelo considera apenas as palavras mais prováveis até que a soma das probabilidades atinja a porcentagem determinada.&#x20;
9. **Temperatura**: define o nível de criatividade da resposta.Baixa (ex.: 0.2): respostas mais diretas e exatas. Alta (ex.: 0.8): respostas mais livres e criativas.
10. **(novo) token\_limit**: Limite de geração de tokens\
    Exemplo: Define quantos tokens (palavras ou pedaços de palavras) o modelo pode gerar na resposta.&#x20;
11. **(novo) context\_limit**: Memória da conversa\
    exemplo: Número máximo de tokens que o modelo consegue “lembrar” no histórico de interação
12. **(novo) repeat\_penalty**: Penalidade por repetição\
    Ajusta a probabilidade de o modelo repetir palavras ou frases.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FN5jIyGpZEsZX2YIn3qkn%2Fchrome_QlgSH9t35b.gif?alt=media&#x26;token=27d59050-bc73-4c9d-9373-83d5422c7f43" alt=""><figcaption></figcaption></figure>

8. Clique em “**Salvar agente**”.

#### Glossário – Agentes de IA

* **Agente de IA**: Entidade configurável que utiliza modelos de linguagem e skills para interagir, processar dados e executar tarefas de forma autônoma.
* **Agente Nativo**: Modelo de agente já disponível na plataforma, com configurações padrão para uso imediato.
* **Agente Personalizado**: Agente criado pelo usuário, configurado de acordo com as regras, fontes de dados, skills e modelos que atendem ao objetivo de negócio.
* **Contexto do Agente**: Conjunto de informações, parâmetros e histórico que o agente utiliza para interpretar e responder solicitações.
* **Prompt Base**: Instrução inicial que define a personalidade, o tom e o comportamento do agente.
* **Fonte de Dados**: Sistema, banco de dados, arquivo ou API conectado ao agente para fornecer informações que ele usará nas respostas e decisões.
* **Modelo de Linguagem**: Motor de IA usado pelo agente para compreender e gerar linguagem natural.
* **Parâmetros de Geração**: Configurações avançadas que influenciam como o agente gera respostas, como top\_k, top\_p, repeat\_penalty e limites de tokens.
* **Skill**: Habilidade específica atribuída ao agente para executar ações ou fornecer informações.
* **Gatilho (Trigger)**: Evento ou comando que ativa o agente ou uma de suas skills.

### FAQ – Agentes de IA

<details>

<summary>O que é um agente de IA?</summary>

É uma entidade configurada para executar tarefas, responder perguntas e interagir de forma autônoma, combinando modelos de linguagem, regras e habilidades (skills).

</details>

<details>

<summary>Posso criar meu próprio agente de IA no Skyone Studio?</summary>

Sim. A plataforma oferece total autonomia para criar agentes personalizados alinhados à sua estratégia de negócio.

</details>

<details>

<summary>Qual a diferença entre um agente nativo e um agente personalizado?</summary>

* Nativo: já vem pronto para uso, com configurações padrão.

- Personalizado: você define comportamento, tom, skills, dados e modelo de linguagem.

</details>

<details>

<summary>Um agente pode ter mais de uma skill?</summary>

Sim. É possível atribuir múltiplas skills a um agente e definir quando e como cada uma será acionada.

</details>

<details>

<summary>O agente pode acessar meus dados internos?</summary>

Sim, desde que sejam configuradas as integrações e permissões necessárias.

</details>

<details>

<summary>Posso mudar o modelo de linguagem do agente depois de criado?</summary>

Sim. É possível alterar o modelo, ajustar parâmetros e atualizar skills sem recriar o agente inteiro.

</details>

<details>

<summary>O agente aprende sozinho?</summary>

O agente não “aprende” no sentido tradicional. Ele atua com base nas regras, fontes de dados e modelos configurados. É possível melhorar sua performance ajustando prompts e skills.

</details>

<details>

<summary>É possível usar um agente de IA sem conhecimento técnico avançado?</summary>

Sim. O Skyone Studio foi projetado para permitir que usuários configurem agentes de forma intuitiva, mesmo sem experiência em programação.

</details>

<details>

<summary>O agente funciona offline?</summary>

Não. É necessário que ele esteja conectado ao ambiente do Skyone Studio e, quando aplicável, às integrações configuradas.

</details>
