Documentation
Documentação

Bem-vindo ao WeOS

O sistema operacional de IA para empresas. Tudo que você precisa para construir, orquestrar e governar agentes de IA em escala empresarial.

O que é o WeOS?

O WeOS é uma plataforma operacional de IA projetada para empresas que precisam de controle, governança e escala. É a infraestrutura sobre a qual seus agentes de IA operam.

A analogia do sistema operacional: Assim como o Windows ou Linux gerenciam processos, memória e dispositivos de um computador, o WeOS gerencia agentes, conexões, fluxos de decisão e dados da sua empresa. Os AIWares são os "softwares" que rodam sobre essa infraestrutura.

Duas camadas, uma operação

WeOS

WeOS — A Infraestrutura

Orquestra agentes, gerencia conexões, audita decisões, controla acesso e garante compliance. A "casa" onde tudo roda.

AIWare

AIWare — O Software

Configuração específica de agentes, fluxos e regras para um processo de negócio. Roda sobre o WeOS. É o seu produto, com sua marca.

Capacidades Principais

Orquestração de Agentes

Gerenciamento centralizado de todos os agentes com memória persistente e contexto empresarial.

Governança por Arquitetura

RBAC granular, trilha de auditoria imutável e compliance LGPD integrado desde o design.

Integração Universal

+200 conectores nativos para CRM, ERP, bancos de dados, APIs e canais de comunicação.

Observabilidade Total

Custos por agente, logs de decisão, performance de fluxos e alertas em tempo real.

Recursos da Plataforma

O WeOS é composto por seis módulos principais que trabalham juntos para criar uma plataforma completa de IA empresarial.

AIWare

AIWares são soluções verticais de IA configuradas sobre o WeOS. Cada AIWare agrupa agentes, fluxos e bases de conhecimento para resolver um processo de negócio específico.

AIWare não tem API própria: Todo acesso a um AIWare é feito através da API do WeOS. O AIWare é uma configuração dentro da plataforma, não um serviço independente. Isso garante governança centralizada de todas as operações.

Catálogo de AIWares

SDR Autônomo

Qualificação de leads 24/7 com análise de perfil e atualização de CRM

CS com Memória Real

Atendimento omnicanal com memória real e acesso a base de conhecimento

Triagem & Onboarding RH

Da triagem de CVs ao onboarding personalizado de colaboradores

Conciliação Financeira

Conciliação bancária autônoma com detecção de anomalias

Análise de Contratos

Busca semântica e análise de risco em repositórios jurídicos

AIWare Customizado

Construído para o seu processo específico, com seus dados e regras

Agentes

Agentes são a força de trabalho digital do WeOS. Executam tarefas, tomam decisões e aprendem com o contexto da sua empresa. Possuem memória persistente de curto e longo prazo.

Memória Persistente

Curto prazo (sessão) e longo prazo (workspace)

Multi-modelo

GPT-4o, Claude, Gemini, Llama e mais de 20 modelos

Especialização

Configurados por departamento e processo

Conexões

Integre o WeOS com qualquer sistema em minutos. +200 conectores nativos para CRM, ERP, banco de dados, APIs, planilhas e canais de comunicação. Seus sistemas existentes não mudam — o WeOS se adapta a eles.

json
# Exemplo: Conexão com Salesforce via API WeOS
POST /api/v2/public/connections
{
  "type": "salesforce",
  "name": "CRM Produção",
  "credentials": {
    "instance_url": "https://company.salesforce.com",
    "access_token": "<token>"
  }
}

Fluxos

O editor visual de fluxos permite que qualquer gestor desenhe como os agentes devem se comportar. Aprovações, condições, bifurcações e escalonamentos — tudo no diagrama, sem código. Versionamento e rollback instantâneo.

Marketplace

A maior biblioteca de IA do mundo. Mais de 4.300 itens incluindo modelos de IA, servidores MCP, AIWares, nós de automação, módulos IoT e widgets. Todos disponíveis para adicionar ao seu workspace com um clique.

Arquitetura

O WeOS é arquitetado em camadas que separam responsabilidades: infraestrutura, orquestração, execução e observabilidade.

1

Camada de Infraestrutura

Cloud, On-Premise ou Híbrido. Seus dados nunca saem do seu ambiente.

2

Camada de Orquestração

WeOS Runtime gerencia agentes, sessões, runs e memória persistente.

3

Camada de Execução

Agentes executam tarefas usando LLMs, ferramentas e conexões.

4

Camada de Observabilidade

Logs, métricas, custos e auditoria imutável de cada ação.

Modos de Deploy

Cloud Gerenciado

Infraestrutura gerenciada pela WeGen-AI. Zero config, SLA 99.9%, escalabilidade automática.

On-Premise

Deploy no seu datacenter ou cloud privada. Dados nunca saem do seu ambiente. Ideal para regulados.

Híbrido

Orquestração na nuvem WeGen, execução de agentes no seu ambiente. Máxima flexibilidade.

Boas Práticas

Recomendações para times que estão implementando WeOS em produção.

Nomenclatura de Agentes

Use nomes descritivos que indicam departamento, função e versão. Ex: `vendas-sdr-qualificacao-v2`. Facilita observabilidade e auditoria.

Gestão de Memória

Separe memória de curto prazo (sessão) e longo prazo (workspace). Evite passar dados sensíveis em contexto de agente quando storage local é opção.

RBAC e Permissões

Aplique o princípio do menor privilégio. Cada agente deve ter acesso apenas às conexões e bases de conhecimento necessárias para sua função.

Trilha de Auditoria

Ative auditoria completa em fluxos que envolvem dados financeiros, de saúde ou jurídicos. A trilha imutável é requisito de compliance para regulados.

Teste de Fluxos

Use o ambiente de staging para testar fluxos com dados sintéticos antes de produção. Versione fluxos e mantenha rollback disponível.

Controle de Custos

Configure alertas de custo por agente no módulo de Observabilidade. Defina limites de token por sessão para agentes de alto volume.

API Reference v2

A API pública do WeOS v2 permite integrar a plataforma com qualquer sistema externo. Todas as operações passam pela API — incluindo execução de AIWares.

URL Base

url
https://api-weos.wegen-ai.com/api/v2/public

Autenticação

Todas as requisições exigem autenticação via Bearer token. Obtenha o token no painel WeOS em Configurações → API Keys.

http
Authorization: Bearer <WORKSPACE_PUBLIC_TOKEN>

Auth

Autenticação e troca de workspace.

Chat & Completions

Endpoints compatíveis com o padrão OpenAI para completions e responses.

Estes endpoints são compatíveis com o formato OpenAI — você pode usar SDKs OpenAI apontando para a URL base do WeOS.

Agents

Gerenciamento e execução de agentes WeOS.

Sessions

Sessões mantêm contexto de conversas multi-turn com agentes.

Runs

Runs são execuções individuais de agentes ou fluxos. Cada run tem um ID rastreável.

Models, Tools & MCP

Acesso ao catálogo de modelos, ferramentas e servidores MCP disponíveis.

Multimedia

Geração de imagens, síntese de voz e transcrição de áudio.

Router & Workflows

Roteamento inteligente de requisições e execução de workflows.

Health

Verificação de status da API.

Documentação AIWare

AIWares são configurados e operados inteiramente através do WeOS. Não existe API separada para AIWares — toda integração usa os endpoints `/agents`, `/sessions` e `/runs` da API v2.

Como integrar um AIWare via API

01

Liste os agentes do workspace (`GET /api/v2/public/agents`) para obter o ID do agente do AIWare.

02

Crie uma sessão ou use `run` direto se não precisar de histórico.

03

Execute o agente via `POST /api/v2/public/agents/{id}/run` ou `/stream` para streaming.

bash
# 1. Listar agentes (encontrar ID do AIWare)
curl https://api-weos.wegen-ai.com/api/v2/public/agents -H "Authorization: Bearer <token>"

# 2. Executar o AIWare via agents/{id}/run
curl -X POST https://api-weos.wegen-ai.com/api/v2/public/agents/agent_sdr_abc/run \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"input": "Lead: Maria Silva, Diretora, 200 funcionários"}'

Configuração via WeOS

AIWares são configurados no painel WeOS sem código. O editor visual permite:

  • Definir a persona e instruções do agente
  • Conectar bases de conhecimento e conexões externas
  • Configurar fluxos de decisão e aprovação
  • Definir permissões de acesso por departamento
  • Ativar auditoria e alertas

Política de Uso

O uso da plataforma WeOS está sujeito aos seguintes termos e diretrizes.

Uso Aceitável

  • Automação de processos de negócio internos
  • Atendimento ao cliente com supervisão humana configurada
  • Análise de documentos e dados proprietários da organização
  • Integração com sistemas terceiros mediante autorização
  • Desenvolvimento e teste de AIWares em ambiente staging

Uso Proibido

  • Geração de conteúdo enganoso, difamatório ou ilegal
  • Processamento de dados de menores sem consentimento parental
  • Tentativas de bypass dos controles de governança da plataforma
  • Uso de credenciais de terceiros sem autorização
  • Ataques de negação de serviço ou exploração de vulnerabilidades

Retenção de Dados

Logs de execução são retidos por 90 dias no plano Professional e período customizado no Enterprise. Dados de sessão podem ser configurados para retenção automática.

Rate Limits

Os limites variam por plano. O plano Starter permite 100 req/min. Professional e Enterprise têm limites customizados. Respostas HTTP 429 indicam rate limit atingido — implemente exponential backoff.

Política de Privacidade

Última atualização: Janeiro 2025

A WeGen-AI Tecnologia LTDA está comprometida com a proteção dos dados pessoais de seus clientes e usuários, em conformidade com a Lei Geral de Proteção de Dados (LGPD — Lei nº 13.709/2018).

Dados Coletados

Coletamos apenas os dados necessários para prestação do serviço:

  • Dados de cadastro: nome, email, empresa, cargo
  • Dados de uso: logs de execução, métricas de performance, custos por agente
  • Dados de infraestrutura: IPs de acesso, timestamps de autenticação
  • Dados processados por agentes: conforme configuração do cliente (dados em trânsito, não armazenados por padrão)

Finalidade do Tratamento

  • Prestação e melhoria contínua dos serviços WeOS
  • Suporte técnico e comunicação sobre o serviço
  • Compliance com obrigações legais e regulatórias
  • Segurança e prevenção de fraudes

Seus Direitos (LGPD)

  • Confirmação de existência de tratamento
  • Acesso aos dados
  • Correção de dados incompletos ou incorretos
  • Anonimização, bloqueio ou eliminação de dados desnecessários
  • Portabilidade dos dados
  • Revogação do consentimento

Contato — DPO

Para exercer seus direitos ou esclarecer dúvidas sobre privacidade, entre em contato com nosso Data Protection Officer:

privacy@wegen-ai.com