> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rovax.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Criando um agente do zero

> Passo a passo para criar um agente manualmente na Timely.ai: escolher o modelo, definir nome, role, prompt e salvar com controle total desde o início.

A criação manual dá a você controle direto sobre cada parâmetro do agente. Em vez de passar por um fluxo conversacional guiado, você preenche os campos de identidade, escolhe o modelo de linguagem e escreve o prompt inicial diretamente nos formulários da plataforma.

Essa rota é recomendada quando você já tem clareza sobre o que o agente precisa fazer — por exemplo, ao replicar uma configuração que já funciona em outro workspace, ao criar agentes com instruções muito específicas, ou quando a velocidade de configuração é mais importante do que a orientação passo a passo.

Qualquer campo pode ser ajustado depois da criação. Não existe comprometimento definitivo ao salvar — o agente fica em status **Rascunho** até você publicá-lo em um canal.

## Como criar

<Steps>
  <Step title="Acesse a seção de Agentes">
    No menu lateral da Timely.ai, clique em **Agentes**. Clique no botão **+ Novo agente** no canto superior da página.
  </Step>

  <Step title="Selecione a criação manual">
    No diálogo de escolha que aparece, clique em **Criar manualmente**. Você será levado diretamente ao formulário de configuração, sem passar pelo fluxo conversacional.
  </Step>

  <Step title="Defina o nome interno">
    No campo **Nome**, escreva o identificador interno do agente. Esse nome aparece para sua equipe nos logs, relatórios e na lista de agentes — não é exibido para o cliente final. Use algo descritivo como "Suporte Técnico L1" ou "Vendas Inbound BR".
  </Step>

  <Step title="Defina o objetivo do agente">
    No campo **Objetivo**, descreva em uma ou duas frases o que o agente deve fazer. Esse texto alimenta o prompt inicial gerado automaticamente pela plataforma como ponto de partida.

    Exemplos:

    * "Atender clientes no pós-venda, responder sobre status de pedidos e iniciar processos de troca."
    * "Qualificar leads inbound, coletar nome, e-mail e orçamento antes de passar para o time comercial."
  </Step>

  <Step title="Configure as opções básicas">
    Três opções de comportamento estão disponíveis no formulário de criação:

    | Opção                     | O que faz                                                                    |
    | ------------------------- | ---------------------------------------------------------------------------- |
    | Transferência para humano | Permite que o agente encaminhe conversas para um atendente                   |
    | Usar emojis               | O agente pode incluir emojis nas respostas                                   |
    | Dividir respostas         | Mensagens longas são quebradas em blocos menores (recomendado para WhatsApp) |
  </Step>

  <Step title="Crie o agente">
    Clique em **Criar agente**. O agente é criado com status **Rascunho** e aparece na lista de agentes. A partir daqui você acessa todas as abas de configuração avançada.
  </Step>
</Steps>

## Próximos passos após a criação

Com o agente criado, configure os detalhes nas abas disponíveis:

<CardGroup cols={2}>
  <Card title="Modelo e parâmetros" href="/guides/agents/settings/model">
    Escolha o provedor, o modelo de LLM e ajuste temperatura e effort para o caso de uso.
  </Card>

  <Card title="Prompt do sistema" href="/guides/agents/settings/prompt">
    Escreva ou refine o prompt com o editor avançado, histórico de versões e melhoria por IA.
  </Card>

  <Card title="Base de conhecimento" href="/guides/knowledge/linking-agent">
    Conecte documentos, sites e Q\&A à base de conhecimento do agente.
  </Card>

  <Card title="Chat interno" href="/guides/agents/settings/internal-chat">
    Teste o agente antes de publicá-lo em qualquer canal externo.
  </Card>
</CardGroup>