Erste Schritte mit Agent Memory

Dieser Artikel führt Sie durch die Installation von Agent Memory und die Ausführung grundlegender Speichervorgänge, einschließlich Speichern und Abrufen von Benutzerkontext.

Voraussetzungen

Stellen Sie sicher, dass Sie:

SDK installieren

Um Agent Memory zu installieren, führen Sie folgenden Befehl aus:

pip install "oracleagentmemory==26.4.0"

Bei der Installation mit pip werden vordefinierte Binärräder auf unterstützten Plattformen abgerufen.

Speicherinstanz initialisieren

Erstellen Sie eine OracleAgentMemory-Instanz, indem Sie die Einbettung, das LLM und die Datenbankverbindung konfigurieren.

from oracleagentmemory.core.oracleagentmemory import OracleAgentMemory
from oracleagentmemory.apis.searchscope import SearchScope
from oracleagentmemory.core.embedders.embedder import Embedder
from oracleagentmemory.core.llms.llm import Llm

embedder = Embedder(model="YOUR_EMBEDDING_MODEL")
llm = Llm(model="YOUR_LLM")
db_pool = ...  #an oracledb connection or connection pool
memory = OracleAgentMemory(connection=db_pool, embedder=embedder, llm=llm)

Speichereinträge speichern

Erstellen Sie zunächst einen Thread, fügen Sie Nachrichten hinzu, und speichern Sie einen Speichereintrag für den Benutzer.

messages = [
    {
        "role": "user",
        "content": (
            "Orange juice has become my favorite breakfast drink lately, "
            "what can I pair it with?"
        ),
    },
    {
        "role": "assistant",
        "content": (
            "Nice! Orange juice goes great with something savory. "
            "Try eggs and toast, avocado toast, or a breakfast sandwich."
        ),
    },
]

thread = memory.create_thread(user_id="user_123")
#add_messages will add messages to the DB and extract memories automatically
thread.add_messages(messages)
#add_memory adds memory to the DB
thread.add_memory("The user likes orange juice with breakfast.")

Speichereinträge abrufen

Speicher mit einer Abfrage mit Benutzergeltungsbereich suchen

results = memory.search(query="orange juice", scope=SearchScope(user_id="user_123"))
for result in results:
    print(f"- [{result.record.record_type}] {result.content}")

Ausgabe:

-[memory] The user likes orange juice with breakfast.
-[message] Orange juice has become my favorite breakfast drink lately, what can I pair it with?
-[message] Nice! Orange juice goes great with something savory. 
        Try eggs and toast,avocado toast, or a breakfast sandwich.

Hinweis: Die angezeigte Ausgabe ist illustrativ. Zukünftige Versionen können zusätzliche Ergebnistypen, Felder oder Anforderungen zurückgeben.

Modellkompatibilität

Ab April 2026 sind die folgenden Large Language Models (LLMs) und Embedding Models mit oracleagentmemory kompatibel.

LLMs

Die folgenden Large Language Models (LLMs) wurden als kompatibel bestätigt.

vllm

OCI

Gemini

anthrop

openai

Einbettungen

Die folgenden Einbettungsmodelle wurden als kompatibel bestätigt.

gehostet_vllm

OCI

Gemini

openai