Documentação

O que é o JoaquAIm

O JoaquAIm é um assistente de IA em estilo chat, associado a um workspace (espaço de trabalho) isolado. Cada cliente ou equipa pode ter o seu workspace, com memória, conversas e ferramentas separadas. O assistente pode executar tarefas no teu ambiente (por exemplo via Cursor CLI), integrar com Odoo, Google Drive, calendário e outros serviços através de MCPs (Model Context Protocol).

Como começar

Na landing podes subscrever e obter acesso. Após o pagamento (Stripe), recebes um link de acesso ao teu workspace. Entra com o token enviado por email e começa a conversar. O assistente usa modelos como Grok, Gemini ou OpenAI conforme a configuração do teu plano.

Workspaces e tokens

Cada workspace tem um token de acesso único. Quem tiver o token pode aceder ao chat e às ferramentas desse workspace. Podes ter vários workspaces (por exemplo por projeto ou cliente). O gasto com Cursor/API pode ser controlado por workspace usando tokens Cursor diferentes por cliente (configurável no painel admin).

Integrações (Odoo, Drive, etc.)

O JoaquAIm integra com Odoo (tickets, atividades, contactos), Google Drive, Google Calendar, Gmail e outras ferramentas via MCPs. A configuração é feita no servidor ou por workspace. Para Odoo, usa-se ficheiro de configuração global (~/.joaquaim_odoo_config.json) ou variáveis de ambiente.

APIs e saúde do serviço

Para monitorização e load balancers:

• GET /api/health – Liveness (resposta rápida {"status":"ok"}).
• GET /api/ready – Readiness (verifica base de dados e, se configurado, Redis). Retorna 200 quando pronto a receber tráfego, 503 caso contrário.

Em produção podes usar LOG_FORMAT=json para logs em JSON (Loki, CloudWatch, Datadog). Para escalar horizontalmente, configura REDIS_URL para sessões partilhadas entre workers.