Get Memories

cURL

curl --request GET \
  --url https://www.pierre.finance/tools/api/get-memories \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.pierre.finance/tools/api/get-memories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.pierre.finance/tools/api/get-memories",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.pierre.finance/tools/api/get-memories"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.pierre.finance/tools/api/get-memories")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "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",
  "memoryAdded": false,
  "timestamp": "2024-11-27T17:15:00Z"
}

GET

tools

api

get-memories

cURL

curl --request GET \
  --url https://www.pierre.finance/tools/api/get-memories \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.pierre.finance/tools/api/get-memories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.pierre.finance/tools/api/get-memories",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.pierre.finance/tools/api/get-memories"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.pierre.finance/tools/api/get-memories")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "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",
  "memoryAdded": false,
  "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.

string

required

Bearer token com a API key do usuário. Formato: Bearer sk-your-api-key-here

Parâmetros de Query

string

required

Mensagem do usuário para adicionar à memória. Se fornecida, será armazenada antes de retornar as memórias.

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"
}

{
  "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",
  "memoryAdded": false,
  "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

boolean

required

Indica se a requisição foi bem-sucedida

string

required

Memórias formatadas prontas para uso em prompts de LLM. Texto estruturado com informações relevantes sobre o usuário.

boolean

required

Indica se uma nova memória foi adicionada nesta requisição (true se message foi fornecido, false caso contrário)

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:

Analisa a mensagem usando IA
Extrai informações relevantes sobre preferências e contexto do usuário
Armazena as informações de forma estruturada no Mem0
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>

Getting Started

Accounts & Balance

Transactions

Credit Cards

Spending Limits

Payment Reminders

Analytics

Memories

Open Finance

Synchronization

MCP Server

Descrição

Autenticação

Parâmetros de Query

Resposta

Sucesso (200)

Erro de Autenticação (401)

Mem0 Não Configurado (503)

Campos da Resposta

Exemplos de Uso

cURL

JavaScript

Python

Códigos de Status

Como Funciona

Armazenamento de Memórias

Recuperação de Memórias

Casos de Uso

Chatbots Personalizados

Assistentes Virtuais

Recomendações Personalizadas

Automação Inteligente

Integração com LLMs

Exemplo de Uso em Prompt

Armazenando Preferências

Privacidade

Authorizations

Query Parameters

Response

​Descrição

​Autenticação

​Parâmetros de Query

​Resposta

​Sucesso (200)

​Erro de Autenticação (401)

​Mem0 Não Configurado (503)

​Campos da Resposta

​Exemplos de Uso

​cURL

​JavaScript

​Python

​Códigos de Status

​Como Funciona

​Armazenamento de Memórias

​Recuperação de Memórias

​Casos de Uso

​Chatbots Personalizados

​Assistentes Virtuais

​Recomendações Personalizadas

​Automação Inteligente

​Integração com LLMs

​Exemplo de Uso em Prompt

​Armazenando Preferências

​Privacidade

Authorizations

Query Parameters

Response

Descrição

Autenticação

Parâmetros de Query

Resposta

Sucesso (200)

Erro de Autenticação (401)

Mem0 Não Configurado (503)

Campos da Resposta

Exemplos de Uso

cURL

JavaScript

Python

Códigos de Status

Como Funciona

Armazenamento de Memórias

Recuperação de Memórias

Casos de Uso

Chatbots Personalizados

Assistentes Virtuais

Recomendações Personalizadas

Automação Inteligente

Integração com LLMs

Exemplo de Uso em Prompt

Armazenando Preferências

Privacidade