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.
manage_people com a ação enable/disable. Não é necessário reiniciar.Como Funciona
- Adicione contatos — adicione pessoas manualmente ou deixe o aidaemon aprender sobre elas nas conversas
- Lembre detalhes — aniversários, preferências, interesses, informações de trabalho e mais
- Vincule identidades — conecte uma pessoa à sua identidade no Telegram, Slack ou Discord
- Lembretes proativos — o aidaemon naturalmente menciona aniversários próximos e sugere reconexões
- 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ção | Descrição | Parâmetros Obrigatórios |
|---|---|---|
enable | Ativar a Inteligência de Pessoas (persiste entre reinicializações) | — |
disable | Desativar a Inteligência de Pessoas (dados são preservados) | — |
status | Mostrar estado habilitado/desabilitado e contagem de contatos | — |
add | Adicionar uma nova pessoa | name |
list | Listar todos os contatos (filtrar por relacionamento) | — |
view | Visualizar detalhes da pessoa e todos os fatos | name ou id |
update | Atualizar campos da pessoa (relacionamento, notas, estilo) | name ou id |
remove | Excluir uma pessoa e todos os seus fatos | name ou id |
add_fact | Armazenar um fato sobre alguém (aniversário, preferência, etc.) | person_name, category, key, value |
remove_fact | Excluir um fato específico por ID | fact_id |
link | Vincular uma identidade de plataforma a uma pessoa | person_name, platform_id |
export | Exportar todos os dados de uma pessoa como JSON | person_name |
purge | Exclusão em cascata completa (pessoa + fatos + vínculos) | person_name |
audit | Revisar fatos extraídos automaticamente (não verificados) | — (ou person_name) |
confirm | Verificar um fato extraído automaticamente (define confiança em 100%) | fact_id |
Parâmetros
| Key | Type | Default | Description |
|---|---|---|---|
action | string | — | Ação a executar (obrigatório) |
name | string | null | Nome da pessoa (para add, view, update, remove) |
id | integer | null | ID da pessoa no banco de dados (para update, remove) |
relationship | string | null | Tipo de relacionamento: spouse, family, friend, coworker, acquaintance |
notes | string | null | Notas de texto livre sobre a pessoa |
communication_style | string | null | Como se comunicar: casual, formal, warm, etc. |
language | string | null | Idioma preferido para interação |
person_name | string | null | Nome da pessoa (para add_fact, link, export, purge, audit) |
category | string | null | Categoria do fato: birthday, preference, interest, work, family, important_date, personality, gift_idea |
key | string | null | Chave do fato (ex.: 'birthday', 'favorite_food') |
value | string | null | Valor do fato |
platform_id | string | null | ID qualificado da plataforma (ex.: 'slack:U123', 'telegram:456') |
display_name | string | null | Nome de exibição para a identidade da plataforma |
fact_id | integer | null | ID 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.
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.
[people]
enabled = trueAprendizado 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
auditeconfirm
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_daysdias (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_daysdias (padrão 30)
Modelo de Privacidade
| Contexto | Comportamento |
|---|---|
| DMs do proprietário | Grafo 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úblicos | Nenhum fato pessoal injetado |
Configuração
[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| Key | Type | Default | Description |
|---|---|---|---|
enabled | bool | false | Estado inicial (pode ser alternado em tempo de execução via chat) |
auto_extract | bool | true | Aprender fatos sobre pessoas a partir das conversas automaticamente |
auto_extract_categories | string[] | [...] | Categorias que podem ser extraídas automaticamente |
restricted_categories | string[] | [...] | Categorias que nunca são extraídas automaticamente |
fact_retention_days | integer | 180 | Dias antes de fatos não confirmados serem removidos |
reconnect_reminder_days | integer | 30 | Dias de inatividade antes de sugerir uma reconexão |