Common Issues and Solutions

Installation Issues

Problem: Import Errors

ImportError: No module named 'agentneo'

Solution:

1. Verify installation:

pip list | grep agentneo

1. Reinstall package:

pip uninstall agentneo
pip install agentneo

Problem: Version Conflicts

Solution:

pip install --upgrade agentneo
pip install --upgrade "agentneo[all]"

Tracing Issues

Problem: Decorators Not Working

@tracer.trace_llm()
def my_function():
    # Function not being traced

Solution:

1. Verify tracer initialization

# Correct initialization
neo_session = AgentNeo(session_name="my_session")
neo_session.create_project("my_project")
tracer = Tracer(session=neo_session)
tracer.start()  # Don't forget this!

Problem: Missing Data in Dashboard

Solution:

1. Check tracer status

2. Verify data storage

3. Ensure proper stopping

# Correct order
tracer.stop()  # Stop before launching dashboard
launch_dashboard(port=3000)

Dashboard Issues

Problem: Connection Refused

Solution:

1. Check port availability

2. Verify server status

3. Try alternative port

launch_dashboard(port=3001)  # Try different port

Evaluation Issues

Problem: Metrics Not Computing

Solution:

1. Verify trace data exists

2. Check metric configuration

# Correct usage
exe = Evaluation(
    session=neo_session,
    trace_id=tracer.trace_id  # Verify trace_id exists
)