# Novo Agente

Criar um Agente de IA é o primeiro passo para transformar a maneira como sua empresa se comunica, permitindo automatizar atendimentos e oferecer suporte inteligente 24/7. Este artigo é o seu guia completo, detalhando o processo de ponta a ponta para configurar e lançar seu primeiro assistente virtual.

Abordaremos desde as configurações iniciais de ativação da funcionalidade em sua conta até os passos essenciais de cadastro das informações do seu negócio e a conexão com um provedor de IA. Ao final deste guia, você terá um agente funcional e pronto para ser treinado com habilidades e uma base de conhecimento para começar a interagir com seus clientes.

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso a plataforma com perfil de administrador
* Habilitar a funcionalidade na plataforma
  {% endhint %}

#### Para Habilitar a Funcionalidade

**Passo 1:** Na tela inicial, clique no menu **“Apps”** em seguida clique na opção **“Mais apps”.**

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

**Passo 2:** Localize o aplicativo "Agentes de IA" e clique em habilitar.

<figure><img src="/files/44BAuY6Lev7rn3GMfeSZ" alt=""><figcaption></figcaption></figure>

#### Como Criar um Novo Agente

Siga os passos abaixo para configurar e criar seu primeiro Agente de IA. Antes de iniciar a criação do agente em si, é fundamental preparar o ambiente com duas configurações essenciais: **as informações da sua empresa e o provedor de IA.**

#### Passo 1: Acesse a Funcionalidade

No menu principal, clique em “Apps” e, em seguida, na opção “Agentes Inteligentes”. Você será direcionado para a tela de configuração.

#### Passo 2: Antes de Criar o Agente: Configurações Essenciais

Para que seu agente funcione corretamente, primeiro precisamos dar a ele um contexto sobre o seu negócio e conectá-lo a um provedor de inteligência artificial.

**A. Cadastre as Informações da Empresa**

Esta etapa alimenta a IA com informações sobre o seu negócio, garantindo que as respostas sejam alinhadas à sua marca.

1. Na tela inicial, clique em **"Empresas"** e dentro da seção **“Informações sobre a Empresa”**, clique no botão “Adicionar empresa”.
2. Preencha os campos do formulário para dar contexto ao agente:
   * **Nome da empresa:** O nome do seu negócio.
   * **Setor de atuação:** A indústria em que você opera (ex: Automotivo, Varejo).
   * **Principais produtos/serviços:** O que sua empresa oferece.
   * **Diferenciais da empresa / Proposta de valor:** O que torna sua empresa única.
   * **Público-alvo:** Quem são seus clientes ideais.
3. Clique em “Salvar” para concluir.

**B. Adicione um Provedor de IA**

Agora, vamos conectar a plataforma ao serviço de IA que será o "cérebro" do seu agente (como o ChatGPT).

1. Na seção **“Provedores”**, clique em “Adicionar provedor”.
2. Preencha as informações de conexão:
   * **Provedor:** Selecione o modelo de IA na lista (ex: ChatGPT).
   * **Chave da API:** Insira a sua chave de API secreta fornecida pelo provedor.
   * **Nome:** Dê um apelido para essa configuração, facilitando a identificação (ex: “GPT-4 Principal”).
3. Clique em “Salvar”.

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

#### Passo 3: Inicie a Criação do Agente

Com a empresa e o provedor devidamente configurados, você está pronto para criar seu primeiro agente! Clique no botão “+ Novo” na área "Nenhum agente cadastrado" e siga para a tela de criação.

Na tela de configuração, preencha as informações fundamentais do seu novo agente:

**A. Perfil e Identidade**

Nesta primeira seção, você define quem é o seu agente:

* **Nome do agente:** O nome interno para sua organização (ex: "Agente de Vendas N1").
* **Apelido:** O nome pelo qual o agente se apresentará ao cliente (ex: "Bia", "João").
* **Assinar a conversa:** Defina se o agente deve assinar as mensagens com o apelido dele (Sim ou Não).

**B. Comportamento e Estilo**

Aqui você ajusta a "personalidade" da IA escolhendo opções pré-definidas para garantir que ela fale como a sua marca:

* **Forma de comunicação:** Escolha o tom de voz (ex: *Consultivo e Acolhedor*, *Neutro e Equilibrado* ou *Formal*).
* **Formato da resposta:** Defina o tamanho ideal das mensagens (ex: *Curta e Objetiva* ou *Longa e Detalhada*).
* **Perfil do agente:** Selecione a função que melhor o descreve (Vendedor, Suporte, Recepcionista, etc.).

**C. Objetivo (Prompt do Sistema)**

No campo **"Descreva o objetivo deste agente"**, você dará as instruções centrais.

* *Exemplo:* "Você é um especialista em vendas da empresa X. Seu objetivo é qualificar o lead e agendar uma reunião. Seja sempre cordial e persuasivo."

**D. Conhecimento (Associação da Empresa)**

Por fim, na seção **"Informações sobre a Empresa"**, selecione na lista qual perfil de negócio (Empresa) este agente deve utilizar para responder às perguntas.

Após preencher todos os campos obrigatórios (\*), clique no botão **“Salvar”** para criar seu agente.

#### Pronto! Seu Agente Foi Criado!

Você será redirecionado para a tela principal, onde seu novo agente aparecerá listado. Agora ele está pronto para ter suas Habilidades e Base de Conhecimento configuradas.

<figure><img src="/files/1xFmv4n2FGCt5VVqg1fi" alt=""><figcaption></figcaption></figure>


---

# 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.flw.chat/guide/documentacao/apps/agentes-inteligentes/novo-agente.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.