chore: import upstream snapshot with attribution
This commit is contained in:
wehub-resource-sync
@@ -0,0 +1,278 @@
|
||||
"""
|
||||
Comprehensive example demonstrating AdvancedSQLiteSession functionality.
|
||||
|
||||
This example shows both basic session memory features and advanced conversation
|
||||
branching capabilities, including usage statistics, turn-based organization,
|
||||
and multi-timeline conversation management.
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
|
||||
from agents import Agent, Runner, function_tool
|
||||
from agents.extensions.memory import AdvancedSQLiteSession
|
||||
|
||||
|
||||
@function_tool
|
||||
async def get_weather(city: str) -> str:
|
||||
if city.strip().lower() == "new york":
|
||||
return f"The weather in {city} is cloudy."
|
||||
return f"The weather in {city} is sunny."
|
||||
|
||||
|
||||
async def main():
|
||||
# Create an agent
|
||||
agent = Agent(
|
||||
name="Assistant",
|
||||
instructions="Reply very concisely.",
|
||||
tools=[get_weather],
|
||||
)
|
||||
|
||||
# Create an advanced session instance
|
||||
session = AdvancedSQLiteSession(
|
||||
session_id="conversation_comprehensive",
|
||||
create_tables=True,
|
||||
)
|
||||
|
||||
print("=== AdvancedSQLiteSession Comprehensive Example ===")
|
||||
print("This example demonstrates both basic and advanced session features.\n")
|
||||
|
||||
# === PART 1: Basic Session Functionality ===
|
||||
print("=== PART 1: Basic Session Memory ===")
|
||||
print("The agent will remember previous messages with structured tracking.\n")
|
||||
|
||||
# First turn
|
||||
print("First turn:")
|
||||
print("User: What city is the Golden Gate Bridge in?")
|
||||
result = await Runner.run(
|
||||
agent,
|
||||
"What city is the Golden Gate Bridge in?",
|
||||
session=session,
|
||||
)
|
||||
print(f"Assistant: {result.final_output}")
|
||||
print(f"Usage: {result.context_wrapper.usage.total_tokens} tokens")
|
||||
|
||||
# Store usage data automatically
|
||||
await session.store_run_usage(result)
|
||||
print()
|
||||
|
||||
# Second turn - continuing the conversation
|
||||
print("Second turn:")
|
||||
print("User: What's the weather in that city?")
|
||||
result = await Runner.run(
|
||||
agent,
|
||||
"What's the weather in that city?",
|
||||
session=session,
|
||||
)
|
||||
print(f"Assistant: {result.final_output}")
|
||||
print(f"Usage: {result.context_wrapper.usage.total_tokens} tokens")
|
||||
|
||||
# Store usage data automatically
|
||||
await session.store_run_usage(result)
|
||||
print()
|
||||
|
||||
# Third turn
|
||||
print("Third turn:")
|
||||
print("User: What's the population of that city?")
|
||||
result = await Runner.run(
|
||||
agent,
|
||||
"What's the population of that city?",
|
||||
session=session,
|
||||
)
|
||||
print(f"Assistant: {result.final_output}")
|
||||
print(f"Usage: {result.context_wrapper.usage.total_tokens} tokens")
|
||||
|
||||
# Store usage data automatically
|
||||
await session.store_run_usage(result)
|
||||
print()
|
||||
|
||||
# === PART 2: Usage Tracking and Analytics ===
|
||||
print("=== PART 2: Usage Tracking and Analytics ===")
|
||||
session_usage = await session.get_session_usage()
|
||||
if session_usage:
|
||||
print("Session Usage (aggregated from turns):")
|
||||
print(f" Total requests: {session_usage['requests']}")
|
||||
print(f" Total tokens: {session_usage['total_tokens']}")
|
||||
print(f" Input tokens: {session_usage['input_tokens']}")
|
||||
print(f" Output tokens: {session_usage['output_tokens']}")
|
||||
print(f" Total turns: {session_usage['total_turns']}")
|
||||
|
||||
# Show usage by turn
|
||||
turn_usage_list = await session.get_turn_usage()
|
||||
if turn_usage_list and isinstance(turn_usage_list, list):
|
||||
print("\nUsage by turn:")
|
||||
for turn_data in turn_usage_list:
|
||||
turn_num = turn_data["user_turn_number"]
|
||||
tokens = turn_data["total_tokens"]
|
||||
print(f" Turn {turn_num}: {tokens} tokens")
|
||||
else:
|
||||
print("No usage data found.")
|
||||
|
||||
print("\n=== Structured Query Demo ===")
|
||||
conversation_turns = await session.get_conversation_by_turns()
|
||||
print("Conversation by turns:")
|
||||
for turn_num, items in conversation_turns.items():
|
||||
print(f" Turn {turn_num}: {len(items)} items")
|
||||
for item in items:
|
||||
if item["tool_name"]:
|
||||
print(f" - {item['type']} (tool: {item['tool_name']})")
|
||||
else:
|
||||
print(f" - {item['type']}")
|
||||
|
||||
# Show tool usage
|
||||
tool_usage = await session.get_tool_usage()
|
||||
if tool_usage:
|
||||
print("\nTool usage:")
|
||||
for tool_name, count, turn in tool_usage:
|
||||
print(f" {tool_name}: used {count} times in turn {turn}")
|
||||
else:
|
||||
print("\nNo tool usage found.")
|
||||
|
||||
print("\n=== Original Conversation Complete ===")
|
||||
|
||||
# Show current conversation
|
||||
print("Current conversation:")
|
||||
current_items = await session.get_items()
|
||||
for i, item in enumerate(current_items, 1): # type: ignore[assignment]
|
||||
role = str(item.get("role", item.get("type", "unknown")))
|
||||
if item.get("type") == "function_call":
|
||||
content = f"{item.get('name', 'unknown')}({item.get('arguments', '{}')})"
|
||||
elif item.get("type") == "function_call_output":
|
||||
content = str(item.get("output", ""))
|
||||
else:
|
||||
content = str(item.get("content", item.get("output", "")))
|
||||
print(f" {i}. {role}: {content}")
|
||||
|
||||
print(f"\nTotal items: {len(current_items)}")
|
||||
|
||||
# === PART 3: Conversation Branching ===
|
||||
print("\n=== PART 3: Conversation Branching ===")
|
||||
print("Let's explore a different path starting before turn 2...")
|
||||
|
||||
# Show available turns for branching
|
||||
print("\nAvailable turns for branching:")
|
||||
turns = await session.get_conversation_turns()
|
||||
for turn in turns: # type: ignore[assignment]
|
||||
print(f" Turn {turn['turn']}: {turn['content']}") # type: ignore[index]
|
||||
|
||||
# Create a branch from turn 2
|
||||
print("\nCreating new branch from turn 2...")
|
||||
branch_id = await session.create_branch_from_turn(2)
|
||||
print(f"Created branch: {branch_id}")
|
||||
|
||||
# Show what's in the new branch (it should contain items created before turn 2)
|
||||
branch_items = await session.get_items()
|
||||
print(f"Items copied to new branch: {len(branch_items)}")
|
||||
print("New branch starts before turn 2 and contains:")
|
||||
for i, item in enumerate(branch_items, 1): # type: ignore[assignment]
|
||||
role = str(item.get("role", item.get("type", "unknown")))
|
||||
if item.get("type") == "function_call":
|
||||
content = f"{item.get('name', 'unknown')}({item.get('arguments', '{}')})"
|
||||
elif item.get("type") == "function_call_output":
|
||||
content = str(item.get("output", ""))
|
||||
else:
|
||||
content = str(item.get("content", item.get("output", "")))
|
||||
print(f" {i}. {role}: {content}")
|
||||
|
||||
# Continue conversation in new branch
|
||||
print("\nContinuing conversation in new branch...")
|
||||
print("Turn 2 (new branch): User asks about New York instead")
|
||||
result = await Runner.run(
|
||||
agent,
|
||||
"Actually, what's the weather in New York instead?",
|
||||
session=session,
|
||||
)
|
||||
print(f"Assistant: {result.final_output}")
|
||||
await session.store_run_usage(result)
|
||||
|
||||
# Continue the new branch
|
||||
print("Turn 3 (new branch): User asks about NYC attractions")
|
||||
result = await Runner.run(
|
||||
agent,
|
||||
"What are some famous attractions in New York?",
|
||||
session=session,
|
||||
)
|
||||
print(f"Assistant: {result.final_output}")
|
||||
await session.store_run_usage(result)
|
||||
|
||||
# Show the new conversation
|
||||
print("\n=== New Conversation Branch ===")
|
||||
new_conversation = await session.get_items()
|
||||
print("New conversation with branch:")
|
||||
for i, item in enumerate(new_conversation, 1): # type: ignore[assignment]
|
||||
role = str(item.get("role", item.get("type", "unknown")))
|
||||
if item.get("type") == "function_call":
|
||||
content = f"{item.get('name', 'unknown')}({item.get('arguments', '{}')})"
|
||||
elif item.get("type") == "function_call_output":
|
||||
content = str(item.get("output", ""))
|
||||
else:
|
||||
content = str(item.get("content", item.get("output", "")))
|
||||
print(f" {i}. {role}: {content}")
|
||||
|
||||
print(f"\nTotal items in new branch: {len(new_conversation)}")
|
||||
|
||||
# === PART 4: Branch Management ===
|
||||
print("\n=== PART 4: Branch Management ===")
|
||||
# Show all branches
|
||||
branches = await session.list_branches()
|
||||
print("All branches in this session:")
|
||||
for branch in branches:
|
||||
current = " (current)" if branch["is_current"] else ""
|
||||
print(
|
||||
f" {branch['branch_id']}: {branch['user_turns']} user turns, {branch['message_count']} total messages{current}"
|
||||
)
|
||||
|
||||
# Show conversation turns in current branch
|
||||
print("\nConversation turns in current branch:")
|
||||
current_turns = await session.get_conversation_turns()
|
||||
for turn in current_turns: # type: ignore[assignment]
|
||||
print(f" Turn {turn['turn']}: {turn['content']}") # type: ignore[index]
|
||||
|
||||
print("\n=== Branch Switching Demo ===")
|
||||
print("We can switch back to the main branch...")
|
||||
|
||||
# Switch back to main branch
|
||||
await session.switch_to_branch("main")
|
||||
print("Switched to main branch")
|
||||
|
||||
# Show what's in main branch
|
||||
main_items = await session.get_items()
|
||||
print(f"Items in main branch: {len(main_items)}")
|
||||
|
||||
# Switch back to new branch
|
||||
await session.switch_to_branch(branch_id)
|
||||
branch_items = await session.get_items()
|
||||
print(f"Items in new branch: {len(branch_items)}")
|
||||
|
||||
print("\n=== Final Summary ===")
|
||||
await session.switch_to_branch("main")
|
||||
main_final = len(await session.get_items())
|
||||
await session.switch_to_branch(branch_id)
|
||||
branch_final = len(await session.get_items())
|
||||
|
||||
print(f"Main branch items: {main_final}")
|
||||
print(f"New branch items: {branch_final}")
|
||||
|
||||
# Show that branches are completely independent
|
||||
print("\nBranches are completely independent:")
|
||||
print("- Main branch has full original conversation")
|
||||
print("- New branch has turn 1 + new conversation path")
|
||||
print("- No interference between branches!")
|
||||
|
||||
print("\n=== Comprehensive Example Complete ===")
|
||||
print("This demonstrates the full AdvancedSQLiteSession capabilities!")
|
||||
print("Key features:")
|
||||
print("- Structured conversation tracking with usage analytics")
|
||||
print("- Turn-based organization and querying")
|
||||
print("- Create branches from any user message")
|
||||
print("- Branches inherit conversation history up to the branch point")
|
||||
print("- Complete branch isolation - no interference between branches")
|
||||
print("- Easy branch switching and management")
|
||||
print("- No complex soft deletion - clean branch-based architecture")
|
||||
print("- Perfect for building AI systems with conversation editing capabilities!")
|
||||
|
||||
# Cleanup
|
||||
session.close()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
asyncio.run(main())
|
||||
Reference in New Issue
Block a user