raymondmdzz123/agent-memory

O que agent-memory faz?

Armazene memória persistente de agentes de IA com histórico de conversas, busca vetorial, base de conhecimento e extração de fatos em TypeScript.

Visão Geral

Esta skill oferece uma implementação completa para gerenciamento de memória de longo prazo em agentes de IA. Ela permite que seu agente se lembre de interações passadas, consulte informações relevantes e extraia fatos estruturados das conversas.

Funcionalidades

• Histórico de Conversas: Armazene e recupere todo o histórico de conversas do agente.
• Busca Vetorial: Realize buscas semânticas nas memórias usando embeddings.
• Base de Conhecimento: Gerencie uma base de conhecimento estruturada com documentos e fatos.
• Extração de Fatos: Extraia automaticamente fatos importantes das interações do usuário.
• Persistência: Dados são armazenados de forma persistente (ex: banco de dados ou armazenamento local).

Instalação

npm install agent-memory

Uso Básico

import { AgentMemory } from 'agent-memory';

const memory = new AgentMemory({
  storage: 'local', // ou 'postgres', 'sqlite'
});

// Armazenar uma interação
await memory.store('Usuário: Qual é a capital da França?', { role: 'user' });
await memory.store('Agente: A capital da França é Paris.', { role: 'assistant' });

// Buscar memórias relevantes
const resultados = await memory.search('capital da França');
console.log(resultados);

// Extrair fatos
const fatos = await memory.extractFacts('Paris é a capital da França.');
console.log(fatos); // [{ fact: 'A capital da França é Paris', confidence: 0.95 }]

Configuração

Configure o armazenamento e outros parâmetros no construtor:

const memory = new AgentMemory({
  storage: 'postgres',
  connectionString: 'postgresql://user:password@localhost:5432/memory_db',
  embeddingModel: 'text-embedding-ada-002',
  maxMemorySize: 1000,
});

Integração com Frameworks

Claude Code

import { ClaudeMemory } from 'agent-memory/claude';

const claudeMemory = new ClaudeMemory();
// Use com a API do Claude

Cursor

import { CursorMemory } from 'agent-memory/cursor';
// Integração automática

Codex

import { CodexMemory } from 'agent-memory/codex';
// Integração via plugin

Documentação Completa

Consulte o repositório oficial para documentação detalhada, exemplos e contribuições.

Licença

MIT