Configuração de IA
O Campbooks usa IA para triage da caixa de entrada, análise de documentos, respostas rascunhadas e o assistente Scout. A IA é opcional — a aplicação funciona totalmente sem ela, e estas funcionalidades ativam-se assim que adicionar uma chave de fornecedor. Pode combinar fornecedores e atribuí-los a diferentes tarefas.
Dois papéis: texto e visão
Por mais tarefas de IA individuais que existam, a configuração resume-se a escolher dois modelos:
- Um modelo de texto — suporta triage, chat, resumos, respostas rascunhadas e lembretes. Qualquer fornecedor funciona.
- Um modelo de visão — lê os anexos de documentos para os classificar e extrair. Tem de ser um fornecedor com capacidade de visão (OpenAI, Anthropic ou Gemini).
Se definir uma única chave OpenAI, esta cobre ambos os papéis mais os embeddings usados para pesquisa semântica. É a configuração mais simples possível.
Os serviços de IA
Internamente, esses dois papéis distribuem-se por oito serviços, cada um dos quais pode usar um fornecedor diferente se pretender controlo detalhado:
| Serviço | Papel | Finalidade |
|---|---|---|
| Análise de Documentos | Visão | Classificar e extrair anexos de documentos |
| Classificação de Email | Texto | Categorizar emails recebidos |
| Análise de Email | Texto | Extrair itens de ação e sinais |
| Extração de Lembretes | Texto | Identificar compromissos com data e transformá-los em lembretes |
| Chat de Email | Texto | Conversar sobre um thread de email específico |
| Rascunho de Resposta | Texto | Gerar rascunhos de resposta a emails |
| Chat de Composição | Texto | Assistir durante a composição de uma mensagem |
| Chat Global | Texto | O assistente Scout |
Fornecedores
O Campbooks suporta cinco fornecedores. Três têm capacidade de visão (necessária para análise de documentos); todos os cinco tratam de texto.
| Fornecedor | Visão | Residência de dados | Chave de ambiente |
|---|---|---|---|
| OpenAI | ✓ | EUA | OPENAI_API_KEY |
| Anthropic (Claude) | ✓ | EUA | ANTHROPIC_API_KEY |
| Gemini | ✓ | EUA | GEMINI_API_KEY |
| Mistral | — | UE | MISTRAL_API_KEY |
| DeepSeek | — | China | DEEPSEEK_API_KEY |
A residência de dados é importante para o RGPD. O Mistral processa na UE, razão pela qual é o padrão preferido para utilizadores europeus; os restantes são transferências internacionais, e o DeepSeek (China) não tem decisão de adequação da UE. A região do fornecedor é mostrada nas definições de IA para que possa escolher com consciência.
Modelos
Cada fornecedor expõe vários modelos; escolha um por serviço (o predefinido em negrito):
| Fornecedor | Modelos |
|---|---|
| Anthropic | claude-sonnet-4-6, claude-haiku-4-5, claude-opus-4-7, claude-sonnet-4-5 |
| OpenAI | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-4, o3-mini, o4-mini |
| Mistral | mistral-large-latest, mistral-medium-latest, mistral-small-latest, ministral-8b-latest |
| DeepSeek | deepseek-v4-pro, deepseek-chat, deepseek-reasoner |
| Gemini | gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash |
De onde vêm as chaves
Há duas formas de fornecer chaves:
- Auto-alojado (para toda a instância): defina as chaves de ambiente do fornecedor acima em
.env. ComSELF_HOSTED=1, a aplicação lê-as e todos os espaços de trabalho podem usar IA sem introduzir a sua própria chave. - Por espaço de trabalho (traga a sua): um utilizador adiciona uma chave em Definições → IA. É encriptada em repouso e limitada a esse espaço de trabalho.
Adicionar um adaptador de IA
- Aceda a Definições → IA e clique em Adicionar adaptador.
- Escolha o fornecedor (OpenAI, Anthropic, Mistral, DeepSeek ou Gemini).
- Introduza a chave de API — ou deixe em branco para reverter para a chave de ambiente da instância (auto-alojado).
- Opcionalmente, defina um URL de endpoint personalizado para encaminhar através de um gateway compatível com OpenAI ou de um servidor de modelo local/auto-alojado (o URL é validado para bloquear pedidos a infraestrutura interna).
- Escolha o modelo.
Depois, atribua o adaptador aos serviços que o devem usar — ou apenas defina os dois papéis durante a configuração e deixe-os distribuir-se.
Atribuir adaptadores a serviços
Cada serviço pode usar um adaptador diferente. Em Definições → IA, expanda um serviço e escolha o seu adaptador. A alteração tem efeito imediato — pode assim usar um modelo rápido e económico para classificação e um mais capaz para análise e chat.
A análise de documentos requer um fornecedor com visão. Se atribuir um fornecedor só de texto (DeepSeek ou Mistral) à Análise de Documentos, a aplicação não permitirá guardar. Use OpenAI, Anthropic ou Gemini para esse serviço.
Pesquisa semântica
Os embeddings suportam a pesquisa semântica em email e documentos e são produzidos pelo OpenAI ou Gemini. Sem nenhum configurado, a pesquisa continua a funcionar — reverte para correspondência por palavras-chave (ILIKE).
Testes
Após configurar um adaptador, teste-o enviando uma mensagem no Scout ou reprocessando um documento. Se ocorrer um erro, verifique se a chave de API e (se definido) o endpoint estão corretos, se o nome do modelo é um que o fornecedor aceita e se o fornecedor suporta a funcionalidade que está a usar (por exemplo, visão para análise de documentos).