Agent API参考

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

认证方式

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

Authorization: Bearer <key_id>|<secret_key>

获取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> 删除密钥

权限说明

错误响应

{
  "success": false,
  "error": {
    "code": 400,
    "message": "错误信息",
    "details": {}
  }
}