> ## 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. # Conceitos > Glossário dos termos e conceitos fundamentais do Gennia Studio 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: | Componente | O que faz | | ---------------- | -------------------------------------------------------------------------------- | | **Prompt** | Instruções que definem o comportamento, tom e regras do agente | | **Knowledge** | Documentos que o agente consulta via busca semântica (RAG) | | **Tools** | Integrações com apps externos (Gmail, Slack, etc.) e APIs customizadas | | **Skills** | Conjuntos de instruções especializadas que o agente consulta conforme necessário | | **Computador** | Ambiente isolado onde o agente executa código Python com segurança | | **Sub-agentes** | Outros agentes que podem ser chamados para delegar tarefas específicas | | **Memória** | Contexto que persiste entre conversas (lembra de fatos e preferências) | | **Modelo de IA** | O LLM que processa as mensagens (GPT-4, Claude, Gemini, etc.) | ## 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 | Papel | O que pode fazer | | ---------- | --------------------------------------------------------------- | | **Owner** | Controle total: billing, exclusão do workspace, tudo | | **Admin** | Gerencia agentes, canais, integrações e membros | | **Member** | Cria e edita agentes, mas não gerencia membros ou configurações | ## Modelos de IA O Gennia suporta múltiplos provedores e modelos de IA: | Provedor | Modelos | | --------------- | ------------------------------------------------ | | **OpenAI** | GPT-4, GPT-4o, GPT-3.5 Turbo | | **Anthropic** | Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku | | **Google** | Gemini | | **Together AI** | Modelos open-source hospedados | Cada agente pode usar um modelo diferente. O consumo de tokens é rastreado para controle de custos.