OpenAI Agents SDK Integration

The OpenAI Agents SDK is the canonical Python framework for building agents on OpenAI's Responses API. Register CortexDB recall and capture as agent tools.

Install

pip install cortexdbai openai-agents

Pattern

import os
from datetime import datetime, timezone
from uuid import uuid4
from agents import Agent, Runner, function_tool
from cortexdb.v1 import V1Client

client = V1Client(api_url="https://api-v1.cortexdb.ai", actor="user:alice",
                  bearer=os.environ["CORTEX_TOKEN"])
SCOPE = "org:acme/user:alice"


@function_tool
def recall_long_term(query: str) -> str:
    """Pull prior context from long-term memory."""
    pack = client.recall(scope=SCOPE, view="holistic", query=query,
                         include=["beliefs", "facts", "episodes"],
                         budgets={"max_tokens": 3000})
    return pack["context_block"] or "(no relevant context)"


@function_tool
def capture(text: str, role: str = "assistant") -> str:
    client.experience(scope=SCOPE, text=text, role=role,
                      observed_at=datetime.now(timezone.utc).isoformat(),
                      idempotency_key=f"oa-{role}-{uuid4()}")
    return "captured"


agent = Agent(
    name="Memory Agent",
    instructions="Call recall_long_term before answering; call capture after every turn.",
    tools=[recall_long_term, capture],
)

result = Runner.run_sync(agent, "What did we decide about Acme's renewal?")
print(result.final_output)

See also

• Python SDK