# Criar e publicar seu agente no Instfy Agent

<p class="lead">Passo a passo para criar um agente no Studio, adicionar conhecimento, personalizar, instalar no site, testar e acompanhar conversas e leads.</p>

Este guia leva você do primeiro login até o agente funcionando no seu site. Siga as tarefas na ordem: um agente com boa base de conhecimento responde melhor desde o primeiro dia.

!image[Studio do Instfy Agent com as abas Builder, Conhecimento, Análises, Conversas, CRM e Instalar]

## Antes de começar

- **Acesso ao Studio:** o acesso é liberado pela equipe Instfy. Não existe cadastro aberto. Se você ainda não tem login, escreva para relationship@instfy.com.
- **Conteúdo da empresa:** separe o endereço do site, as páginas principais (produtos, serviços, preços publicados, políticas) e as perguntas que os clientes mais fazem.
- **Acesso ao site:** você vai precisar colar um trecho de código no site ou pedir isso a quem cuida dele.
- **WhatsApp comercial (opcional):** o número para onde o agente pode encaminhar o visitante.

## Entrar no Studio

**Caminho:** `ai.instfy.com/studio/login`

<ol class="steps">
<li>Abra a tela <strong>Entrar no painel</strong>.</li>
<li>Preencha <strong>Email</strong> e <strong>Senha</strong> recebidos da equipe Instfy.</li>
<li>Clique em <strong>Entrar</strong>. O Studio abre no <strong>Dashboard</strong>.</li>
</ol>

:::tip
Troque a senha provisória no primeiro acesso e não compartilhe o seu login. Para dar acesso a outra pessoa, adicione um membro em *Configurações > Equipe*.
:::

## Criar o agente

**Caminho no menu:** *Agentes > + Novo agente*

<ol class="steps">
<li>No menu lateral, clique em <strong>Agentes</strong>.</li>
<li>Clique em <strong>+ Novo agente</strong>.</li>
<li>No campo <strong>Nome do agente</strong>, digite o nome que o visitante vai ver.</li>
<li>Clique em <strong>Criar e abrir</strong>. O sistema cria o endereço do agente a partir do nome e abre a aba <strong>Builder</strong>.</li>
</ol>

## Adicionar conhecimento

O conhecimento é o que o agente usa para responder. Comece pelo site e complete com textos.

**Caminho no menu:** *Agentes > (seu agente) > Conhecimento*

<ol class="steps">
<li>Abra a aba <strong>Conhecimento</strong> e vá até <strong>Adicionar conhecimento</strong>.</li>
<li>Na opção <strong>Site</strong>, informe o endereço principal, ajuste o <strong>Máximo de páginas</strong> (até 120) e clique em <strong>Varrer site</strong>.</li>
<li>Use <strong>Página</strong> e <strong>Buscar e indexar</strong> para incluir uma URL importante que não entrou na varredura.</li>
<li>Use <strong>Arquivo</strong> e <strong>Enviar e indexar</strong> para TXT, MD, CSV, TSV, JSON, HTML ou XML com até 5 MB.</li>
<li>Use <strong>Texto</strong>, escolha o tipo Texto ou FAQ e clique em <strong>Indexar texto</strong> para respostas que não estão no site.</li>
<li>Confira em <strong>Conhecimento indexado</strong> se cada fonte chegou ao status indexado.</li>
</ol>

:::note
Envio de PDF e DOCX está **Em breve**. Enquanto isso, converta para TXT ou cole o conteúdo como Texto.
:::

## Personalizar no Builder

**Caminho no menu:** *Agentes > (seu agente) > Builder*

<ol class="steps">
<li>Preencha <strong>Nome</strong>, <strong>Descrição</strong> e deixe o <strong>Status</strong> como Ativo.</li>
<li>Escreva a <strong>Mensagem inicial</strong> e o <strong>Placeholder do input</strong> (o texto de exemplo na caixa de digitação).</li>
<li>Defina o <strong>Tom de voz</strong> e o <strong>Idioma</strong>.</li>
<li>Informe o <strong>WhatsApp</strong> somente com números, se quiser que o agente encaminhe para ele.</li>
<li>Escolha <strong>Cor primária</strong>, <strong>Tema</strong>, <strong>Posição do widget</strong>, as cores da barra e o avatar.</li>
<li>Em <strong>Perguntas sugeridas</strong>, escreva uma pergunta por linha.</li>
<li>Em <strong>Compartilhamento (WhatsApp e redes sociais)</strong>, defina título, descrição e imagem do link público. O Studio pode sugerir título e descrição a partir do conhecimento.</li>
<li>As alterações salvam sozinhas. Use <strong>Salvar agora</strong> se quiser garantir.</li>
</ol>

## Testar antes de publicar

<ol class="steps">
<li>Clique em <strong>Ver página pública</strong> no topo do agente.</li>
<li>Faça as perguntas que seus clientes mais fazem e confira as fontes mostradas.</li>
<li>Pergunte algo que não está na base e confirme que o agente avisa que não tem a informação.</li>
<li>Complete a base com Texto ou FAQ para o que faltou e teste de novo.</li>
</ol>

## Instalar no site

**Caminho no menu:** *Agentes > (seu agente) > Instalar*

<ol class="steps">
<li>Abra a aba <strong>Instalar</strong>.</li>
<li>Escolha o método: <strong>Script (HTML)</strong>, <strong>Google Tag Manager</strong>, <strong>WordPress</strong>, <strong>Shopify</strong>, <strong>React/Next</strong>, <strong>Página/iframe</strong> ou <strong>API (cURL)</strong>.</li>
<li>Copie o trecho mostrado. No método Script, ele é uma única tag <code>&lt;script&gt;</code> que carrega o widget e identifica o seu agente.</li>
<li>Cole o trecho no site, antes do fechamento da tag <code>&lt;/body&gt;</code> ou no local indicado para o método escolhido.</li>
<li>Use o <strong>Preview ao vivo</strong> para conferir a aparência.</li>
<li>Abra o seu site e confirme que o widget aparece na posição escolhida.</li>
</ol>

Você também pode divulgar o **link da página pública** na bio, no WhatsApp ou em um QR Code, sem mexer no site.

## Acompanhar conversas e leads

- **Conversas:** leia cada atendimento e veja o canal de origem (Widget, Página pública, Teste, Voz, PDV e outros).
- **Análises:** acompanhe volume, lacunas de conhecimento e tópicos mais perguntados.
- **CRM:** cadastre os contatos com intenção de compra e mova os cartões pelo funil.

Veja a rotina completa em [Agentes de gestão e automação](#/ai-agents).

## Perguntas frequentes

### Como faço para ter acesso ao Studio do Instfy Agent?

O acesso é liberado pela equipe Instfy. Escreva para relationship@instfy.com pedindo o seu login. Não existe cadastro aberto no Studio.

### Quantas páginas do site o agente consegue ler?

A varredura de site lê até 120 páginas por fonte, com padrão de 30. Você pode adicionar outras páginas individualmente com a opção Página.

### O widget interfere no visual do site?

Não. O widget é carregado por um único script e roda isolado do restante da página, com estilo próprio, sem alterar o layout do site.

### Preciso republicar o código quando mudo a cor ou a mensagem?

Não. As alterações feitas no Builder valem para o widget já instalado, sem trocar o código no site.

### Como atualizo o agente quando o site muda?

Na aba Conhecimento, clique em Atualizar na fonte de URL que mudou. O conteúdo é buscado de novo e reindexado.

## Próximos passos

Com o agente publicado, organize a rotina de gestão.

:::related
ai-agents, instfy-ai, contact-support
:::