naga-control

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 自身的运行状态和配置。

调用格式

{"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 切换播放/暂停。

示例

暂停语音:

{"agentType": "naga_control", "action": "toggle_voice", "params": {"enabled": false}}

查看当前模型:

{"agentType": "naga_control", "action": "get_config", "params": {"section": "api"}}

修改温度:

{"agentType": "naga_control", "action": "update_config", "params": {"config": {"api": {"temperature": 0.5}}}}

随机播放音乐:

{"agentType": "naga_control", "action": "play_music", "params": {"action": "play"}}

播放指定曲目:

{"agentType": "naga_control", "action": "play_music", "params": {"action": "play", "track": "8.日常的小曲.mp3"}}