feat : 統一agents 回饋json 格式

services/agents.py

@@ -38,7 +38,7 @@ def generate_and_upload_image(prompt: str) -> str:
         prompt: 用於生成圖片的文字提示。
         
     Returns:
-        回傳生成圖片的 URL。
+        一個 JSON 格式的字串，包含圖片 URL 和描述，或錯誤訊息。
     """
     try:
         # 呼叫 Google GenAI 模型生成內容
@@ -65,11 +65,21 @@ def generate_and_upload_image(prompt: str) -> str:
             # 從環境變數獲取 Hugging Face Space 的 URL (或你的伺服器 URL)
             # 並組合完整的圖片 URL
             image_url = os.path.join(os.getenv("HF_SPACE"), file_name) # Embed this Space
-            return image_url
+            # 統一回傳 JSON 成功格式
+            return json.dumps({
+                "image_url": image_url,
+                "text_result": f"圖片已成功生成並上傳。這是根據提示 '{prompt[:50]}...' 生成的圖片。"
+            })
             
-        return "圖片生成失敗。"
+        # 處理圖片生成失敗但 API 未報錯的情況
+        return json.dumps({
+            "error": "圖片生成失敗。API 回應中未包含圖片數據，請嘗試修改提示詞。"
+        })
     except Exception as e:
-        return f"圖片生成與上傳失敗: {e}"
+        error_msg = f"圖片生成與上傳失敗: {e}"
+        return json.dumps({
+            "error": error_msg
+        })
 
 @tool
 def analyze_image_with_text(image_path: str, user_text: str) -> str:
@@ -81,12 +91,14 @@ def analyze_image_with_text(image_path: str, user_text: str) -> str:
         user_text: 針對圖片提出的文字問題。
         
     Returns:
-        模型針對圖片和文字提示給出的回應。
+        一個 JSON 格式的字串，包含模型回應或錯誤訊息。
     """
     try:
         # 檢查圖片路徑是否存在
         if not os.path.exists(image_path):
-            return "圖片路徑無效，無法進行分析。"
+            return json.dumps({
+                "error": "圖片路徑無效，無法進行分析。"
+            })
             
         # 使用 PIL 開啟圖片
         img_user = PIL.Image.open(image_path)
@@ -99,11 +111,20 @@ def analyze_image_with_text(image_path: str, user_text: str) -> str:
             out = response.text
         else:
             out = "Gemini沒答案!請換個說法！"
+
+        # 統一回傳 JSON 成功格式 (只有文字結果)
+        return json.dumps({
+            "text_result": out
+        })
+    
     except Exception as e:
         # 處理錯誤
         out = f"Gemini執行出錯: {e}"
+        # 統一回傳 JSON 錯誤格式
+        return json.dumps({
+            "error": out
+        })
         
-    return out
 
 @tool
 def deblur_image_from_url(

services/linebot.py

@@ -12,7 +12,7 @@ from linebot.models import (  # 匯入 Line Bot 的各種訊息模型
     ImageMessage,
     FollowEvent
 )
-
+import json
 from agents import agent_executor
 
 load_dotenv()
@@ -138,26 +138,53 @@ def handle_message(event):
         try:
             # 運行 LangChain 代理人
             response = agent_executor.invoke(agent_input)
-            # 獲取代理人最終的輸出
-            out = response["output"]
+            # Agent 的輸出是 JSON 字串 (無論成功或失敗)
+            out_str = response["output"]
+            # 2. 嘗試解析 JSON 輸出
+            result = json.loads(out_str)
+
+            if "error" in result:
+                # 3A. 處理錯誤情況 (例如：圖片下載失敗、API 錯誤)
+                error_msg = result["error"]
+                reply_text = f"🚫 圖片工具執行失敗：\n{error_msg}"
+                line_bot_api.reply_message(event.reply_token, TextSendMessage(text=reply_text))
+            elif "image_url" in result:
+                # 3B. 處理成功情況 (帶有圖片 URL，例如：圖片生成或去模糊工具)
+                image_url = result["image_url"]
+                text_result = result.get("text_result", "圖片處理完成。")
             
-            # 檢查輸出中是否包含 'https' (判斷是否為生成的圖片 URL)
-            if 'https' in out:
-                # 解析 URL (這裡的解析方式比較簡易，可能需要更穩健的正規表達式)
-                img_tmp = 'https'+out.split('https')[1]
-                image_url = img_tmp.split('png')[0]+'png'
+                # Line 要求圖片 URL 必須是 HTTPS
+                # 由於 HF_SPACE 預設是 https，這裡做一個保險轉換
+                if image_url.startswith("http://"):
+                    image_url = image_url.replace("http://", "https://")
                 
-                # 使用 push_message 同時推送文字和圖片
-                line_bot_api.push_message(
-                    event.source.user_id,
+                # 使用 reply_message (或 push_message) 同時推送文字和圖片
+                # 註：reply_message 只能回覆一次。若要一次發送多個訊息，需要使用 list 
+                # 這裡假設 text_result 是主要回覆，圖片作為輔助。
+                line_bot_api.reply_message(
+                    event.reply_token,
                     [
-                        TextSendMessage(text="✨ 這是我為你生成的圖片喔～"),
+                        TextSendMessage(text=f"✨ {text_result}"),
                         ImageSendMessage(original_content_url=image_url, preview_image_url=image_url)
                     ]
                 )
+
+            elif "text_result" in result:
+                # 3C. 處理純文字結果 (例如：多模態分析工具)
+                text_result = result["text_result"]
+                line_bot_api.reply_message(event.reply_token, TextSendMessage(text=text_result))
+            
             else:
-                # 如果輸出不是 URL，則直接回覆文字
-                line_bot_api.reply_message(event.reply_token, TextSendMessage(text=out))
+                # 3D. 處理意外的 JSON 結構
+                line_bot_api.reply_message(
+                    event.reply_token, 
+                    TextSendMessage(text="代理人回覆格式無法識別，請聯繫管理員。")
+                )
+        except json.JSONDecodeError:
+            # 4. 處理 Agent 返回了無法解析的純文字 (非 JSON)
+            # 這通常發生在 Agent 決定不使用工具，直接回覆純文字，或者推理過程出錯。
+            line_bot_api.reply_message(event.reply_token, TextSendMessage(text=out_str))
+
         except Exception as e:
             # 處理代理人執行時的錯誤
             print(f"代理人執行出錯: {e}")