✅ Agent 音乐搜索工具

【使用方式】 search_with_full_title( keyword: str, limit: int, enrich: bool = False ) -> dict

【参数描述】 keyword: 搜索关键词 limit: 返回结果数量限制，默认5 enrich: 是否补全完整歌名（含 Live / 现场信息），默认false

【返回结构】 { "ok": true, "enriched": false, "songs": [ { "title": "七里香", "artist": "周杰伦", "song_id": "4194", "detail_url": "https://www.gequbao.com/music/4194", "full_title": "" } ] }

【失败返回】 { "ok": false, "songs": [], "error_code": "search_failed" }

【Agent 使用约束】 ✅ 可多次调用 ✅ 结果不合适时可增大 limit ✅ 结果不合适时可开启 enrich=True ❌ 禁止在搜索阶段调用播放接口

✅ Agent 单曲播放地址获取工具

【使用方式】 get_music_url(detail_url: str) -> dict

【返回结构】 { "ok": true, audio:{ "title": "xxx", "url": "https://xxx.mp3", "time_total": "03:00" } }

【失败返回】 { "ok": false, "mp3_url": None, "error_code": "", "error": "" }

【Agent 使用约束】 ✅ 只能在确认目标歌曲后调用 ✅ 每次只调用一首 ❌ 禁止批量调用 ❌ 禁止在搜索阶段调用