Conceitos

Antes de mergulhar na plataforma, é importante entender os conceitos que você vai encontrar em todo o Gennia Studio.

​

Workspace

O espaço de trabalho compartilhado onde seu time cria e gerencia tudo. Cada workspace tem seus próprios agentes, canais, membros e configurações. Você pode ter múltiplos workspaces para separar projetos ou empresas.

​

Agente

Uma IA autônoma e configurável que conversa com usuários, consulta documentos, executa código e realiza ações em serviços externos. Cada agente pode ter:

​

Canal

O ponto de contato entre o agente e os usuários finais. Um agente pode estar conectado a múltiplos canais ao mesmo tempo:

• WhatsApp API Oficial — integração direta via Meta WhatsApp Business API
• Z-API — integração com WhatsApp via Z-API
• Widget — chat incorporável em qualquer site

​

Hub White-Label

O portal personalizado com a sua marca onde seus clientes acessam e gerenciam os agentes. No hub você configura:

• Identidade visual — logo, cores, tema
• Domínio próprio — seus clientes acessam via ia.suaempresa.com.br
• Onboarding — o fluxo que novos clientes veem ao entrar
• Planos e billing — gerencie o que cada cliente pode usar e quanto paga

Seus clientes nunca veem a marca Gennia — eles veem a sua empresa.

​

Thread

Uma conversa entre um usuário final e um agente. Cada thread mantém o histórico completo de mensagens e pode ser acompanhada pelo painel de Threads.

​

Human

Um contato ou usuário final que interage com seus agentes. O painel de Humans centraliza todos os contatos do workspace.

​

Knowledge (Base de Conhecimento)

Documentos que o agente consulta usando busca semântica (RAG). Quando um usuário faz uma pergunta, o agente busca automaticamente os trechos mais relevantes dos documentos antes de responder — em vez de inventar informações. A busca combina similaridade semântica (entende o significado) com busca por palavras-chave para máxima precisão. Formatos suportados: PDF, DOCX, TXT, CSV

​

Tool (Ferramenta)

Uma capacidade extra que o agente pode usar durante uma conversa. Existem três tipos:

• Integrações (Composio) — Conexões com 150+ apps como Gmail, Slack, Google Sheets, Salesforce, HubSpot
• APIs customizadas (HTTP) — Endpoints REST que você define manualmente para sistemas internos ou proprietários
• Servidores MCP — Integrações via Model Context Protocol para ferramentas externas avançadas

​

Skill

Conjuntos de instruções organizados em pastas que o agente pode consultar conforme necessário. Funcionam como guias especializados — quando o agente encontra uma situação que se encaixa em uma skill, ele segue aquelas instruções automaticamente. Útil para padronizar respostas, definir procedimentos específicos ou ensinar o agente a lidar com cenários complexos.

​

Sub-agente

Um agente que pode ser chamado por outro agente para delegar tarefas. O agente principal envia uma solicitação, o sub-agente executa de forma independente (com suas próprias ferramentas e conhecimento) e retorna o resultado. Útil para dividir tarefas complexas em partes menores e especializadas.

​

Memória

Sistema de memória de longo prazo que permite ao agente lembrar informações entre conversas. O agente retém fatos, preferências e contexto relevante — não todas as mensagens, mas o que é importante para personalizar interações futuras.

​

Computador (Sandbox)

Ambiente isolado onde o agente executa código Python com segurança. O computador impede que código afete o sistema principal e permite que o agente faça cálculos, processamento de dados e manipule arquivos.

​

Human-in-the-Loop (HITL)

Mecanismo de aprovação humana para ações sensíveis. Quando o agente tenta executar uma ferramenta marcada como “requer aprovação”, a execução pausa e um humano pode aprovar ou rejeitar a ação antes que ela aconteça.

​

Automação

Um fluxo de automação que pode ser disparado manualmente, por agendamento ou por eventos externos (webhooks). Automações permitem criar processos automatizados que combinam agentes, condições e ações — sem código.

​

Conexão

Uma integração autenticada com um serviço externo. O usuário autoriza o acesso (geralmente via OAuth) e a conexão fica disponível para os agentes usarem como ferramenta. Gerenciadas pelo Hub de Conexões.

​

Aba de Teste

O ambiente onde você conversa com o agente antes de publicá-lo. Permite ajustar o prompt, testar cenários e verificar quais documentos o agente está consultando e quais ferramentas está usando.

​

Papéis e permissões

​

Modelos de IA

O Gennia suporta múltiplos provedores e modelos de IA: Cada agente pode usar um modelo diferente. O consumo de tokens é rastreado para controle de custos.