接口联调

offline-backend-20260512/backend/app/gateway/routers/agents.py

@@ -60,6 +60,10 @@ class AgentsListResponse(BaseModel):
 class AgentCreateRequest(BaseModel):
     """Request body for creating a custom agent."""
 
+    id: str | None = Field(
+        default=None,
+        description="Optional explicit storage id. Must match the storage id pattern. If omitted, a UUID is generated.",
+    )
     name: str = Field(..., description="Display name; Chinese and duplicate names are allowed")
     description: str = Field(default="", description="Agent description")
     soul: str = Field(default="", description="SOUL.md content - agent personality and behavioral guardrails")
@@ -411,13 +415,19 @@ async def get_agent(agent_id: str, request: Request) -> AgentResponse:
 async def create_agent_endpoint(request: AgentCreateRequest, http_request: Request) -> AgentResponse:
     _require_agents_api_enabled()
     name = _validate_display_name(request.name)
-    agent_id = uuid4().hex
+    store = get_agent_store(http_request)
+
+    if request.id:
+        agent_id = _validate_storage_id(request.id)
+        if await store.get_any(agent_id) is not None:
+            raise HTTPException(status_code=409, detail=f"Agent id '{agent_id}' already exists")
+    else:
+        agent_id = uuid4().hex
     agent_dir = get_paths().agent_dir(agent_id)
 
     try:
-        store = get_agent_store(http_request)
         if agent_dir.exists():
-            raise HTTPException(status_code=409, detail=f"Generated agent id '{agent_id}' already exists")
+            raise HTTPException(status_code=409, detail=f"Agent id '{agent_id}' already exists")
 
         _write_agent_config(
             agent_id,

offline-backend-20260512/backend/app/gateway/routers/multi_agent.py

@@ -69,8 +69,11 @@ async def _create_agent(
     model: str | None,
     skills: list[str] | None,
     soul: str,
+    agent_id: str | None = None,
 ) -> tuple[bool, dict[str, Any] | str]:
     payload: dict[str, Any] = {"name": name, "description": description, "soul": soul}
+    if agent_id is not None:
+        payload["id"] = agent_id
     if model is not None:
         payload["model"] = model
     if skills is not None:
@@ -241,6 +244,7 @@ async def init_multi_agent(request: Request, payload: dict = Body(...)) -> dict[
             model=model,
             skills=["agent_orchestration"],
             soul=soul,
+            agent_id=main_agent_name,
         )
         if not ok and isinstance(result, str) and "exists" not in result:
             raise HTTPException(status_code=500, detail=f"create coordinator agent failed: {result}")
@@ -425,19 +429,36 @@ async def run_multi_agent_stream(request: Request, payload: dict = Body(...)) ->
 
     async def stream_generator() -> AsyncIterator[str]:
         async with httpx.AsyncClient(timeout=None) as client:
-            if agent_type == "leader":
-                gen = _leader_run(
-                    client, base, headers, agent_threads, agent_name, new_message, skill_stop_names, model_name,
-                )
-            else:
-                gen = _special_run(
-                    client, base, headers, agent_threads, agent_name, new_message, skill_stop_names, model_name,
-                )
-            async for chunk in gen:
-                if isinstance(chunk, dict):
-                    yield f"data: {json.dumps(chunk, ensure_ascii=False)}\n\n"
+            try:
+                if agent_type == "leader":
+                    gen = _leader_run(
+                        client, base, headers, agent_threads, agent_name, new_message, skill_stop_names, model_name,
+                    )
                 else:
-                    yield chunk if chunk.endswith("\n") else chunk + "\n"
+                    gen = _special_run(
+                        client, base, headers, agent_threads, agent_name, new_message, skill_stop_names, model_name,
+                    )
+                async for chunk in gen:
+                    if isinstance(chunk, dict):
+                        yield f"data: {json.dumps(chunk, ensure_ascii=False)}\n\n"
+                    else:
+                        yield chunk if chunk.endswith("\n") else chunk + "\n"
+            except HTTPException as exc:
+                logger.warning("multi-agent stream HTTPException: %s %s", exc.status_code, exc.detail)
+                err_frame = {
+                    "status": "error",
+                    "content": f"[{exc.status_code}] {exc.detail}",
+                    "agent_name": agent_name,
+                }
+                yield f"data: {json.dumps(err_frame, ensure_ascii=False)}\n\n"
+            except Exception as exc:
+                logger.exception("multi-agent stream unexpected failure")
+                err_frame = {
+                    "status": "error",
+                    "content": f"unexpected: {exc!r}",
+                    "agent_name": agent_name,
+                }
+                yield f"data: {json.dumps(err_frame, ensure_ascii=False)}\n\n"
 
     return StreamingResponse(
         stream_generator(),

offline-backend-20260512/backend/config.yaml

@@ -130,8 +130,11 @@ agents_api:
   enabled: true
 
 database:
-  backend: mysql
-  mysql_url: $MYSQL_DATABASE_URL
+  # TODO: 临时切到 SQLite，等 192.168.0.123 MySQL 恢复后改回 backend: mysql
+  backend: sqlite
+  sqlite_dir: .deer-flow/data
+  # backend: mysql
+  # mysql_url: $MYSQL_DATABASE_URL
   pool_size: 10
   echo_sql: false