# 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 ou Atendente.
* Habilitar a funcionalidade na plataforma
  {% endhint %}

#### Para Habilitar a Funcionalidade

**Passo 1:** No cadastro da conta **(Admin -> Contas)** habilite o app **"Agentes de IA "**

**Passo 2:** Defina a quantidade de agentes que podem ser cadastrado na conta. Esse número engloba agentes e supervisores.

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FQpEJwfOWi3IqHZRNVcAo%2Fimage.png?alt=media&#x26;token=a7d01415-55b4-4f16-a101-5146c787b5cf" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FheBscOdaNTRKYcXxSMzV%2Fimage.png?alt=media&#x26;token=6350ae70-4ffd-46a1-8877-444047e57f95" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2F3YWV9KelBD3ZT1Rm2dT7%2Fimage.png?alt=media&#x26;token=ee8b08f1-c52d-479e-8cf4-4b978f7491eb" 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, 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="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FWJ0OrZWESaFFIWpK2rQX%2Fcriar%20provedor%20e%20empresa.gif?alt=media&#x26;token=f87201a5-777e-4fdb-b714-7187a757be5a" 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. Dê um Nome ao Agente**

O primeiro passo é nomear seu agente. Clique sobre o título "Novo agente de IA" e digite um nome de fácil identificação, como “Agente de Vendas” ou “Suporte Nível 1”.

**B. Associe o Provedor e a Empresa**

Agora, conecte as configurações que você criou nos passos anteriores:

* Provedor: No campo "Provedor", selecione na lista o provedor de IA que você cadastrou (ex: "GPT").
* Empresa: No campo "Empresa", selecione o perfil do negócio que este agente irá representar.

**C. Defina a Personalidade do Agente**

No campo “Personalidade do Agente”, você dará as instruções centrais de como a IA deve se comportar. Descreva o tom de voz, a identidade e a função principal dele. Este é um dos campos mais importantes para garantir que o agente atue conforme o esperado.

* *Exemplo:* `Você é um agente de atendimento da empresa Teste. Seu nome é John. Seja sempre cordial e prestativo.`

**D. Salve as Configurações**

Após preencher essas informações iniciais, clique no botão “Salvar” no canto superior direito da tela.

#### 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="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FC5qlBZBGSzZ5r2bnuvUu%2Fcriando%20agente.gif?alt=media&#x26;token=65116959-48b5-49af-bc4e-bf73b8bb42f6" 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.helena.app/configurando-sua-plataforma/apps/mais-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.