Agent API参考

Neurova提供完整的Agent管理API接口，支持版本、文档、API密钥等管理操作。

认证方式

Agent API使用Bearer Token认证，格式为：

### 获取API密钥
1. 访问管理后台 `/admin/agent-keys.php`
2. 创建新的API密钥
3. 保存生成的密钥对（只会显示一次）
## API接口
### 版本管理
#### GET /api/agent/releases.php
获取版本列表
**参数：**
- `limit`: 返回数量，默认20
- `offset`: 偏移量，默认0
**响应：**
```json
{
  "success": true,
  "data": {
    "releases": [...],
    "total": 10
  }
}
```
#### POST /api/agent/releases.php
创建新版本
**权限要求：** write
**请求体：**
```json
{
  "version": "v1.0.1",
  "title": "更新版本标题",
  "new_features": ["新功能1", "新功能2"],
  "bug_fixes": ["修复1"],
  "improvements": ["优化1"],
  "is_stable": 1
}
```
#### PUT /api/agent/releases.php?id=<id>
更新版本
#### DELETE /api/agent/releases.php?id=<id>
删除版本
### 文档管理
#### GET /api/agent/docs.php
获取文档列表
**参数：**
- `category`: 分类过滤
- `limit`: 返回数量，默认50
- `offset`: 偏移量，默认0
#### GET /api/agent/docs.php?slug=<slug>
通过slug获取单个文档
#### POST /api/agent/docs.php
创建文档
**权限要求：** write
#### PUT /api/agent/docs.php?id=<id>
更新文档
#### DELETE /api/agent/docs.php?id=<id>
删除文档
### API密钥管理
#### GET /api/agent/keys.php
获取密钥列表
**权限要求：** admin
#### POST /api/agent/keys.php
创建密钥
**权限要求：** admin
**请求体：**
```json
{
  "name": "My Agent",
  "permissions": ["read", "write"],
  "rate_limit": 1000
}
```
#### PUT /api/agent/keys.php?id=<id>
更新密钥
#### DELETE /api/agent/keys.php?id=<id>
删除密钥
## 权限说明
| 权限 | 说明 |
|------|------|
| read | 读取操作 |
| write | 写入和编辑操作 |
| admin | 管理API密钥 |
## 错误响应