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

# Quickstart

> Crie e publique seu primeiro agente em minutos

Este guia mostra o caminho mais rápido para ter um agente de IA funcionando e acessível para seus clientes.

## 1. Crie sua conta e workspace

Acesse o Gennia Studio e crie sua conta. Você será guiado para criar seu primeiro **workspace** — o espaço onde você e seu time gerenciam tudo.

## 2. Crie um agente

<Steps>
  <Step title="Vá em Agentes > Novo Agente">
    No menu lateral, na seção **Build**, clique em **Agentes** e depois em **Novo Agente**. Dê um nome e uma descrição.
  </Step>

  <Step title="Escreva o prompt">
    No editor de **Prompt**, defina o comportamento do agente: qual o papel dele, como deve responder, o que pode e não pode fazer.

    ```
    Você é o assistente de suporte da [Empresa]. Responda de forma 
    educada e objetiva. Use apenas informações da base de conhecimento. 
    Se não souber a resposta, diga que vai encaminhar para um humano.
    ```
  </Step>

  <Step title="Adicione conhecimento">
    Na seção **Knowledge**, faça upload de documentos (PDF, DOCX, TXT) que o agente deve consultar. Ele usa busca semântica para encontrar as informações relevantes automaticamente.
  </Step>

  <Step title="Conecte ferramentas e integrações">
    Na seção **Tools**, adicione integrações com apps como Gmail, Slack, Google Sheets ou defina APIs customizadas. O agente poderá executar ações nesses serviços durante as conversas.
  </Step>

  <Step title="Escolha o modelo de IA">
    No topo da sidebar do agente, selecione o modelo de IA (GPT-4, Claude, Gemini, entre outros) mais adequado para o seu caso.
  </Step>
</Steps>

## 3. Teste o agente

Na aba de **Teste**, abra uma janela de chat com o agente. Envie mensagens, teste perguntas difíceis e ajuste o prompt até o comportamento estar como você quer.

<Tip>
  Teste cenários onde o agente **não** deveria responder — isso é tão importante quanto testar os casos felizes.
</Tip>

## 4. Conecte um canal

Com o agente pronto, vá em **Canais** e conecte um canal de comunicação:

* **WhatsApp API Oficial** — integração direta via Meta WhatsApp Business API
* **Z-API** — integração com WhatsApp via Z-API
* **Widget** — chat incorporável no site do seu cliente

A partir desse momento, usuários finais podem conversar com o agente.

## 5. Configure seu hub white-label

Vá em **Hub > Definições** para personalizar o portal dos seus clientes:

* Defina **identidade visual** (logo, cores, tema)
* Configure um **domínio próprio** (ex: `ia.suaempresa.com.br`)
* Personalize o **onboarding** que seus clientes vão ver ao acessar

## 6. Cadastre seus clientes

Em **Hub > Clients**, cadastre seus clientes. Cada cliente recebe acesso ao hub com sua marca e pode gerenciar seus próprios agentes e conversas.

***

## E agora?

<Columns cols={3}>
  <Card title="Conceitos" icon="book" href="/pt/conceitos">
    Entenda os termos da plataforma.
  </Card>

  <Card title="Agentes" icon="robot" href="/pt/guides/agents">
    Configure agentes avançados.
  </Card>

  <Card title="Canais" icon="comments" href="/pt/guides/canais">
    Detalhes de cada canal.
  </Card>
</Columns>