Mem0

O Mem0 extrai memórias duradouras das conversas com agentes e recupera memórias relevantes em runs posteriores. Configure os escopos de armazenamento e recuperação quando as memórias devem estar disponíveis entre sessões.

Esta integração utiliza o padrão de memória: extrai e recupera informação duradoura selecionada em vez de reproduzir a transcrição completa da conversa.

Importante

O Mem0 é um sistema de terceiros. Revise o tratamento dos dados, a retenção, os limites regionais e os termos de serviço antes de enviar os dados da candidatura.

Observação

A integração do Mem0 não está atualmente disponível para o Agent Framework .NET.

Instale o pacote

pip install agent-framework-mem0 --pre

Define MEM0_API_KEY ou passa diretamente uma chave API. Configure o armazenamento e a recuperação separadamente:

  • user_id, agent_id e application_id são âmbitos de armazenamento. O Mem0 carimba essas memórias em cada memória armazenada.
  • search_user_id, search_agent_id, e search_application_id são âmbitos de recuperação. O Mem0 usa-os para selecionar quais memórias pesquisa.

Os âmbitos da aplicação requerem o cliente da Plataforma Mem0 (AsyncMemoryClient). O cliente OSS AsyncMemory suporta apenas os escopos de utilizador e agente.

O âmbito de recuperação não herda do âmbito de armazenamento. Se não definires nenhum search_* âmbito, o provedor armazena memórias, mas não se lembra delas.

Para memória por utilizador, defina user_id e search_user_id para o mesmo identificador estável:

async def main() -> None:
    """Example of memory usage with Mem0 context provider."""
    print("=== Mem0 Context Provider Example ===")
    # Each record in Mem0 should be associated with agent_id or user_id or application_id.
    # In this example, we associate Mem0 records with user_id.
    user_id = str(uuid.uuid4())
    # For Azure authentication, run `az login` command in terminal or replace AzureCliCredential with preferred
    # authentication option.
    # For Mem0 authentication, set Mem0 API key via "api_key" parameter or MEM0_API_KEY environment variable.
    async with (
        AzureCliCredential() as credential,
        Agent(
            client=FoundryChatClient(credential=credential),
            name="FriendlyAssistant",
            instructions="You are a friendly assistant.",
            tools=retrieve_company_report,
            context_providers=[Mem0ContextProvider(source_id="mem0", user_id=user_id, search_user_id=user_id)],
        ) as agent,
    ):

O Mem0 processa memórias de forma assíncrona. Em produção, utilize retentativas ou gestão de consistência consciente do serviço em vez de depender de um atraso fixo.

Observação

A integração do Mem0 não está atualmente disponível para o Agent Framework Go. Consulte o repositório Agent Framework Go para o estado mais recente.

Passos seguintes

Vai mais fundo: