Mem0

Mem0 は、エージェントの会話から永続的なメモリを抽出し、後の実行で関連するメモリを取得します。 セッション間でメモリを使用できるようにする必要がある場合は、安定したユーザー、エージェント、またはアプリケーション スコープを使用します。

この統合では、メモリ パターンが使用されます。完全な会話トランスクリプトを再生するのではなく、選択した永続的な情報を抽出して取り消します。

Important

Mem0 はサード パーティ製システムです。 アプリケーション データを送信する前に、データの処理、保持、地域の境界、サービス条件を確認します。

Note

現在、Mem0 統合は Agent Framework .NETでは使用できません。

パッケージをインストールする

pip install agent-framework-mem0 --pre

MEM0_API_KEY設定するか、API キーを直接渡します。 同じ user_id を再利用すると、セッション間でメモリを使用できるようになります。

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,
    ):
        # First ask the agent to retrieve a company report with no previous context.
        # The agent will not be able to invoke the tool, since it doesn't know
        # the company code or the report format, so it should ask for clarification.
        query = "Please retrieve my company report"
        print(f"User: {query}")
        result = await agent.run(query)
        print(f"Agent: {result}\n")
        # Now tell the agent the company code and the report format that you want to use
        # and it should be able to invoke the tool and return the report.
        query = "I always work with CNTS and I always want a detailed report format. Please remember and retrieve it."
        print(f"User: {query}")
        result = await agent.run(query)
        print(f"Agent: {result}\n")

        # Mem0 processes and indexes memories asynchronously.
        # Wait for memories to be indexed before querying in a new thread.
        # In production, consider implementing retry logic or using Mem0's
        # eventual consistency handling instead of a fixed delay.
        print("Waiting for memories to be processed...")
        await asyncio.sleep(15)  # Empirically determined delay for Mem0 indexing
        print("\nRequest within a new session:")
        # Create a new session for the agent.
        # The new session has no context of the previous conversation.
        session = agent.create_session()
        # Since we have the mem0 component in the session, the agent should be able to
        # retrieve the company report without asking for clarification, as it will
        # be able to remember the user preferences from Mem0 component.
        query = "Please retrieve my company report"
        print(f"User: {query}")
        result = await agent.run(query, session=session)
        print(f"Agent: {result}")

Mem0 はメモリを非同期的に処理します。 運用環境では、固定遅延に依存するのではなく、再試行またはサービス対応の整合性処理を使用します。

Note

現在、Mem0 統合は Agent Framework Go では使用できません。 最新の状態については、 Agent Framework Go リポジトリ を参照してください。

次のステップ

Microsoft Foundry

より深く進む:

  • Last updated on