naga_control

Naga self-control

Via agentType: "naga_control" call, directly control Naga's own running state and configuration.

Call format

{"agentType": "naga_control", "action": "动作名", "params": {参数}}

Available actions

Action	Purpose	Parameters
get_config	Read configuration	section?(string, such as "api", "system", "tts")
update_config	Modify configuration and persist	config(object, such as {"api": {"temperature": 0.5}})
get_status	Get system status	None
toggle_voice	Pause/resume voice	enabled(bool) — pause at runtime, does not change settings
toggle_live2d	Pause/resume Live2D	enabled(bool) — pause at runtime, does not change settings
set_model	Switch LLM model	model(string); base_url?, api_key?
list_characters	List available characters	None
switch_character	Switch character	character(string)
list_sessions	List sessions	limit?(int)
clear_session	Clear session	session_id(string)
list_skills	List skills	None
toggle_skill	Start/stop skills	name(string), enabled(bool)
list_mcp_services	List MCP services	None
play_music	Control music playback	action("play"/"pause"/"next"/"prev"/"toggle"); track?(filename)
start_travel	Start travel	time_limit?, credit_limit?
stop_travel	Stop travel	None
get_memory_stats	Memory statistics	None
send_notification	Send notification	message(string), type?("info"/"warning"/"error")

Important notes

• toggle_voice / toggle_live2d isruntime pause/resume, does not modify user settings. Only use update_config。
• play_music 's action parameter:play play (can specify track filename),pause pause,next next track,prev previous track,toggle toggle play/pause.

Examples

Pause voice:

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

View current model:

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

Modify temperature:

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

Shuffle music:

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

Play specified track:

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