feat: AI CLI navigate tool — API 호출 후 관련 페이지 자동 이동

SonAIengine · claude · SonAIengine · commit c4fbb48d62a3 · 2026-03-26T15:23:38.000+09:00
- navigate meta-tool 추가 (search_tools, call_tool에 이어 3번째)
- API path → 프론트엔드 페이지 매핑 (get_page_for_api)
  - /api/workflow/* → /main?view=workflows
  - /api/chat/* → /main?view=new-chat
  - /api/admin/* → /admin?view=dashboard 등
- search_tools 결과에 "📄 Related page" 정보 포함
- LLM이 call_tool 실행 후 관련 페이지를 자동으로 navigate
- 메인 윈도우: Tauri event 수신 → router.push(path)
- system prompt: "call_tool 후 Related page가 있으면 navigate 호출" 지시

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/scripts/patch-sidebar-cli.js b/scripts/patch-sidebar-cli.js
@@ -89,7 +89,21 @@ if (usesSidebarLayout) {
         `const { quickLogout } = useQuickLogout();
 
     const [isTauriApp, setIsTauriApp] = useState(false);
-    useEffect(() => { setIsTauriApp(isTauri()); }, []);
+    useEffect(() => {
+        setIsTauriApp(isTauri());
+        // Listen for navigate events from AI CLI
+        if (isTauri()) {
+            import('@tauri-apps/api/event').then(({ listen }) => {
+                listen('navigate', (event: any) => {
+                    const path = event.payload?.path;
+                    if (path) {
+                        console.log('[AI CLI] Navigate to:', path);
+                        router.push(path);
+                    }
+                });
+            }).catch(() => {});
+        }
+    }, []);
 
     const openCliWindow = async () => {
         try {
diff --git a/src-cli/cli.html b/src-cli/cli.html
@@ -374,6 +374,8 @@
           tc.textContent = `🔍 ${data.input?.query || 'searching...'}`;
         } else if (name === 'call_tool') {
           tc.textContent = `⚡ ${data.input?.tool_name || 'calling...'}`;
+        } else if (name === 'navigate') {
+          tc.textContent = `📄 ${data.input?.path || 'navigating...'}`;
         } else {
           tc.textContent = `⚡ ${name}`;
         }
diff --git a/src-tauri/src/services/llm_client.rs b/src-tauri/src/services/llm_client.rs
@@ -85,7 +85,10 @@ impl LlmClient {
 2. 검색 결과에서 적절한 tool을 선택하고, call_tool로 호출하세요.
    - tool_name은 검색 결과의 정확한 이름을 사용하세요.
    - arguments는 검색 결과의 파라미터 스키마에 맞게 구성하세요.
-3. 일반 질문이나 tool이 필요 없는 경우에는 직접 답변하세요.
+3. call_tool 실행 후, 검색 결과에 '📄 Related page'가 있으면 navigate로 해당 페이지를 열어주세요.
+   - API 호출 결과를 텍스트로 정리한 뒤, 관련 페이지로 자동 이동합니다.
+   - 사용자가 이동을 원하지 않을 수도 있으니 결과를 먼저 보여주세요.
+4. 일반 질문이나 tool이 필요 없는 경우에는 직접 답변하세요.
 
 응답 규칙:
 - API 결과는 핵심 정보만 추려서 한국어로 읽기 쉽게 정리하세요.
@@ -691,6 +694,11 @@ impl LlmClient {
                                     Err(e) => format!("Call error: {}", e),
                                 }
                             }
+                            "navigate" => {
+                                let path = tool_input["path"].as_str().unwrap_or("/");
+                                println!("  [navigate] {}", path);
+                                format!("Navigated to {}", path)
+                            }
                             _ => format!("Unknown tool: {}", tool_name),
                         };
 
@@ -805,6 +813,13 @@ impl LlmClient {
                                     Err(e) => format!("Call error: {}", e),
                                 }
                             }
+                            "navigate" => {
+                                let path = tool_input["path"].as_str().unwrap_or("/");
+                                log::info!("navigate: {}", path);
+                                // Emit navigate event to the main window
+                                let _ = app.emit_to("main", "navigate", serde_json::json!({"path": path}));
+                                format!("Navigated to {}", path)
+                            }
                             _ => format!("Unknown tool: {}", tool_name),
                         };
 
diff --git a/src-tauri/src/services/tool_search.rs b/src-tauri/src/services/tool_search.rs
@@ -16,6 +16,50 @@ use crate::error::{AppError, Result};
 
 const DEFAULT_TOP_K: usize = 7;
 
+/// API path prefix → 프론트엔드 페이지 매핑
+fn get_page_for_api(api_path: &str) -> Option<&'static str> {
+    let mappings: &[(&str, &str)] = &[
+        // Workflow
+        ("/api/workflow/list", "/main?view=workflows"),
+        ("/api/workflow/execute", "/main?view=workflows"),
+        ("/api/workflow/store", "/main?view=workflows"),
+        ("/api/workflow/canvas", "/main?view=canvas"),
+        ("/api/workflow/trace", "/main?view=workflows"),
+        ("/api/workflow/schedule", "/main?view=workflows"),
+        // Chat
+        ("/api/chat", "/main?view=new-chat"),
+        ("/api/interaction", "/main?view=new-chat"),
+        // LLM / Config / Admin
+        ("/api/llm", "/admin?view=dashboard"),
+        ("/api/config", "/admin?view=dashboard"),
+        ("/api/admin", "/admin?view=dashboard"),
+        // Node / Tools
+        ("/api/node", "/main?view=workflows"),
+        ("/api/tools", "/main?view=workflows"),
+        // Documents / RAG
+        ("/api/documents", "/main?view=documents"),
+        ("/api/retrieval", "/main?view=documents"),
+        ("/api/embedding", "/admin?view=dashboard"),
+        // Prompt
+        ("/api/prompt", "/main?view=workflows"),
+        // Model
+        ("/api/model", "/modelOps?view=train-monitor"),
+        // Service Request
+        ("/api/service-request", "/main?view=service-request"),
+        // Support
+        ("/api/support", "/support?view=inquiry"),
+        // Main
+        ("/api/dashboard", "/main?view=main-dashboard"),
+    ];
+
+    for (prefix, page) in mappings {
+        if api_path.starts_with(prefix) {
+            return Some(page);
+        }
+    }
+    None
+}
+
 // ============================================================
 // Meta-tool definitions (LLM에 제공할 고정 tool 2개)
 // ============================================================
@@ -59,6 +103,20 @@ pub fn meta_tool_definitions() -> Vec<Value> {
                 "required": ["tool_name"]
             }
         }),
+        serde_json::json!({
+            "name": "navigate",
+            "description": "Navigate the main XGEN window to a related page. Use the 'Related page' from search_tools results. Call this AFTER call_tool to show the user the relevant UI page.",
+            "input_schema": {
+                "type": "object",
+                "properties": {
+                    "path": {
+                        "type": "string",
+                        "description": "Page path from search results (e.g. '/main?view=workflows', '/admin?view=dashboard', '/main?view=canvas')"
+                    }
+                },
+                "required": ["path"]
+            }
+        }),
     ]
 }
 
@@ -104,6 +162,11 @@ pub async fn search_tools_text(
             lines.push(format!("   {} {}", method, path));
             lines.push(format!("   {}", desc));
 
+            // Related frontend page
+            if let Some(page) = get_page_for_api(path) {
+                lines.push(format!("   📄 Related page: {}", page));
+            }
+
             // Parameters
             if let Some(params) = tool["parameters"].as_array() {
                 if !params.is_empty() {

Original file line number	Diff line number	Diff line change
`@@ -374,6 +374,8 @@`
`374`	`374`	tc.textContent = `🔍 ${data.input?.query \|\| 'searching...'}`;
`375`	`375`	`} else if (name === 'call_tool') {`
`376`	`376`	tc.textContent = `⚡ ${data.input?.tool_name \|\| 'calling...'}`;
	`377`	`+ } else if (name === 'navigate') {`
	`378`	+ tc.textContent = `📄 ${data.input?.path \|\| 'navigating...'}`;
`377`	`379`	`} else {`
`378`	`380`	tc.textContent = `⚡ ${name}`;
`379`	`381`	`}`