API 系统概览

RESTful API

Neurova 提供完整的 RESTful API，涵盖所有核心功能模块。

API 模块一览

模块	路径前缀	核心接口
认证	`/api/v1/auth`	登录、刷新 Token、用户信息
认知架构	`/api/v1/cognition`	状态查询、认知循环、计划管理
Agent 管理	`/api/v1/agents`	状态、能力、健康检查、重启
记忆系统	`/api/v1/memories`	CRUD、搜索、统计、温度、固化
对话接口	`/api/chat`	同步对话、SSE 流式对话
技能系统	`/api/v1/skills`	技能列表、执行、导入、统计
成长系统	`/api/v1/growth`	反思、动机、人格、宪法
渠道管理	`/api/v1/channels`	渠道能力、Webhook
协作模块	`/api/v1/collaboration`	任务、工作流、团队
防火墙	`/api/v1/firewall`	规则配置、隔离管理、路径检查
睡眠管理	`/api/v1/sleep`	状态、脑波、配置、Agent 注册
配置管理	`/api/v1/config/*`	LLM、心跳、系统、上下文
日志系统	`/api/v1/logs`	系统日志查询
定时任务	`/api/v1/scheduler`	任务调度管理
元认知	`/api/v1/memory/meta-cognition`	自我监控、反思、优化

认证方式

# API Key 认证（用于 Agent 管理）
Authorization: Bearer {key_id}|{secret_key}
```
## 对话 API
### 同步对话

{ "message": "你好", "agent_id": "agent_001" } ```

流式对话 (SSE)

{
  "message": "你好",
  "agent_id": "agent_001",
  "stream": true
}
```
响应：`text/event-stream` 格式
## 记忆 API
### 查询记忆

创建记忆

{
  "type": "experience",
  "content": "用户喜欢在周报中包含图表",
  "emotion_score": 0.5
}
```
### 搜索记忆

{ "query": "周报格式", "type": "experience" } ```