diff --git a/AGENTOPS_FIX_GUIDE.md b/AGENTOPS_FIX_GUIDE.md
new file mode 100644
index 000000000..b271b0d60
--- /dev/null
+++ b/AGENTOPS_FIX_GUIDE.md
@@ -0,0 +1,140 @@
+# AgentOps Issues and Fixes
+
+## Issues Identified
+
+### 1. Deprecation Warning
+```
+🖇 AgentOps: end_session() is deprecated and will be removed in v4 in the future. Use agentops.end_trace() instead.
+```
+
+### 2. Authentication Errors (401 Unauthorized)
+```
+Failed to export span batch code: 401, reason: Unauthorized
+Failed to export metrics batch code: 401, reason: Unauthorized
+```
+
+## Root Causes
+
+### 1. Using Deprecated API
+The original code uses `agentops.end_session()` which is deprecated. The new API uses traces instead of sessions.
+
+### 2. API Key Issues
+The 401 errors indicate that either:
+- The `AGENTOPS_API_KEY` environment variable is not set
+- The API key is invalid or expired
+- The API key doesn't have proper permissions
+
+### 3. Improper Initialization
+The original code doesn't explicitly start a trace, relying on the legacy session-based approach.
+
+## Solutions
+
+### 1. Update to Modern AgentOps API
+
+**Before (Deprecated):**
+```python
+import agentops
+
+# Initialize
+agentops.init(api_key=os.getenv("AGENTOPS_API_KEY"))
+
+# ... your code ...
+
+# End session (DEPRECATED)
+agentops.end_session()
+```
+
+**After (Modern API):**
+```python
+import agentops
+
+# Initialize with explicit configuration
+agentops.init(
+    api_key=api_key,
+    auto_start_session=False,  # Manual control
+    trace_name="Your App Name",
+    tags=["tag1", "tag2"]
+)
+
+# Start trace manually
+tracer = agentops.start_trace(
+    trace_name="Your App Name",
+    tags=["example", "agentops"]
+)
+
+# ... your code ...
+
+# End trace properly
+agentops.end_trace(tracer, end_state="Success")
+
+# Optional: Validate spans were recorded
+agentops.validate_trace_spans(trace_context=tracer)
+```
+
+### 2. Fix Authentication Issues
+
+#### Check API Key Setup
+```python
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+api_key = os.getenv("AGENTOPS_API_KEY")
+
+if not api_key:
+    print("Warning: AGENTOPS_API_KEY not found!")
+    print("Get your API key from: https://agentops.ai/settings/projects")
+    exit(1)
+```
+
+#### Create/Update .env file
+```bash
+# .env file
+AGENTOPS_API_KEY=your_actual_api_key_here
+OPENAI_API_KEY=your_openai_key_here
+```
+
+### 3. Proper Error Handling
+
+```python
+try:
+    agentops.end_trace(tracer, end_state="Success")
+    print("✅ AgentOps trace ended successfully")
+    
+    # Validate spans were recorded
+    agentops.validate_trace_spans(trace_context=tracer)
+    print("✅ All spans properly recorded")
+    
+except agentops.ValidationError as e:
+    print(f"❌ Validation error: {e}")
+except Exception as e:
+    print(f"❌ Error ending trace: {e}")
+```
+
+## Complete Fixed Example
+
+See `fixed_crewai_example.py` for the complete working example.
+
+## Key Changes Summary
+
+1. **Replace `end_session()`** → `end_trace(tracer, end_state="Success")`
+2. **Add explicit trace management** → `start_trace()` and `end_trace()`
+3. **Improve API key handling** → Check for missing keys and provide helpful error messages
+4. **Add proper error handling** → Catch validation and other errors
+5. **Use modern initialization** → Set `auto_start_session=False` for manual control
+
+## Verification
+
+After applying these fixes, you should see:
+- ✅ No deprecation warnings
+- ✅ No 401 authentication errors  
+- ✅ Successful trace completion
+- ✅ Proper span validation
+- ✅ Session replay URL (if authenticated correctly)
+
+## Getting Your API Key
+
+1. Visit [AgentOps Settings](https://agentops.ai/settings/projects)
+2. Create an account if needed
+3. Generate an API key for your project
+4. Add it to your `.env` file as `AGENTOPS_API_KEY=your_key_here`
\ No newline at end of file
diff --git a/fixed_crewai_example.py b/fixed_crewai_example.py
new file mode 100644
index 000000000..68280a511
--- /dev/null
+++ b/fixed_crewai_example.py
@@ -0,0 +1,65 @@
+import os
+from dotenv import load_dotenv
+import agentops
+from crewai import Agent, Task, Crew
+
+# 1. Load environment variables
+load_dotenv()
+
+# 2. Initialize AgentOps with proper configuration
+# The 401 errors suggest API key issues - make sure AGENTOPS_API_KEY is set
+api_key = os.getenv("AGENTOPS_API_KEY")
+if not api_key:
+    print("Warning: AGENTOPS_API_KEY not found in environment variables.")
+    print("Please set your AgentOps API key in a .env file or environment variable.")
+    print("You can get an API key from: https://agentops.ai/settings/projects")
+
+agentops.init(
+    api_key=api_key,
+    auto_start_session=False,  # We'll manually control the trace
+    trace_name="Math Assistant Example",
+    tags=["crewai", "math", "example"]
+)
+
+# 3. Start a trace manually (replaces the old session concept)
+tracer = agentops.start_trace(
+    trace_name="Math Assistant Example",
+    tags=["crewai-math-example", "agentops-example"]
+)
+
+# 4. Create a minimal CrewAI setup
+agent = Agent(
+    role="Math Assistant",
+    goal="Solve simple math problems",
+    backstory="You are a helpful assistant for quick calculations.",
+    allow_delegation=False,
+    verbose=True
+)
+
+task = Task(
+    description="Solve: What is 25 * 4?",
+    expected_output="100",
+    agent=agent
+)
+
+crew = Crew(agents=[agent], tasks=[task], verbose=True)
+
+# 5. Run the crew
+print("Starting math calculation...")
+result = crew.kickoff()
+
+print("\nFinal Result:", result)
+
+# 6. End the trace properly (replaces end_session)
+try:
+    agentops.end_trace(tracer, end_state="Success")
+    print("✅ AgentOps trace ended successfully")
+    
+    # Validate that spans were recorded properly
+    agentops.validate_trace_spans(trace_context=tracer)
+    print("✅ All spans were properly recorded in AgentOps")
+    
+except agentops.ValidationError as e:
+    print(f"❌ Error validating spans: {e}")
+except Exception as e:
+    print(f"❌ Error ending trace: {e}")
\ No newline at end of file
diff --git a/test_fix.py b/test_fix.py
new file mode 100644
index 000000000..ac3a192c9
--- /dev/null
+++ b/test_fix.py
@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""
+Test script to validate AgentOps fixes without requiring API keys
+"""
+
+import sys
+import os
+import importlib.util
+
+def test_imports():
+    """Test that all required modules can be imported"""
+    try:
+        import agentops
+        import crewai
+        from dotenv import load_dotenv
+        print("✅ All imports successful")
+        return True
+    except ImportError as e:
+        print(f"❌ Import error: {e}")
+        return False
+
+def test_agentops_api():
+    """Test that the modern AgentOps API is available"""
+    try:
+        import agentops
+        
+        # Check if modern functions exist
+        assert hasattr(agentops, 'init'), "agentops.init not found"
+        assert hasattr(agentops, 'start_trace'), "agentops.start_trace not found"
+        assert hasattr(agentops, 'end_trace'), "agentops.end_trace not found"
+        assert hasattr(agentops, 'validate_trace_spans'), "agentops.validate_trace_spans not found"
+        
+        print("✅ Modern AgentOps API available")
+        return True
+    except (ImportError, AssertionError) as e:
+        print(f"❌ AgentOps API test failed: {e}")
+        return False
+
+def test_fixed_code_syntax():
+    """Test that the fixed code has valid syntax"""
+    try:
+        # Test the fixed code file
+        spec = importlib.util.spec_from_file_location("fixed_example", "fixed_crewai_example.py")
+        if spec is None:
+            print("❌ Could not load fixed_crewai_example.py")
+            return False
+            
+        module = importlib.util.module_from_spec(spec)
+        # We don't execute it, just check if it can be loaded
+        print("✅ Fixed code has valid syntax")
+        return True
+    except Exception as e:
+        print(f"❌ Syntax error in fixed code: {e}")
+        return False
+
+def test_deprecation_fix():
+    """Test that deprecated functions are not used in the fixed code"""
+    try:
+        with open("fixed_crewai_example.py", "r") as f:
+            content = f.read()
+        
+        # Check for deprecated patterns
+        deprecated_patterns = [
+            "end_session()",
+            "agentops.end_session",
+        ]
+        
+        for pattern in deprecated_patterns:
+            if pattern in content:
+                print(f"❌ Found deprecated pattern: {pattern}")
+                return False
+        
+        # Check for modern patterns
+        modern_patterns = [
+            "start_trace(",
+            "end_trace(",
+            "auto_start_session=False",
+        ]
+        
+        for pattern in modern_patterns:
+            if pattern not in content:
+                print(f"❌ Missing modern pattern: {pattern}")
+                return False
+        
+        print("✅ No deprecated patterns found, modern API used")
+        return True
+    except Exception as e:
+        print(f"❌ Error checking deprecation fix: {e}")
+        return False
+
+def main():
+    """Run all tests"""
+    print("🧪 Testing AgentOps fixes...\n")
+    
+    tests = [
+        ("Import Test", test_imports),
+        ("AgentOps API Test", test_agentops_api),
+        ("Syntax Test", test_fixed_code_syntax),
+        ("Deprecation Fix Test", test_deprecation_fix),
+    ]
+    
+    results = []
+    for test_name, test_func in tests:
+        print(f"Running {test_name}...")
+        result = test_func()
+        results.append(result)
+        print()
+    
+    # Summary
+    passed = sum(results)
+    total = len(results)
+    
+    print("="*50)
+    print(f"Test Results: {passed}/{total} passed")
+    
+    if passed == total:
+        print("🎉 All tests passed! The fix should resolve the AgentOps issues.")
+    else:
+        print("⚠️  Some tests failed. Please check the output above.")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()
\ No newline at end of file