- name
- naga_control
- description
- Naga 自身控制能力。暂停/恢复语音和Live2D、切换模型/角色、管理会话/技能、控制音乐播放、启停旅行等。当用户要求控制自身功能时使用。
- version
- 1.0.0
- author
- Naga Team
- tags
- ["control","voice","live2d","model","music","self-management"]
- enabled
- true
# Naga 自身控制
通过 `agentType: "naga_control"` 调用,直接控制 Naga 自身的运行状态和配置。
## 调用格式
```tool
{"agentType": "naga_control", "action": "动作名", "params": {参数}}
```
## 可用动作
| 动作 | 用途 | 参数 |
|------|------|------|
| `get_config` | 读取配置 | `section?`(string,如 "api"、"system"、"tts") |
| `update_config` | 修改配置并持久化 | `config`(object,如 {"api": {"temperature": 0.5}}) |
| `get_status` | 获取系统状态 | 无 |
| `toggle_voice` | 暂停/恢复语音 | `enabled`(bool) — 运行时暂停,不改设置 |
| `toggle_live2d` | 暂停/恢复Live2D | `enabled`(bool) — 运行时暂停,不改设置 |
| `set_model` | 切换LLM模型 | `model`(string); `base_url?`, `api_key?` |
| `list_characters` | 列出可用角色 | 无 |
| `switch_character` | 切换角色 | `character`(string) |
| `list_sessions` | 列出会话 | `limit?`(int) |
| `clear_session` | 清空会话 | `session_id`(string) |
| `list_skills` | 列出技能 | 无 |
| `toggle_skill` | 启停技能 | `name`(string), `enabled`(bool) |
| `list_mcp_services` | 列出MCP服务 | 无 |
| `play_music` | 控制音乐播放 | `action`("play"/"pause"/"next"/"prev"/"toggle"); `track?`(文件名) |
| `start_travel` | 启动旅行 | `time_limit?`, `credit_limit?` |
| `stop_travel` | 停止旅行 | 无 |
| `get_memory_stats` | 记忆统计 | 无 |
| `send_notification` | 发送通知 | `message`(string), `type?`("info"/"warning"/"error") |
## 重要说明
- `toggle_voice` / `toggle_live2d` 是**运行时暂停/恢复**,不修改用户设置。只有用户明确要求"修改设置"时才用 `update_config`。
- `play_music` 的 `action` 参数:`play` 播放(可指定 track 文件名)、`pause` 暂停、`next` 下一首、`prev` 上一首、`toggle` 切换播放/暂停。
## 示例
暂停语音:
```tool
{"agentType": "naga_control", "action": "toggle_voice", "params": {"enabled": false}}
```
查看当前模型:
```tool
{"agentType": "naga_control", "action": "get_config", "params": {"section": "api"}}
```
修改温度:
```tool
{"agentType": "naga_control", "action": "update_config", "params": {"config": {"api": {"temperature": 0.5}}}}
```
随机播放音乐:
```tool
{"agentType": "naga_control", "action": "play_music", "params": {"action": "play"}}
```
播放指定曲目:
```tool
{"agentType": "naga_control", "action": "play_music", "params": {"action": "play", "track": "8.日常的小曲.mp3"}}
```
Ver no GitHub