Skip to main content
GET
/
tools
/
api
/
get-memories
cURL
curl --request GET \
  --url https://www.pierre.finance/tools/api/get-memories \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "memoriesForPrompt": "Memórias do usuário:\n- Prefere receber relatórios financeiros semanalmente\n- Gosta de análises detalhadas por categoria\n- Usa principalmente cartão de crédito Nubank\n- Interessa-se por investimentos de baixo risco",
  "memoryAdded": true,
  "timestamp": "2024-11-27T17:15:00Z"
}
Este endpoint gerencia memórias do usuário para interações personalizadas com LLMs.

​
Descrição

O endpoint GET /tools/api/get-memories permite adicionar mensagens do usuário à memória e recuperar memórias formatadas para uso em prompts de LLM. Requer configuração do Mem0 para funcionar.

​
Autenticação

Este endpoint requer autenticação via Bearer token.
​
Authorization
string
required
Bearer token com a API key do usuário. Formato: Bearer sk-your-api-key-here

​
Parâmetros de Query

​
message
string
required
Mensagem do usuário para adicionar à memória. Se fornecida, será armazenada antes de retornar as memórias.
​
s
string
required
Parâmetro interno para indicar requisições via MCP. Use s=s para requisições MCP.

​
Resposta

​
Sucesso (200)

{
  "success": true,
  "memoriesForPrompt": "Memórias do usuário:\n- Prefere receber relatórios financeiros semanalmente\n- Gosta de análises detalhadas por categoria\n- Usa principalmente cartão de crédito Nubank\n- Interessa-se por investimentos de baixo risco",
  "memoryAdded": true,
  "timestamp": "2024-11-27T17:15:00Z"
}

​
Erro de Autenticação (401)

{
  "error": "Invalid or inactive API key",
  "message": "Please check your API key and try again",
  "type": "invalid_api_key"
}

​
Mem0 Não Configurado (503)

{
  "error": "Mem0 not configured",
  "message": "MEM0_API_KEY environment variable is not set"
}

​
Campos da Resposta

​
success
boolean
required
Indica se a requisição foi bem-sucedida
​
memoriesForPrompt
string
required
Memórias formatadas prontas para uso em prompts de LLM. Texto estruturado com informações relevantes sobre o usuário.
​
memoryAdded
boolean
required
Indica se uma nova memória foi adicionada nesta requisição (true se message foi fornecido, false caso contrário)
​
timestamp
string
required
Timestamp da requisição em formato ISO 8601

​
Exemplos de Uso

​
cURL

# Recuperar memórias existentes
curl -X GET 'https://www.pierre.finance/tools/api/get-memories' \
  -H 'Authorization: Bearer sk-your-api-key-here'

# Adicionar nova memória e recuperar todas
curl -X GET 'https://www.pierre.finance/tools/api/get-memories?message=Prefiro%20receber%20relatórios%20semanais' \
  -H 'Authorization: Bearer sk-your-api-key-here'

​
JavaScript

const API_KEY = 'sk-your-api-key-here';
const BASE_URL = 'https://www.pierre.finance/tools/api';

async function getMemories(message = null) {
  const params = new URLSearchParams();
  if (message) {
    params.append('message', message);
  }
  
  const url = `${BASE_URL}/get-memories${params.toString() ? '?' + params : ''}`;
  const response = await fetch(url, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  return await response.json();
}

// Exemplos de uso
getMemories(); // Apenas recuperar

getMemories('Prefiro receber relatórios semanais'); // Adicionar e recuperar

​
Python

import requests

API_KEY = 'sk-your-api-key-here'
BASE_URL = 'https://www.pierre.finance/tools/api'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

def get_memories(message=None):
    params = {}
    if message:
        params['message'] = message
    
    response = requests.get(f'{BASE_URL}/get-memories',
                          headers=headers, params=params)
    return response.json()

# Exemplos de uso
memories = get_memories()  # Apenas recuperar

memories_with_new = get_memories('Prefiro receber relatórios semanais')  # Adicionar

​
Códigos de Status

  • 200: Sucesso - Memórias retornadas
  • 401: Erro de autenticação ou assinatura
  • 503: Mem0 não configurado no servidor
  • 500: Erro interno do servidor

​
Como Funciona

​
Armazenamento de Memórias

Quando você fornece uma mensagem via parâmetro message, o sistema:
  1. Analisa a mensagem usando IA
  2. Extrai informações relevantes sobre preferências e contexto do usuário
  3. Armazena as informações de forma estruturada no Mem0
  4. Evita duplicatas (não armazena a mesma informação duas vezes)

​
Recuperação de Memórias

O sistema recupera todas as memórias relevantes do usuário e as formata em um texto estruturado ideal para uso em prompts de LLM. As memórias incluem:
  • Preferências de comunicação
  • Padrões de uso da API
  • Contexto financeiro específico do usuário
  • Objetivos e interesses declarados

​
Casos de Uso

​
Chatbots Personalizados

Use as memórias recuperadas para personalizar as respostas de chatbots financeiros, considerando as preferências e contexto do usuário.

​
Assistentes Virtuais

Construa assistentes que “lembram” das preferências do usuário entre diferentes sessões de conversa.

​
Recomendações Personalizadas

Use o contexto armazenado para gerar recomendações financeiras mais relevantes.

​
Automação Inteligente

Configure automações que respeitam as preferências do usuário sem precisar perguntar repetidamente.
Este endpoint requer que o Mem0 esteja configurado no servidor. Entre em contato com o suporte se você receber erro 503.
Use este endpoint no início de cada sessão de conversa para recuperar o contexto do usuário e proporcionar uma experiência mais personalizada.
As memórias são persistentes e compartilhadas entre diferentes aplicações que usam a mesma API key. Tenha cuidado ao armazenar informações sensíveis.

​
Integração com LLMs

​
Exemplo de Uso em Prompt

// Recuperar memórias
const { memoriesForPrompt } = await getMemories();

// Usar em prompt do ChatGPT/Claude
const prompt = `
${memoriesForPrompt}

Contexto da conversa atual:
${currentMessage}

Responda considerando as preferências e contexto do usuário acima.
`;

​
Armazenando Preferências

// Detectar preferência na conversa
if (userMessage.includes('prefiro relatórios semanais')) {
  await getMemories('Prefiro receber relatórios semanais');
}

// Em conversas futuras, o sistema lembrará dessa preferência
const { memoriesForPrompt } = await getMemories();
// memoriesForPrompt incluirá: "Prefere receber relatórios semanais"

​
Privacidade

  • Memórias são privadas e associadas ao usuário da API key
  • Não são compartilhadas entre usuários diferentes
  • Podem ser apagadas mediante solicitação ao suporte
  • Armazenadas de forma segura e criptografada

Authorizations

​
Authorization
string
header
required

API key in Bearer token format. Example: Bearer sk-your-api-key-here

Query Parameters

​
message
string

Mensagem do usuário para adicionar à memória (opcional)

Response

Memórias formatadas para prompts

​
success
boolean
Example:

true

​
memoriesForPrompt
string

Memórias formatadas para uso em prompts de LLM

​
memoryAdded
boolean

Se uma nova memória foi adicionada

​
timestamp
string<date-time>