> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-e-editando-agentes.md).
# Criando e editando agentes
Neste tutorial, você aprenderá a iniciar a criação de um Agente de Inteligência Artificial dentro da plataforma. O sistema oferece dois caminhos estratégicos para construir o comportamento do seu robô: utilizando a criação guiada por IA ou selecionando modelos de segmentos de mercado predefinidos.
Para iniciar o processo, clique na opção "Agentes" localizada no menu lateral esquerdo da plataforma. Ao abrir a tela, você verá a listagem geral dos robôs cadastrados no seu ambiente e, para dar início a um novo projeto, basta clicar no botão azul "+ Adicionar agente" posicionado no canto superior direito da área de trabalho.
Ao clicar para adicionar, um painel lateral dinâmico chamado "Novo agente" se abrirá do lado direito da tela. O primeiro passo obrigatório é preencher o campo "Nome do agente" com uma identificação clara e voltada ao contexto de negócio (Ex: Suporte Técnico V1 ou Atendimento Comercial).
## Opções de modelos para criar um agente
Logo abaixo, a interface apresentará as duas formas disponíveis para desenhar a estrutura de comportamento do bot: você pode escolher o botão de destaque azul "Crie você mesmo com IA" ou clicar em um dos blocos de segmentos de mercado (como Provedor, Varejo, Saúde, Setor Público, Setor Financeiro, entre outros).
### Selecionando um Modelo Pronto
Caso você opte por seguir a criação por modelos clicando em um dos ramos de empresa, a interface expandirá novas opções contextuais no próprio painel lateral para detalhar o tipo de atendimento. Ao selecionar o segmento Varejo, por exemplo, o sistema abrirá filtros para você definir a atuação do bot (como as abas Atendimento, Logística ou Trocas e devoluções), exibindo cartões de funções específicas abaixo de cada uma delas, como o modelo "Atendimento Geral (SAC)" ou o "Consultor de Vendas e Promoções".
Cada segmento apresenta opções específicas. Leia as instruções exibidas na tela para selecionar o modelo mais adequado para o seu agente.
### Criando o comportamento com IA
Caso você prefira utilizar a inteligência do sistema para construir o bot do seu jeito, clique no botão azul "Crie você mesmo com IA". Ao fazer isso, a plataforma abrirá o campo de texto "Instruções para a IA", onde você deve descrever detalhadamente o objetivo do robô, as habilidades que ele deve ter e as regras básicas que ele precisa seguir (Ex: "Crie um agente especialista em tirar dúvidas sobre notas fiscais e que tenha um tom de voz formal"). O motor da Fortics IA interpretará o seu texto e gerará automaticamente as instruções que orientarão o comportamento do agente de forma automatizada.
## O Direcionamento para a Tela de Cadastro
Independentemente do caminho escolhido (selecionando um modelo pronto ou descrevendo o objetivo para a IA), ao clicar em "Salvar", você será direcionado para a Tela de Cadastro Completo do Agente.
Nesta nova área, todas as opções e diretrizes de comportamento já virão preenchidas e parametrizadas com base no modelo ou no prompt que você definiu nas etapas anteriores. Essa dinâmica permite que você faça apenas uma revisão cuidadosa dos dados, complete os campos finos restantes e finalize o cadastro para colocar o seu Agente em produção no Playground.
A partir de agora vamos comentar cada opção da tela do agente, para isso vamos dividir a tela e ir comentando cada seção
## Configurando o agente
Nesta primeira área da tela de cadastro, você deve definir as informações fundamentais de identidade do seu robô para facilitar a identificação do agente pela equipe e pelos clientes.
{% hint style="warning" icon="lightbulb-exclamation-on" %}
**##Dica**
Para obter melhores resultados, configure cada agente com uma função principal bem definida. Evite misturar muitas responsabilidades no mesmo agente, pois isso pode gerar respostas inconsistentes ou fora do escopo. Caso sua operação precise atender assuntos diferentes, como suporte técnico, vendas ou financeiro, o ideal é criar agentes separados ou fluxos bem delimitados para cada finalidade. Assim, o agente entende melhor o que deve fazer e entrega um atendimento mais seguro, claro e eficiente.
{% endhint %}
No campo **Avatar**, você pode escolher e carregar uma imagem personalizada para representar visualmente o bot clicando no ícone do lápis.
Logo abaixo, você deve selecionar o campo **Voz Padrão** no menu suspenso para definir o tom de voz sintética utilizado (como a voz feminina Aria), caso o agente atue por canais telefônicos ou de áudio.
Na coluna ao lado, sob a guia **Identificação**, insira o **Nome do agente** e adicione uma Descrição detalhada sobre o escopo de atuação dele, mantendo o seu painel corporativo perfeitamente organizado.
{% hint style="warning" icon="lightbulb-exclamation-on" %}
**##Dica**
Use nomes e descrições que **ajudem a identificar o agente e a sua função** como “Agente de vendas de Cloud”. Evite nomes genéricos como “Bot 1” ou “Agente 01”
{% endhint %}
#### Configurações técnicas
O próximo bloco reúne chaves de seleção (*toggles*) que ditam as regras de comportamento técnico e as capacidades do seu robô durante os atendimentos. Configure cada opção conforme a necessidade da sua operação.
**Fuso Horário do agente**: Um seletor para você amarrar a região de funcionamento do bot (como *America/Sao\_Paulo*).
**Habilitar**: Ativa ou desativa completamente o agente na plataforma.
**Proteger:** Chave de segurança para blindar as configurações internas, impedindo exclusões ou alterações acidentais por outros usuários.
**Priorizar Voice Bot**: Quando ativado, força o robô a priorizar canais de áudio e comandos de voz nas interações.
**Habilitar Webchat:** Libera o uso deste agente específico para rodar em widgets de chat incorporados em sites.
**Habilitar OCR**: Dá ao agente a capacidade de "ler" textos em imagens ou capturas de tela enviadas pelos usuários.
**Habilitar Upload de Mídia:** Permite que o robô receba e processe arquivos anexos enviados pelos clientes durante a conversa
#### Configurando o LLM
Nesta seção, você define qual modelo de IA será utilizado pelo agente e associa as credenciais necessárias para o funcionamento. Na coluna da esquerda, selecione o provedor de IA correspondente (*OpenAI, Gemini ou Gemini Free*). Na coluna da direita, a interface se adaptará com base em dois critérios de seleção
**Escolha de Credencial**: O menu suspenso puxará automaticamente apenas as [credenciais válidas que você já cadastrou](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/gerenciando-credenciais.md) previamente na tela de configurações do sistema (como a sua chave privada ou a conta de serviço).
**Modelo de LLM**: O segundo menu de seleção exibe a lista de modelos lógicos disponíveis para aquele provedor (como o *gemini-3.1-pro-preview*), bastando clicar na versão desejada para concluir o vínculo de IA. Fique atento à barra de atenção azul na parte inferior, que detalha as diferenças entre as contas gratuitas e pagas de cada plataforma.
{% hint style="info" %}
**## Importante**
O modelo escolhido deve estar disponível nas credenciais configuradas. Caso contrário, o agente não conseguirá gerar respostas.
{% endhint %}
#### Definindo a persona do agente
Neste painel, você poderá calibrar a personalidade e as diretrizes humanas que guiarão o atendimento.
O primeiro controle é a barra deslizante de **Criatividade** (Temperatura), que define o nível de variação das respostas. Deixar o slider em níveis baixos (Mínima/Pouca) torna o robô estritamente factual, literal e objetivo, o que é ideal para cenários jurídicos ou técnicos. Ajustar para níveis mais altos dá liberdade linguística para a IA usar sinônimos e soar mais espontânea, excelente para cenários comerciais.
{% hint style="warning" %}
**##Dica**
A Criatividade define o quanto o agente pode variar nas respostas. Quanto maior a Criatividade, maior a chance de o agente responder de forma mais livre. Para agentes de atendimento, suporte, FAQ, financeiro ou informações técnicas, recomendamos usar criatividade baixa ou mínima.
Evite Criatividade Alta em agentes que precisam responder com precisão, pois isso aumenta o risco de respostas inventadas.
{% endhint %}
Após ajustar a barra, você deve preencher os prompts que estruturam as instruções de comportamento:
**Persona do agente:** O tom de voz e o comportamento do robô (Ex: "*Amigável, prestativo e objetivo*").
**Papel do agente:** A função oficial que ele desempenha (Ex: "*Agente de Atendimento Geral*").
**Saudação inicial:** A primeira frase que ele enviará ao abrir o chat. Você pode fixar este texto marcando a caixa **"Forçar saudação"** logo abaixo do campo. Ao ativar a opção "Forçar saudação", o agente sempre enviará a mensagem inicial ao iniciar uma conversa.
**Público/Audiência**: A descrição de quem interagirá com ele (Ex: "Qualquer cliente com dúvidas sobre a loja"). Você também pode marcar o checkbox **"Utilizar emojis nas respostas?**" para humanizar a escrita.
{% hint style="warning" icon="lightbulb-exclamation-on" %}
**##Dica**
Ao definir as diretrizes do seu Agente nos campos de prompt, a clareza é a sua maior aliada. Um prompt bem estruturado é o que diferencia um atendimento eficiente de respostas genéricas ou fora do contexto.
**Descreva a função do Agente de forma objetiva**. Por exemplo: *"Agente responsável por coletar informações do cliente e abrir chamados de suporte técnico*." Também é importante definir quem será o público atendido, como em: "*Clientes da \[Empresa] que utilizam \[produto/sistema]*. *Utilize linguagem acessível como padrão e adapte para um nível mais técnico quando necessário. Nunca utilize jargões sem explicação para leigos."*
**Evite descrições genéricas, como "*****ajudar em tudo*****"**. Quando as instruções são muito amplas, o Agente perde o foco e pode gerar respostas fora do escopo ou interpretar incorretamente suas responsabilidades. Ao delimitar claramente sua função, você aumenta a assertividade, a segurança e a qualidade do atendimento.
**Dicas para um prompts de alta performance**:
* **Seja específico**: utilize verbos de ação que delimitem a função do Agente, como *triar, classificar, coletar e agendar*.
* **Estabeleça limites**: deixe explícito o que o Agente pode ou não fazer, principalmente quando houver restrições relacionadas a processos financeiros, jurídicos ou técnicos.
* **Forneça contexto**: quanto mais bem definido for o papel do Agente, maior será a qualidade e a consistência das respostas apresentadas aos seus clientes.
{% endhint %}
#### Curadoria
Abaixo dos prompts, você encontrará a seção de **Curadoria,** composta pelo campo **Agente curador**. Este menu suspenso permite delegar a supervisão das respostas a um segundo robô ou manter o status como "Sem curadoria", garantindo uma camada adicional de auditoria de mensagens se a sua operação exigir regras estritas de conformidade.
#### Passos que o Agente Deve seguir
Nesta seção do cadastro, você estruturará o fluxo operacional e lógico que guiará a árvore de decisões do robô do início ao fim de um atendimento.
No campo de texto **"Função do agente"**, você deve descrever a principal função do robô na linguagem do seu negócio (como o padrão exibido: "*Responder dúvidas diversas dos clientes e encaminhar quando necessário"*).
Logo abaixo, na área "**Passos que o agente deve seguir**", o painel organiza uma lista sequencial de blocos de instruções comportamentais (Ex: cumprimentar o cliente, pedir descrição do problema e fornecer links úteis.
Para oferecer mais flexibilidade na construção do fluxo e na arquitetura da conversa, a interface disponibiliza botões de ação rápida em cada bloco, permitindo gerenciar a estrutura de forma prática e organizada.
Procure manter o fluxo simples e objetivo. Quanto mais clara for a sequência de interações, melhor tende a ser o comportamento do Agente. Evite concentrar muitas intenções em um mesmo passo, pois isso pode dificultar a interpretação das instruções e comprometer a qualidade das respostas.
**Reordenar as Etapas (Setas Direcionais**): No lado esquerdo de cada bloco, você verá setas indicativas para cima (↑) e para baixo (↓). Ao clicar nelas, você altera instantaneamente a ordem de prioridade das instruções, permitindo mover um passo para o início ou para o final da fila sem precisar reescrever o texto.
**Remover Etapas (Ícone de Menos)**: No canto direito de cada bloco de instrução, o botão com o símbolo de menos (−) permite remover imediatamente aquela etapa caso ela se torne obsoleta ou desnecessária para a persona do agente.
**Adicionar Etapas (Ícone de Mais)**: Localizado ao lado do botão de remoção, o símbolo de mais (+) serve para criar uma nova linha de comando no fluxo, permitindo que você expanda e insira novos direcionamentos na esteira de atendimento do robô.
#### Regras Finais e Restrições de Contexto
Nesta área, você aplicará os filtros de segurança e as instruções de fechamento para o comportamento da IA. Você deve interagir com os seguintes campos.
**Evita sair do contexto**: Marque esta caixa de seleção para blindar o robô, garantindo que ele responda estritamente com base nos documentos e informações fornecidos na sua base de dados, ignorando perguntas externas.
**Outras regras e instruções finais**: Utilize este campo de texto para inserir diretrizes restritivas de comportamento (Ex: "Evite respostas vagas. Sempre ofereça um encaminhamento real."). Essa instrução funciona como um comando de prioridade máxima no processamento das mensagens.
#### Expansão de Capacidades do Agente
Para expandir o leque de ações que o robô pode tomar durante uma conversa, role a página até a barra "**ADICIONE MAIS CAPACIDADES PARA O AGENTE**". Para abrir a grade de recursos, você deve clicar no ícone de mais (+) localizado na extremidade direita da barra, conforme indicado.
Ao expandir o menu, a interface exibirá uma série de botões funcionais. Em quase todas as opções selecionadas, o sistema abrirá uma janela ou painel lateral contextualizado para que você configure as permissões e parâmetros da ferramenta. A única exceção é o botão "**Validação de CNPJ**", que é injetado de forma direta no agente sem exigir nenhuma configuração extra.
#### Opções de ferramentas
**Busca em Conhecimento (Recuperação de Conteúdo)**
Nesta tela, você amarrará o robô a uma[ biblioteca de dados específica do sistema](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-uma-base-de-conhecimento.md). No campo Descrição, você pode detalhar cenários de uso para manter o controle da sua infraestrutura. Logo abaixo, abra o menu suspenso **Busca em conhecimento** e [escolha um dos repositórios criados anteriormente](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-uma-base-de-conhecimento.md) (como Suporte Técnico). Dessa forma, o agente utilizará essa base de conhecimento como referência para responder perguntas relacionadas ao tema.
**Busca na Web**
Este formulário permite que o agente realize pesquisas na internet para obter informações atualizadas. Os campos **Nome e Descrição** vêm preenchidos por padrão, mas você pode editá-los livremente. Sob o bloco de configurações, você deve clicar no menu suspenso **Provedor de Busca** e selecionar um dos indexadores disponíveis e então vai aparecer a opção para você[ selecionar uma das credenciais pré-configuradas.](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/gerenciando-credenciais.md)
**Busca em Banco de Dados**
Através desta interface, você configura os parâmetros para que o robô faça consultas de leitura estruturadas em repositórios externos via query SQL. Na caixa de texto **Nome**, identifique a finalidade do recurso. Na seção de configurações, você deve interagir com os seguintes campos:
**Coleção:** Menu suspenso para selecionar a base de dados vinculada à [sua credencial configurada.](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/gerenciando-credenciais.md)
**Selecione os campos**: Filtro para definir quais colunas do banco de dados o agente pode ler (o padrão vem fixado como *Todos*, mas você pode buscar ou digitar colunas específicas).
**Máximo de registros a retornar**: Um limitador numérico padrão (fixado em 100) para evitar sobrecarga no tempo de resposta.
Instruções adicionais: Campo de texto livre para você dar diretrizes restritivas ou prompts específicos sobre como a IA deve tratar esses dados extraídos.
**Executar Workflow (Workflow Tools)**
Esta janela vincula automações de processos de TI diretamente ao fluxo de conversação do robô. Após definir a identificação na caixa **Nome**, clique no menu suspenso **Workflow** para selecionar um dos fluxos lógicos criados na plataforma. Ao salvar, você permite que o agente execute ações em sistemas externos no momento em que uma etapa correspondente for identificada no chat.
**Ferramentas MCP (MCP Tools)**
Neste painel, você ativa protocolos avançados de modelo de contexto *(Model Context Protocol*) para expandir as habilidades e capacidades externas do robô. O formulário apresenta campos básicos para preenchimento de **Nome** e **Descrição** para controle da sua TI. Sob a aba de configurações, basta abrir o menu suspenso **Ferramentas** para [selecionar uma ferramenta MCP configurada ](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/cadastrando-o-model-context-protocol-mcp.md)que atenda aos requisitos específicos que o agente precisará executar no ambiente de produção.
**Inserção em Banco de Dados**
Esta interface dita os parâmetros para que o robô salve informações ou inputs coletados durante a conversa diretamente em um banco de dados externo. O formulário exige que você dê um nome ao processo e preencha as regras lógicas.
No campo **Coleção**, seleciona a [base de dados pré-cadastrada nas configurações](/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/gerenciando-credenciais.md).
No campo **Selecione os campos**, defina em quais colunas os dados do chat serão injetados.
Na caixa **Instruções adicionais,** detalhe diretrizes finas sobre como a IA deve organizar e higienizar os textos coletados antes de salvá-los de forma definitiva.
**Validação de CNPJ**
Esta é a única funcionalidade automatizada que **não abre uma janela de formulário extra**, pois as regras de validação cadastral já rodam de forma nativa e direta no sistema.
Ao clicar no botão, a ferramenta com a identificação **Validação de CNPJ** é imediatamente injetada abaixo da barra de capacidades do agente. Você pode clicar no ícone de lixeira localizado à direita se precisar remover o recurso da árvore de decisões do bot.
### Finalizando a criação do agente
Ao concluir a criação do agente é só clicar em salvar no final da página. Utilize o salvar se quiser somente salvar e continuar editando, ou salvar e sair para salvar as edições e voltar a tela de lista de agentes.
## Editando agentes
Sempre que a sua operação exigir mudanças nos prompts, na escolha do modelo de inteligência artificial ou no acoplamento de novas capacidades avançadas, você deve realizar a edição do agente direto pelo painel.
Na barra de ferramentas inferior do cartão do robô escolhido, clique no **ícone de lápis**.
Ao realizar essa ação, o sistema direcionará você imediatamente para a mesma tela de cadastro utilizada no momento da criação do agente. Todos os parâmetros salvos anteriormente serão carregados nos respectivos campos e formulários, permitindo que você revise as diretrizes da persona, atualize as ferramentas integradas e grave as alterações de forma definitiva.
Ao concluir os ajustes basta salvar.
## Removendo agentes
Quando uma estrutura de atendimento se tornar obsoleta ou precisar ser completamente descartada, a interface permite que você faça a exclusão para manter a sua listagem limpa. Para iniciar o descarte, vá até o canto inferior direito do cartão do bot e clique no **ícone da lixeira**.
A interface exibirá um modal de atenção centralizado na tela, e para confirmar a exclusão definitiva dos dados em toda a plataforma, você deve clicar explicitamente no botão azul **"Confirmar"**.
Lembre-se de que esta ação é irreversível e removerá todas as amarrações do robô no banco de dados.
## Resultados esperados
Ao longo deste tutorial, você configurou todas as etapas necessárias para criar, personalizar e administrar agentes de IA na plataforma. Também conheceu os recursos avançados que permitem expandir as capacidades do agente e integrar o atendimento a diferentes fontes de dados e automações.
#### Ao final deste processo, você terá:
* Um agente configurado de acordo com as necessidades da sua operação.
* O modelo de IA e as credenciais corretamente vinculados.
* Uma persona e um fluxo de atendimento definidos.
* Ferramentas adicionais habilitadas para ampliar as capacidades do agente.
* Autonomia para editar, evoluir ou remover agentes sempre que necessário.
* Um ambiente preparado para realizar testes e colocar o agente em produção.
#### Próximos passos
Agora que o agente foi criado, você pode:
* Testar o comportamento do agente no Playground.
* Adicionar bases de conhecimento para aumentar a precisão das respostas.
* Integrar workflows e ferramentas externas para automatizar processos.
* Ajustar a persona e os passos do agente conforme a evolução da operação.
---
# 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, and the optional `goal` query parameter:
```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-ia/criando-e-editando-agentes.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.