EN·ES·DE·PT·FR
⌘K

Inteligência de Pessoas

Pense nisso como uma agenda de contatos, mas com um assistente pessoal que lembra dos detalhes para você. Aniversários, preferências, estilos de comunicação, como você conhece alguém — o aidaemon mantém tudo organizado e te lembra quando importa. Tudo fica no seu computador ou servidor, nunca é enviado a terceiros.

Ativação em Tempo de Execução
A Inteligência de Pessoas pode ser habilitada ou desabilitada a qualquer momento via chat. Basta dizer "enable people intelligence" ou usar a ferramenta manage_people com a ação enable/disable. Não é necessário reiniciar.

Como Funciona

  1. Adicione contatos — adicione pessoas manualmente ou deixe o aidaemon aprender sobre elas nas conversas
  2. Lembre detalhes — aniversários, preferências, interesses, informações de trabalho e mais
  3. Vincule identidades — conecte uma pessoa à sua identidade no Telegram, Slack ou Discord
  4. Lembretes proativos — o aidaemon naturalmente menciona aniversários próximos e sugere reconexões
  5. Adaptação de contexto — quando uma pessoa conhecida envia mensagem, o aidaemon adapta seu estilo de comunicação

Nome da Ferramenta

manage_people

Ações

AçãoDescriçãoParâmetros Obrigatórios
enableAtivar a Inteligência de Pessoas (persiste entre reinicializações)
disableDesativar a Inteligência de Pessoas (dados são preservados)
statusMostrar estado habilitado/desabilitado e contagem de contatos
addAdicionar uma nova pessoaname
listListar todos os contatos (filtrar por relacionamento)
viewVisualizar detalhes da pessoa e todos os fatosname ou id
updateAtualizar campos da pessoa (relacionamento, notas, estilo)name ou id
removeExcluir uma pessoa e todos os seus fatosname ou id
add_factArmazenar um fato sobre alguém (aniversário, preferência, etc.)person_name, category, key, value
remove_factExcluir um fato específico por IDfact_id
linkVincular uma identidade de plataforma a uma pessoaperson_name, platform_id
exportExportar todos os dados de uma pessoa como JSONperson_name
purgeExclusão em cascata completa (pessoa + fatos + vínculos)person_name
auditRevisar fatos extraídos automaticamente (não verificados)— (ou person_name)
confirmVerificar um fato extraído automaticamente (define confiança em 100%)fact_id

Parâmetros

KeyTypeDefaultDescription
actionstringAção a executar (obrigatório)
namestringnullNome da pessoa (para add, view, update, remove)
idintegernullID da pessoa no banco de dados (para update, remove)
relationshipstringnullTipo de relacionamento: spouse, family, friend, coworker, acquaintance
notesstringnullNotas de texto livre sobre a pessoa
communication_stylestringnullComo se comunicar: casual, formal, warm, etc.
languagestringnullIdioma preferido para interação
person_namestringnullNome da pessoa (para add_fact, link, export, purge, audit)
categorystringnullCategoria do fato: birthday, preference, interest, work, family, important_date, personality, gift_idea
keystringnullChave do fato (ex.: 'birthday', 'favorite_food')
valuestringnullValor do fato
platform_idstringnullID qualificado da plataforma (ex.: 'slack:U123', 'telegram:456')
display_namestringnullNome de exibição para a identidade da plataforma
fact_idintegernullID do fato (para remove_fact, confirm)

Habilitando

Existem duas formas de habilitar a Inteligência de Pessoas:

Opção 1: Via chat (recomendado)

Basta dizer ao seu bot para habilitar. A configuração é armazenada no banco de dados e persiste entre reinicializações.

chat
You: "Enable people intelligence"
aidaemon: "People Intelligence enabled. I'll now remember contacts..."

Opção 2: Via config.toml

Defina o estado inicial no seu arquivo de configuração. Este valor é usado para inicializar o banco de dados na primeira execução; depois disso, a configuração em tempo de execução tem precedência.

config.toml
[people]
enabled = true

Aprendizado Orgânico

Quando auto_extract está habilitado (padrão), o aidaemon aprende automaticamente sobre pessoas a partir das conversas durante seu ciclo regular de consolidação de memória:

  • Detecta menções a pessoas, suas preferências, aniversários e relacionamentos
  • Cria registros de pessoas e armazena fatos com 70% de confiança (extraídos automaticamente)
  • O proprietário pode revisar e confirmar fatos via as ações audit e confirm
Categorias Restritas
Informações de saúde, detalhes financeiros, opiniões políticas e crenças religiosas nunca são extraídas automaticamente, mesmo se mencionadas na conversa. Isso é aplicado por restricted_categories.

Tarefas em Segundo Plano

Quando habilitado, o aidaemon executa verificações diárias em segundo plano:

  • Limpeza de fatos obsoletos — remove fatos extraídos automaticamente não confirmados com mais de fact_retention_days dias (padrão 180)
  • Lembretes de datas próximas — detecta aniversários e datas importantes dentro de 14 dias
  • Sugestões de reconexão — sinaliza pessoas que não foram contatadas em reconnect_reminder_days dias (padrão 30)

Modelo de Privacidade

ContextoComportamento
DMs do proprietárioGrafo completo de pessoas injetado no prompt do sistema (nomes, fatos, relacionamentos)
Não-proprietário (vinculado)Apenas adaptação de estilo de comunicação (sem injeção de fatos para outros usuários)
Canais públicosNenhum fato pessoal injetado

Configuração

config.toml
[people]
enabled = true
auto_extract = true
auto_extract_categories = ["birthday", "preference", "interest", "work", "family", "important_date"]
restricted_categories = ["health", "finance", "political", "religious"]
fact_retention_days = 180
reconnect_reminder_days = 30
KeyTypeDefaultDescription
enabledboolfalseEstado inicial (pode ser alternado em tempo de execução via chat)
auto_extractbooltrueAprender fatos sobre pessoas a partir das conversas automaticamente
auto_extract_categoriesstring[][...]Categorias que podem ser extraídas automaticamente
restricted_categoriesstring[][...]Categorias que nunca são extraídas automaticamente
fact_retention_daysinteger180Dias antes de fatos não confirmados serem removidos
reconnect_reminder_daysinteger30Dias de inatividade antes de sugerir uma reconexão