StaffDeck Open Source: Uma Plataforma Empresarial para Construir Funcionários Digitais

Introdução

Em 15 de julho de 2026, a OpenBMB tornou o StaffDeck open source, uma plataforma empresarial projetada para construir, operar e gerenciar funcionários digitais.

O projeto segue um caminho diferente dos chatbots empresariais comuns. Em vez de tratar a IA como uma janela de conversa temporária, o StaffDeck visa transformar experiência profissional, processos de negócios, procedimentos operacionais padrão e critérios de decisão em funcionários digitais capazes de trabalhar continuamente e melhorar constantemente.

O código-fonte foi publicado publicamente no GitHub, juntamente com pacotes de instalação para desktop em macOS, Windows e Linux. O StaffDeck também pode ser implantado a partir do código-fonte usando endpoints de modelo compatíveis com OpenAI.

De Chatbots Empresariais a Funcionários Digitais

Muitos produtos de IA empresarial ainda começam e terminam em uma interface de chat. O usuário abre uma conversa, faz uma pergunta, recebe uma resposta e fecha a sessão.

Esse padrão é útil para tarefas auxiliares simples, mas mostra suas limitações quando a empresa deseja que a IA participe de trabalhos repetíveis.

Um funcionário digital precisa de mais do que apenas capacidade de conversação. Ele deve entender seu próprio cargo, seguir regras organizacionais, usar conhecimento aprovado, chamar ferramentas, salvar registros de execução e apoiar a intervenção humana quando necessário.

O StaffDeck é construído em torno dessa ideia mais ampla. Ele caracteriza funcionários digitais por meio de atributos organizacionais, como:

• Cargo e limites de função
• Identidade do funcionário
• Perfil de competências
• Recursos de conhecimento
• Habilidades e procedimentos operacionais padrão
• Permissões de ferramentas
• Registros de trabalho e execução
• Escopo de acesso
• Histórico de feedback e melhoria

Essa estrutura aproxima o sistema de uma plataforma de gerenciamento de funcionários digital, em vez de uma interface genérica de chatbot.

Transformando Conhecimento Organizacional em Capacidade Reutilizável

Um dos problemas mais difíceis nas operações empresariais é que o conhecimento valioso muitas vezes está espalhado.

Algumas informações estão registradas em documentos, outras estão incorporadas em planilhas e manuais de processos, e uma grande quantidade de conhecimento permanece na experiência de funcionários seniores, incluindo aqueles julgamentos sutis raramente formalmente documentados em procedimentos operacionais padrão.

Quando funcionários experientes saem ou mudam de função, parte desse conhecimento pode desaparecer.

O StaffDeck visa transformar múltiplas formas de conhecimento organizacional em capacidades digitais persistentes:

1. Experiência profissional
2. Processos de negócios
3. Procedimentos operacionais padrão
4. Critérios de decisão
5. Conhecimento documentado
6. Regras operacionais informais
7. Feedback gerado no trabalho real

O objetivo não é "imortalidade digital" literal, mas uma tentativa pragmática de tornar o conhecimento importante reutilizável, rastreável e mais fácil de melhorar.

Projeto Conjunto de Indústria, Academia e Pesquisa

O StaffDeck não se apresenta como um produto interno de uma única empresa.

De acordo com o repositório oficial, a plataforma foi desenvolvida conjuntamente por:

• ModelBest
• Laboratório Conjunto de Inteligência de Dados Northeastern University-ModelBest
• Laboratório de Processamento de Linguagem Natural da Universidade Tsinghua (THUNLP)
• OpenBMB
• AI9Stars

Essa combinação reúne pesquisa de modelos, processamento de linguagem natural, experiência em implantação empresarial e capacidade de engenharia open source.

O público-alvo inclui empresas e instituições que desejam transformar inteligência artificial de uma ferramenta de produtividade pessoal em uma capacidade organizacional reutilizável.

Funcionalidades Principais do StaffDeck

O projeto oficial descreve quatro áreas de capacidade.

Construir e Gerenciar Funcionários Digitais

Os usuários podem definir funcionários digitais com funções independentes, números de funcionário, arquivos de competência, permissões e registros de trabalho.

Funcionários digitais podem ser publicados, reutilizados ou ajustados de acordo com diferentes necessidades organizacionais. Um mecanismo de isolamento de permissões ajuda a evitar que cada usuário modifique diretamente recursos compartilhados.

Isso é particularmente útil quando a empresa deseja manter um conjunto aprovado de funções digitais controladas, em vez de permitir que cada funcionário construa robôs pessoais isolados.

Habilidades Processuais Orientadas por Máquina de Estados

O StaffDeck pode transformar descrições de processos em linguagem natural em procedimentos operacionais padrão estruturados, executados por meio de uma máquina de estados.

A máquina de estados ajuda a decompor tarefas complexas em fases definidas, condições de transição e ramificações de estado. Essa abordagem é mais previsível do que exigir que o modelo improvise todo o processo em um único prompt.

A plataforma suporta:

• Paralelismo de múltiplos processos
• Alternância de processos em tempo real
• Preservação de contexto
• Edição visual de processos
• Gerenciamento de versões
• Evolução por ramificações

Esses recursos são especialmente adequados para tarefas que devem seguir processos estáveis, mas ainda exigem julgamento limitado de IA.

Recuperação de Conhecimento com Consciência de Estrutura de Documentos

Sistemas de recuperação tradicionais geralmente dividem documentos em pequenos blocos de texto e pesquisam diretamente. Embora funcional, essa abordagem pode perder informações estruturais do original.

O StaffDeck constrói índices navegáveis em múltiplos níveis, como documentos, seções, páginas e resumos.

O funcionário digital pode primeiro estimar onde as informações relevantes podem estar localizadas e, em seguida, localizar com mais precisão o texto original.

A plataforma também suporta:

• Buckets de conhecimento independentes
• Recuperação precisa
• Citação de fontes
• Depuração de recuperação
• Acesso com consciência de permissões

Isso permite que as equipes entendam mais claramente por que o funcionário digital selecionou uma fonte específica.

Execução Autônoma e Melhoria Contínua

O StaffDeck pode executar tarefas por meio de interfaces HTTP, ferramentas de protocolo de contexto de modelo e tarefas agendadas.

O processo de execução não é uma caixa preta oculta. A plataforma registra eventos intermediários, como reconhecimento de intenção, recuperação, seleção de habilidades, uso de ferramentas, revisão e geração de resposta.

Em seguida, pode usar memória de longo prazo, feedback do usuário, registros de conversa e análise de feedback para melhorar as capacidades do funcionário digital.

Usuários humanos também podem intervir quando necessário, cancelar execuções, continuar tarefas na fila ou assumir tarefas.

Como o StaffDeck Retém Conhecimento Além de Conversas Únicas

A diferença mais importante entre uma plataforma de funcionários digitais e um chatbot padrão é a persistência.

Em produtos de chat comuns, a maior parte do contexto útil pertence a uma única conversa. Quando essa sessão termina, o conhecimento relevante pode não se tornar um ativo organizacional gerenciado.

O StaffDeck separa capacidades reutilizáveis do contexto de conversa temporário.

O funcionário digital pode reter e reutilizar:

• Bases de conhecimento aprovadas
• Definições de processos
• Habilidades
• Ferramentas conectadas
• Regras específicas do cargo
• Memória de longo prazo
• Registros de feedback
• Trilhas de execução
• Tarefas agendadas

Isso não significa que toda conversa deva se tornar automaticamente memória permanente. Sistemas empresariais ainda precisam seguir regras de permissão, proteção de privacidade, processos de revisão e políticas claras de retenção.

O ponto principal é que o conhecimento pode ser transformado conscientemente em um recurso controlável, em vez de ficar preso nos registros de chat pessoais dos funcionários.

Fluxo de Trabalho Principal

O fluxo de trabalho oficial do StaffDeck pode ser resumido em seis etapas.

1. Criar Funcionário Digital

Definir cargo, limites de função, estilo de serviço, criador e escopo de acesso.

Uma definição clara de função ajuda a evitar que o funcionário digital aja além de suas responsabilidades pretendidas.

2. Configurar Capacidades

Associar bases de conhecimento, habilidades gerais, procedimentos operacionais padrão e ferramentas.

As equipes podem copiar recursos do mercado ou criar os seus próprios, sem modificar modelos compartilhados originais.

3. Iniciar Sessão

Abrir o funcionário digital a partir do mercado ou da lista de funcionários e enviar a primeira solicitação.

Após o envio da primeira mensagem, a sessão formal será persistida.

4. Executar e Observar

Acompanhar os registros de execução enquanto o funcionário digital trabalha.

A interface pode exibir eventos relacionados a intenção, recuperação, habilidades, ferramentas, revisão e resposta final.

5. Intervir Quando Necessário

O usuário pode gerenciar solicitações na fila, cancelar execuções, transferir tarefas para processamento manual ou lidar com respostas pendentes.

Para tarefas incertas, sensíveis ou de alto impacto, a intervenção humana continua importante.

6. Otimizar Continuamente o Desempenho do Funcionário

Usar memória, feedback, logs de conversa e tarefas agendadas para otimizar o desempenho do funcionário digital.

Quando a equipe revisa casos de falha e atualiza conhecimento, definições de processos ou ferramentas, o funcionário digital se torna mais valioso.

Primeiros Passos com o StaffDeck

O artigo de origem anunciou o lançamento open source, mas não incluiu instruções de instalação. Os comandos a seguir foram retirados do repositório oficial do StaffDeck para que os leitores possam verificar e testar a plataforma diretamente.

Requisitos de Ambiente

Prepare o seguinte ambiente:

• macOS, Linux ou WSL (para scripts de desenvolvimento)
• Python 3.11 ou superior
• Node.js 20 ou superior
• npm
• Interface de chat de conclusão compatível com OpenAI
• Chave de API válida para o serviço de modelo escolhido

O StaffDeck em si não requer CUDA. As necessidades de hardware dependem da interface de modelo que você escolher executar ou acessar.

1. Clonar e Instalar

git clone https://github.com/OpenBMB/StaffDeck.git
cd StaffDeck

python3 -m venv backend/.venv
backend/.venv/bin/python -m pip install -e "backend[dev]"
npm --prefix enterprise ci
cp

backend/.env.example backend/.env

2. Configurar o modelo

Abra o arquivo backend/.env e defina a chave secreta da aplicação e as informações do serviço de modelo:

APP_SECRET="replace-with-a-long-random-secret"
DEMO_MODEL_BASE_URL="https://your-openai-compatible-endpoint/v1"
DEMO_MODEL_NAME="your-model-name"
DEMO_MODEL_API_KEY="your-api-key"

A chave da API é usada para criar a configuração inicial do modelo e é criptografada antes de ser armazenada no banco de dados.

Não envie o arquivo backend/.env para repositórios públicos.

Após a inicialização do serviço, também é possível gerenciar os provedores de modelo através do seguinte caminho:

Gerenciamento → Configuração de modelos

3. Iniciar a demonstração Web

DETACH=1 scripts/dev_up.sh

Este script compila o frontend e disponibiliza a interface, API e documentação Swagger na porta 5173 através do processo FastAPI.

As credenciais iniciais do administrador são:

Nome de usuário: admin
Senha: admin

Altere a senha padrão imediatamente após o primeiro login.

4. Verificar a instalação

Execute uma verificação de integridade:

curl http://127.0.0.1:5173/api/health

Resposta esperada:

{"status":"ok"}

Em seguida, abra:

http://127.0.0.1:5173/workspace/gallery

Selecione um funcionário digital e envie uma mensagem. A resposta e o registro de execução devem ser exibidos na mesma rodada de conversa.

Comandos comuns

scripts/dev_status.sh       # Verificar o status do serviço
scripts/dev_down.sh         # Parar o serviço local
scripts/dev_up.sh           # Executar em primeiro plano

Download da versão desktop

Usuários que não desejam implantar a partir do código-fonte podem usar a versão desktop publicada oficialmente pelo projeto StaffDeck.

Plataforma	Arquitetura	Pacote oficial
macOS	Apple Silicon, arm64	Download.dmg
Windows	x64	Download do instalador.exe
Linux	x86_64, Debian ou Ubuntu	Download.deb

Como o projeto ainda está em fase inicial de testes, as equipes devem testar cada versão em um ambiente controlado antes de usá-la para trabalhos importantes em produção.

Estrutura do projeto

O repositório oficial divide a aplicação em componentes de backend, frontend, documentação, scripts e empacotamento.

StaffDeck/
├── backend/                  # API FastAPI, runtime do agente, armazenamento e workers de tarefas
├── frontend-enterprise/      # Workspace StaffDeck em React/TypeScript
├── docs/                     # Tutoriais, API, definições de esquema e fluxos de exemplo
├── scripts/                  # Scripts de gerenciamento do ciclo de vida do serviço e validação
├── packaging/                # Recursos de empacotamento para macOS, Linux e Windows
├── README.md                 # Documentação em inglês
└── README.zh.md              # Documentação em chinês simplificado

O backend é baseado principalmente em Python, enquanto o frontend empresarial usa React e TypeScript.

Casos de uso empresarial

O StaffDeck pode servir como base para diversos papéis digitais internos.

Assistente de conhecimento interno

Funcionários digitais podem recuperar documentos da empresa aprovados, citar fontes e ajudar os funcionários a encontrar informações sobre processos ou políticas.

Assistente de execução de SOP

As equipes podem transformar processos repetitivos em fluxos estruturados e permitir que funcionários digitais orientem ou executem cada etapa.

Coordenador de operações

Através de tarefas agendadas e APIs conectadas, funcionários digitais podem monitorar trabalhos de rotina e acionar ações aprovadas.

Suporte ao cliente

Funcionários digitais podem integrar conhecimento do produto, regras de serviço e fluxos de escalonamento, mantendo registros de execução para revisão.

Assistente de pesquisa ou análise

O sistema pode consolidar materiais, seguir processos de pesquisa estabelecidos e reter as etapas usadas para gerar respostas.

Retenção de conhecimento especializado

Funcionários experientes podem converter critérios de julgamento, diretrizes de revisão e métodos de trabalho usados repetidamente em capacidades digitais reutilizáveis antes de mudar de cargo ou sair da organização.

Riscos e limitações

Código aberto não significa que sistemas de IA estejam automaticamente prontos para implantação empresarial irrestrita.

O repositório do StaffDeck lista várias limitações importantes:

• As respostas do modelo podem ser incorretas, incompletas ou inconsistentes.
• Registros de execução melhoram a auditabilidade, mas não garantem a correção.
• A qualidade da recuperação depende da qualidade dos documentos, análise, indexação, permissões e capacidade do modelo.
• Ferramentas externas podem ter efeitos colaterais reais.
• Tarefas agendadas requerem workers em execução contínua e configuração correta de fuso horário.
• Operações de alto risco devem usar credenciais com privilégios mínimos e exigir aprovação humana.
• A plataforma não substitui revisão profissional qualificada em áreas regulamentadas.
• Decisões importantes exigem autorização, proteção de privacidade e supervisão humana.

As organizações devem começar com fluxos de trabalho de baixo risco, limitar as permissões das ferramentas e revisar as saídas antes de expandir as responsabilidades do sistema.

Licença de código aberto

O StaffDeck é distribuído sob a Licença Pública Geral Affero GNU v3.0 (comumente chamada de AGPL-3.0).

As equipes que planejam modificar a plataforma ou fornecer serviços pela rede devem ler atentamente a licença. A AGPL-3.0 pode gerar obrigações de divulgação do código-fonte para versões modificadas fornecidas a usuários através de serviços de rede.

Para decisões comerciais ou legais, as organizações devem consultar o texto completo da licença e obter aconselhamento profissional quando necessário.

Perguntas frequentes

O que é StaffDeck?

StaffDeck é uma plataforma empresarial de código aberto para construir e gerenciar funcionários digitais. Ela integra definição de papéis, base de conhecimento, SOPs, ferramentas, permissões, memória e registros de execução em um único sistema.

Como StaffDeck difere de chatbots?

Chatbots lidam principalmente com conversas. Já o StaffDeck foi projetado para suportar papéis persistentes, conhecimento regulado, fluxos estruturados e

Ferramentas interconectadas, trabalhos agendados, registros de auditoria e melhoria contínua.

O StaffDeck pode ser executado sem uma GPU local?

Sim. O aplicativo se conecta a endpoints de modelo compatíveis com a OpenAI, portanto, o StaffDeck em si não requer uma GPU local. Os requisitos de hardware dependem se o serviço de modelo escolhido é implantado localmente ou hospedado remotamente.

Quais provedores de modelo o StaffDeck pode usar?

A plataforma requer um endpoint de conclusão de chat compatível com a OpenAI. A compatibilidade depende se o provedor implementa o comportamento de API necessário e se o modelo escolhido funciona corretamente com os fluxos de trabalho do StaffDeck.

O StaffDeck pode ser implantado no Windows?

O projeto oficial fornece um instalador de desktop para Windows x64. Para fluxos de trabalho de desenvolvimento baseados em código-fonte, o repositório suporta macOS, Linux ou Windows Subsystem for Linux como ambientes de execução.

Por que os usuários comuns podem usar recursos do mercado, mas não podem editá-los?

Os recursos do mercado são modelos compartilhados protegidos por permissões de criador e administrador. Usuários comuns podem copiar ou vincular recursos autorizados aos seus funcionários digitais, mas não podem modificar os recursos originais.

O StaffDeck está pronto para uso em produção?

O projeto é de código aberto e já inclui funcionalidades voltadas para empresas, mas a versão atual ainda está em estágio inicial de testes. As organizações devem realizar testes de segurança, privacidade, confiabilidade e fluxo de trabalho antes da implantação em produção.

Qual é a licença do StaffDeck?

O StaffDeck usa a licença AGPL-3.0. Organizações que modificam ou executam este software por meio de serviços de rede devem revisar os termos da licença e as obrigações relacionadas ao código-fonte.

Ferramentas relacionadas

• StaffDeck: Site oficial da plataforma de funcionários digitais empresariais.
• OpenBMB: Ecossistema de modelos grandes de código aberto que incubou o StaffDeck.
• FastAPI: Framework web Python usado para fornecer a API e o backend do aplicativo StaffDeck.
• React: Biblioteca front-end usada no espaço de trabalho empresarial do StaffDeck.
• Protocolo de Contexto de Modelo: Protocolo que o StaffDeck pode usar para conectar funcionários digitais a ferramentas externas.
• GitHub: Plataforma que hospeda o código-fonte, problemas, versões e histórico do projeto do StaffDeck.

Links relacionados

• Repositório GitHub do StaffDeck: Repositório oficial do código-fonte e principal referência técnica.
• Site oficial do StaffDeck: Site oficial do produto e entrada para documentação.
• Versões do StaffDeck: Lançamentos beta oficiais e pacotes de instalação para desktop.
• Documentação em inglês do StaffDeck: Informações oficiais sobre funcionalidades, etapas de implantação, fluxos de trabalho, riscos e licença.
• Documentação em chinês do StaffDeck: Documentação em chinês simplificado mantida no repositório do projeto.
• Feedback de problemas do StaffDeck: Canal oficial para relatos de bugs reproduzíveis e sugestões de funcionalidades.
• Organização OpenBMB no GitHub: Outros modelos, sistemas e projetos de código aberto mantidos pela OpenBMB.

Visão geral

O StaffDeck representa a transição de chatbots empresariais temporários para funcionários digitais contínuos. Ele é projetado para transformar conhecimento especializado, procedimentos operacionais padrão, regras de decisão, ferramentas e feedback em capacidades governáveis e reutilizáveis em toda a organização.

A plataforma integra gerenciamento de funções, fluxos de trabalho baseados em máquina de estados, recuperação ciente de estrutura, chamadas de API e ferramentas MCP, tarefas agendadas, memória de longo prazo, intervenção humana e registros detalhados de execução. O código-fonte, pacotes de instalação para desktop e instruções de implantação são disponibilizados publicamente.

O projeto ainda está em fase inicial de testes, portanto, as empresas devem começar com cenários controlados de baixo risco e implementar rigorosamente políticas de permissões, privacidade e revisão humana.

O princípio central do StaffDeck é direto: quando o conhecimento e os processos pertencem à organização, em vez de desaparecerem com o fim de uma conversa, o valor da IA empresarial aumenta significativamente.