# Agentes Os “**Agentes**” orquestram as interações entre modelos, Skills e fluxos de automação na camada de Inteligência Artificial do **Skyone Studio**. Eles atuam como “intérpretes” que processam comandos, executam as configurações estabelecidas e retornam a resposta final ao usuário. Cada agente: * Está vinculado a um modelo; * Pode utilizar uma ou mais **Skills;** * Pode operar isoladamente como **assistente** ou em **cooperação** com outros agentes. ### Diferença entre Assistente e Cooperação Para otimizar o uso de Inteligência Artificial, é fundamental compreender a distinção entre um Agente Assistente e uma arquitetura de Cooperação. A escolha entre um ou outro depende da complexidade da tarefa e da necessidade de especialização. #### Agente Assistente O Agente Assistente é um modelo de interação centralizado. Ele atua como um assistente generalista que possui acesso a um conjunto amplo de ferramentas e conhecimentos para resolver diversas demandas em um único fluxo. * **Ponto único de contato:** O usuário interage com um único agente que processa a requisição do início ao fim. * **Contexto Amplo:** É ideal para tarefas lineares onde o volume de informações não compromete a assertividade da IA. * **Funcionamento:** Ele recebe o comando, consulta sua base de conhecimento ou Skills configuradas e entrega a resposta final diretamente. #### Agente de Cooperação O Agente Cooperação utiliza uma arquitetura de Multiagentes, onde há o gerenciamento da interação cooperativa entre agentes. * **Divisão de Especialidades:** Em vez de um único agente processar todos os temas, a carga de trabalho é segmentada. Em uma estrutura de atendimento, por exemplo, o Agente de Cooperação identifica se a solicitação refere-se a Logística ou Suporte, direcionando a tarefa instantaneamente ao agente especializado correspondente * **Tomada de Decisão (Roteamento):** O Agente de Cooperação atua com uma triagem lógica. Ele analisa a intenção do usuário e delega a execução para o agente que possui o melhor domínio técnico para aquele tema. * **Eficiência e Precisão:** Como cada agente trabalha com um escopo reduzido de dados, o risco de erros (alucinações) diminui e a velocidade de resposta aumenta, pois a busca por informações é direcionada e não global. ### Criar um Agente 1. Acesse o menu lateral e clique em “**Agentes**”.
2. Clique em "**Novo Agente**". 3. Escolha o tipo de agente: **Assistente** ou **Cooperação**.
Selecione a aba correspondente ([**Assistente**](#assistente) ou [**Cooperação**](#cooperacao)) para acessar as instruções de criação específicas de cada modalidade: {% tabs %} {% tab title="Assistente" %} 4\. Preencha ou selecione os seguintes campos: * **Nome do agente:** nome para identificação do agente. * **Prompt do sistema:** escreva o prompt para o agente. Caso deseje adicionar mais prompts, basta clicar em “Adicionar prompt”. {% hint style="success" %} Diferentes prompts no mesmo agente são úteis para separar tarefas e facilitar manutenção. {% endhint %} * **Modelo:** selecione um modelo já existente. Ele será a base de interpretação do agente. * **Tipo de resposta:** o agente poderá responder por três modos diferentes: * **Texto:** o agente responderá por texto * **Áudio:** o agente responderá por áudio. Ao selecionar esta opção, as seguintes configurações de voz tornam-se necessárias: * **Voz do agente:** selecione, entre as opções disponíveis na plataforma, a identidade vocal que melhor representa o seu agente. * **Instruções de fala:** descreva o tom de voz desejado (ex.: empático, formal, entusiasta) e outras possíveis orientações de locução. * **Híbrido:** possui a capacidade de alternar entre texto e áudio, entregando uma experiência mista dentro da mesma interação. Ao selecionar esta opção, as configurações de voz mencionadas acima são necessárias. {% hint style="info" %} A disponibilidade do **Tipo de Resposta** está diretamente vinculada ao modelo selecionado. O modo **Híbrido** não é compatível com todos os modelos de IA disponíveis na plataforma. {% endhint %} * **Disponibilizar geração de gráficos:** ao ativar a flag, é possível a criação de gráficos a partir dos dados do agente, exceto gráfico do tipo teia. {% hint style="info" %} A disponibilidade de geração de gráficos está diretamente vinculada ao modelo selecionado, não sendo compatível com todos os modelos. {% endhint %} * **Mensagem de erro padrão:** defina uma mensagem para os momentos em que o agente não consiga interpretar o prompt ou encontrar uma resposta adequada. * **Gerencie suas tools:** adicione uma ou mais Skills para definir as capacidades técnicas e funções que o agente poderá executar durante o fluxo de automação. * **Base de Conhecimento:** permite vincular documentos (como arquivos PDF) para que o agente os utilize como fonte de consulta. Você pode selecionar arquivos existentes na plataforma ou realizar o upload de novos documentos diretamente nesta etapa. {% hint style="warning" %} As opções de configurações avançadas podem variar conforme o modelo de IA escolhido. {% endhint %} * **Configurações avançadas:** nesta área, você pode ajustar os parâmetros técnicos que regem a geração de respostas do modelo de IA. Essas configurações permitem equilibrar criatividade, precisão, velocidade e custo operacional. Sendo que: * **top\_k:** limita o vocabulário do modelo às k palavras mais prováveis em cada etapa da geração. Por exemplo, se configurado em 50, o modelo escolherá a próxima palavra apenas entre as 50 melhores opções ranqueadas pelo contexto. * **top\_p:** amostragem de núcleo (Nucleus Sampling). Filtra as palavras candidatas com base na soma cumulativa de suas probabilidades. Por exemplo: se definido em 0,9, o modelo considera apenas o subconjunto de palavras que, juntas, somam 90% da probabilidade de ocorrência, descartando opções irrelevantes. * **Temperatura:** define o nível de previsibilidade da resposta.Valores baixos (ex.: 0.2) têm respostas mais diretas e exatas, ideal para análises técnicas. Valores altos (ex.: 0.8) incentivam respostas mais livres e criativas. * **token\_limit:** determina o limite de geração de tokens. Exemplo: Define quantos tokens (palavras ou fragmentos de palavras) o modelo pode gerar na resposta, auxiliando no controle de custos e evitando respostas excessivamente longas. * **context\_limit:** define o limite de memória da conversa. Esse limite determina o volume máximo de tokens (histórico de mensagens e instruções) que o modelo consegue processar simultaneamente para manter a coerência e o fluxo da conversa. * **repeat\_penalty:** ajusta o rigor do modelo para evitar repetição excessiva de palavras, termos ou frases idênticas em uma mesma resposta. * **max\_completion\_tokens:** define o limite máximo de tokens (palavras ou fragmentos de texto) que o modelo pode gerar em uma única resposta. * **Configurações de privacidade:** configure o nível de acesso dos agentes entre as seguintes opções: * **Público:** qualquer pessoa pode visualizar e editar as configurações do agente. * **Privado:** apenas os usuários selecionados poderão visualizar os detalhes e editar o agente atual. * **Configurar usuários:** ao selecionar a opção **Privado**, esta opção torna-se ativa. Escolha os usuários que terão acesso ao agente e, em seguida, clique em "**Concluir**".
{% hint style="info" %} Usuários não autorizados podem usar os agentes, mas não podem visualizar detalhes técnicos ou editá-lo. {% endhint %} {% endtab %} {% tab title="Cooperação" %} 4\. Preencha ou selecione os seguintes campos: * **Nome do agente:** nome para identificação do agente. * **Prompt do sistema:** escreva o prompt para o agente. Caso deseje adicionar mais prompts, basta clicar em “**Adicionar prompt**”. {% hint style="success" %} Diferentes prompts no mesmo agente são úteis para separar tarefas e facilitar manutenção. {% endhint %} * **Modelo:** selecione um modelo já existente. Ele será a base de interpretação do agente. * **Tipo de resposta:** o agente poderá responder por três modos diferentes: * **Texto:** o agente responderá por texto * **Áudio:** o agente responderá por áudio. Ao selecionar esta opção, as seguintes configurações de voz tornam-se necessárias: * **Voz do agente:** selecione, entre as opções disponíveis na plataforma, a identidade vocal que melhor representa o seu agente. * **Instruções de fala:** descreva o tom de voz desejado (ex.: empático, formal, entusiasta) e outras possíveis orientações de locução. * **Híbrido:** possui a capacidade de alternar entre texto e áudio, entregando uma experiência mista dentro da mesma interação. Ao selecionar esta opção, as configurações de voz mencionadas acima são necessárias. {% hint style="info" %} A disponibilidade do **Tipo de Resposta** está diretamente vinculada ao modelo selecionado. O modo **Híbrido** não é compatível com todos os modelos de IA disponíveis na plataforma. {% endhint %} * **Gerencie os agentes para cooperação:** selecione dois ou mais agentes previamente criados. Para isso: * Clique em “**Selecionar agentes**". * No modal, selecione dois ou mais clicando nas respectivas caixas de seleção. * **Mensagem de erro padrão:** defina uma mensagem para os momentos em que o agente não consiga interpretar o prompt ou encontrar uma resposta adequada. * **Configurações avançadas:** nesta área, você pode ajustar os parâmetros técnicos que regem a geração de respostas do modelo de IA. Essas configurações permitem equilibrar criatividade, precisão, velocidade e custo operacional. {% hint style="warning" %} As opções de configurações avançadas podem variar conforme o modelo de IA escolhido. {% endhint %} Sendo que: * **top\_k:** limita o vocabulário do modelo às k palavras mais prováveis em cada etapa da geração. Por exemplo, se configurado em 50, o modelo escolherá a próxima palavra apenas entre as 50 melhores opções ranqueadas pelo contexto. * **top\_p:** amostragem de núcleo (Nucleus Sampling). Filtra as palavras candidatas com base na soma cumulativa de suas probabilidades. Por exemplo: se definido em 0,9, o modelo considera apenas o subconjunto de palavras que, juntas, somam 90% da probabilidade de ocorrência, descartando opções irrelevantes. * **Temperatura:** define o nível de previsibilidade da resposta.Valores baixos (ex.: 0.2) têm respostas mais diretas e exatas, ideal para análises técnicas. Valores altos (ex.: 0.8) incentivam respostas mais livres e criativas. * **token\_limit:** determina o limite de geração de tokens. Exemplo: Define quantos tokens (palavras ou fragmentos de palavras) o modelo pode gerar na resposta, auxiliando no controle de custos e evitando respostas excessivamente longas. * **context\_limit:** define o limite de memória da conversa. Esse limite determina o volume máximo de tokens (histórico de mensagens e instruções) que o modelo consegue processar simultaneamente para manter a coerência e o fluxo da conversa. * **repeat\_penalty:** ajusta o rigor do modelo para evitar repetição excessiva de palavras, termos ou frases idênticas em uma mesma resposta. * **max\_completion\_tokens:** define o limite máximo de tokens (palavras ou fragmentos de texto) que o modelo pode gerar em uma única resposta. {% endtab %} {% endtabs %} 5. Para finalizar, clique em “**Criar agente**". Pronto! Seu agente foi criado. Teste seus agentes em [Playground](https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/playground). **Leia também:** [**Como editar ou excluir seus agentes**](https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/gestao-de-agentes). *** ### FAQ – Agentes de IA
O que é um agente de IA? É uma entidade configurada para executar tarefas, responder perguntas e interagir de forma autônoma, combinando modelos de linguagem, regras e habilidades (skills).
Posso criar meu próprio agente de IA no Skyone Studio? Sim. A plataforma oferece total autonomia para criar agentes personalizados alinhados à sua estratégia de negócio.
Qual a diferença entre um agente nativo e um agente personalizado? * Nativo: já vem pronto para uso, com configurações padrão. * Personalizado: você define comportamento, tom, skills, dados e modelo de linguagem.
Um agente pode ter mais de uma skill? Sim. É possível atribuir múltiplas skills a um agente e definir quando e como cada uma será acionada.
O agente pode acessar meus dados internos? Sim, desde que sejam configuradas as integrações e permissões necessárias.
Posso mudar o modelo de linguagem do agente depois de criado? Sim. É possível alterar o modelo, ajustar parâmetros e atualizar skills sem recriar o agente inteiro.
O agente aprende sozinho? 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.
É possível usar um agente de IA sem conhecimento técnico avançado? Sim. O Skyone Studio foi projetado para permitir que usuários configurem agentes de forma intuitiva, mesmo sem experiência em programação.
O agente funciona offline? Não. É necessário que ele esteja conectado ao ambiente do Skyone Studio e, quando aplicável, às integrações configuradas.
--- # Agent Instructions: 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/agentes.md?ask= ``` 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.