89 lines
1.8 KiB
Markdown
89 lines
1.8 KiB
Markdown
# API Reference
|
|
|
|
## Base URL
|
|
```
|
|
http://your-server-ip:8080/v1
|
|
```
|
|
|
|
## Authentication
|
|
All requests require Bearer token:
|
|
```
|
|
Authorization: Bearer sk-agent-your-key
|
|
```
|
|
|
|
## Endpoints
|
|
|
|
### POST /chat/completions
|
|
Main agent endpoint.
|
|
|
|
**Request:**
|
|
```json
|
|
{
|
|
"message": "Create a Python script to fetch weather data",
|
|
"reasoning_mode": "plan_execute",
|
|
"session_id": "unique-session-id",
|
|
"max_iterations": 10
|
|
}
|
|
```
|
|
|
|
**Response:**
|
|
```json
|
|
{
|
|
"response": "Here\'s the Python script...",
|
|
"reasoning_mode": "plan_execute",
|
|
"session_id": "unique-session-id",
|
|
"steps": [
|
|
{"step_number": 1, "type": "plan", "content": "..."},
|
|
{"step_number": 2, "type": "action", "content": "..."}
|
|
],
|
|
"metadata": {
|
|
"model_used": "volume-tier",
|
|
"auto_selected": true,
|
|
"timestamp": "2024-..."
|
|
}
|
|
}
|
|
```
|
|
|
|
### Reasoning Modes
|
|
|
|
| Mode | Use Case | Speed | Accuracy |
|
|
|------|----------|-------|----------|
|
|
| `react` | Simple Q&A, debugging | Fast | Medium |
|
|
| `plan_execute` | Complex multi-step tasks | Medium | High |
|
|
| `reflexion` | Code review, critical tasks | Slow | Very High |
|
|
| `auto` | Let system decide | Variable | Adaptive |
|
|
|
|
### GET /models
|
|
List available models.
|
|
|
|
### GET /health
|
|
Check system status.
|
|
|
|
### GET /sessions/{id}/history
|
|
Retrieve conversation history.
|
|
|
|
## Examples
|
|
|
|
### Python
|
|
```python
|
|
import requests
|
|
|
|
response = requests.post(
|
|
"http://localhost:8080/v1/chat/completions",
|
|
headers={"Authorization": "Bearer sk-agent-xxx"},
|
|
json={
|
|
"message": "Refactor this code",
|
|
"reasoning_mode": "reflexion"
|
|
}
|
|
)
|
|
print(response.json()["response"])
|
|
```
|
|
|
|
### cURL
|
|
```bash
|
|
curl -X POST http://localhost:8080/v1/chat/completions \
|
|
-H "Authorization: Bearer sk-agent-xxx" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"message":"Hello","reasoning_mode":"auto"}'
|
|
```
|