# Common Issues and Solutions

### Installation Issues

#### Problem: Import Errors

```python
ImportError: No module named 'agentneo'
```

**Solution:**

1. Verify installation:

```bash
pip list | grep agentneo
```

2. Reinstall package:

```bash
pip uninstall agentneo
pip install agentneo
```

#### Problem: Version Conflicts

**Solution:**

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

### Tracing Issues

#### Problem: Decorators Not Working

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

**Solution:**

1. Verify tracer initialization

```python
# 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

```python
# 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

```python
launch_dashboard(port=3001)  # Try different port
```

### Evaluation Issues

#### Problem: Metrics Not Computing

**Solution:**

1. Verify trace data exists
2. Check metric configuration

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agentneo.raga.ai/troubleshooting/common-issues-and-solutions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.