AI Assistant

BYTEDOCS_AI_ENABLED=true
BYTEDOCS_AI_PROVIDER=openai
BYTEDOCS_AI_API_KEY=sk-...
BYTEDOCS_AI_MODEL=gpt-4o-mini

config := &core.Config{
    AIConfig: &ai.AIConfig{
        Enabled:  true,
        Provider: "openai",  // or: gemini, claude, openrouter
        APIKey:   os.Getenv("OPENAI_API_KEY"),
        Features: ai.AIFeatures{
            ChatEnabled:         true,
            Model:               "gpt-4o-mini",
            MaxTokens:           1000,
            MaxCompletionTokens: 500,
            Temperature:         0.7,
        },
    },
}

// config/bytedocs.php
'ai' => [
    'enabled' => env('BYTEDOCS_AI_ENABLED', true),
    'provider' => env('BYTEDOCS_AI_PROVIDER', 'openai'),
    'api_key' => env('BYTEDOCS_AI_API_KEY'),
    'features' => [
        'chat_enabled' => true,
        'model' => env('BYTEDOCS_AI_MODEL', 'gpt-4o-mini'),
        'max_tokens' => 1000,
        'temperature' => 0.7,
    ],
],

=== API SPECIFICATION ===
API Title: My API
Version: 1.0.0

=== ENDPOINTS ===
GET /users/{id}
  Parameters:
    - id (path, integer, required)
  Response 200: User object
    - id: integer
    - name: string (required)
    - email: string (required, format: email)

POST /users
  Request Body:
    - name: string (required)
    - email: string (required)
  Response 201: User object

=== STRICT INSTRUCTIONS ===
- ONLY answer questions related to this API
- Use the provided specification as source of truth
- Provide code examples when helpful

To create a user, send a POST request to /users with JSON body:

{
  "name": "John Doe",
  "email": "john@example.com"
}

Example with cURL:
curl -X POST http://localhost:8080/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John Doe","email":"john@example.com"}'

Example with JavaScript:
fetch('http://localhost:8080/users', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'John Doe',
    email: 'john@example.com'
  })
})

This API uses Bearer token authentication.

Add the Authorization header to your requests:
Authorization: Bearer YOUR_TOKEN_HERE

Example:
curl -H "Authorization: Bearer abc123" \
  http://localhost:8080/users

import requests

response = requests.get('http://localhost:8080/users')
users = response.json()

for user in users:
    print(f"{user['name']} - {user['email']}")

A 400 error typically means validation failed. Check that:

1. name is provided (required)
2. email is provided (required)
3. email is a valid email format

Make sure your request includes both fields:
{
  "name": "John Doe",
  "email": "john@example.com"
}

Available user endpoints:

1. GET /users - List all users
2. GET /users/{id} - Get specific user
3. POST /users - Create new user
4. PUT /users/{id} - Update user
5. DELETE /users/{id} - Delete user

Temperature: 0.0  // Deterministic, same answer every time
Temperature: 0.7  // Balanced (recommended)
Temperature: 1.0  // More creative/varied

MaxTokens: 500   // Short responses
MaxTokens: 1000  // Medium (recommended)
MaxTokens: 2000  // Long, detailed responses

MaxCompletionTokens: 500  // Shorter answers, lower cost

# Test your API key
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

// This would require code modification
// Not recommended for production

POST /docs/chat
Content-Type: application/json

{
  "message": "How do I create a user?"
}

{
  "response": "To create a user, send a POST request to /users...",
  "usage": {
    "prompt_tokens": 1234,
    "completion_tokens": 567,
    "total_tokens": 1801
  },
  "model": "gpt-4o-mini"
}