Merge branch 'develop' of https://github.com/ModelEngine-Group/nexent into pyh/feat_agent_configuration_develop

Author: YehongPan

backend/database/agent_db.py

@@ -76,14 +76,15 @@ def create_agent(agent_info, tenant_id: str, user_id: str):
     :param user_id:
     :return: Created agent object
     """
-    agent_info.update({
+    info_with_metadata = dict(agent_info)
+    info_with_metadata.setdefault("max_steps", 5)
+    info_with_metadata.update({
         "tenant_id": tenant_id,
         "created_by": user_id,
         "updated_by": user_id,
-        "max_steps": 5
     })
     with get_db_session() as session:
-        new_agent = AgentInfo(**filter_property(agent_info, AgentInfo))
+        new_agent = AgentInfo(**filter_property(info_with_metadata, AgentInfo))
         new_agent.delete_flag = 'N'
         session.add(new_agent)
         session.flush()

doc/docs/zh/opensource-memorial-wall.md

@@ -15,6 +15,7 @@
 每条消息应包含您的姓名/昵称和日期。
 请保持消息的礼貌和尊重，符合我们的行为准则。
 -->
+
 ::: info happyzhang - 2025-11-13
 也许我们正见证着未来的“后起之秀”😀
 :::
@@ -413,3 +414,10 @@ Nexent功能如此之强大，给我很多帮助，感谢开发者！厉害
 第一次参加，加油
 :::
 
+:::  info user - 2025-11-17
+感谢 Nexent 让我第一次接触到智能体，希望参加ICT比赛过程中可以学到更多知识！
+:::
+
+::: tip kon-do - 2025-11-17
+感谢 Nexent 让我踏上了开源之旅！这个项目的文档真的很棒，帮助我快速上手。
+:::

…end/app/[locale]/setup/agents/config.tsx …p/[locale]/agents/AgentConfiguration.tsxfrontend/app/[locale]/setup/agents/config.tsx renamed to frontend/app/[locale]/agents/AgentConfiguration.tsx frontend/app/[locale]/setup/agents/config.tsx renamed to frontend/app/[locale]/agents/AgentConfiguration.tsx

@@ -36,7 +36,7 @@ import { configStore } from "@/lib/config";
 import AgentSetupOrchestrator from "./components/AgentSetupOrchestrator";
 import DebugConfig from "./components/DebugConfig";
 
-import "../../i18n";
+import "../i18n";
 
 // Layout Height Constant Configuration
 const LAYOUT_CONFIG: LayoutConfig = AGENT_SETUP_LAYOUT_DEFAULT;
@@ -525,13 +525,13 @@ export default forwardRef<AgentConfigHandle, AgentConfigProps>(function AgentCon
         className="w-full mx-auto"
         style={{
           maxWidth: SETUP_PAGE_CONTAINER.MAX_WIDTH,
-          height: SETUP_PAGE_CONTAINER.MAIN_CONTENT_HEIGHT,
+          padding: `0 ${SETUP_PAGE_CONTAINER.HORIZONTAL_PADDING}`,
         }}
       >
         <div
           className={STANDARD_CARD.BASE_CLASSES}
           style={{
-            height: "100%",
+            height: SETUP_PAGE_CONTAINER.MAIN_CONTENT_HEIGHT,
             ...STANDARD_CARD.CONTENT_SCROLL,
           }}
         >

frontend/app/[locale]/agents/AgentsContent.tsx

@@ -0,0 +1,110 @@
+"use client";
+
+import React, {useState, useEffect, useRef} from "react";
+import {motion} from "framer-motion";
+
+import {useSetupFlow} from "@/hooks/useSetupFlow";
+import {
+  ConnectionStatus,
+} from "@/const/modelConfig";
+
+import AgentConfig, {AgentConfigHandle} from "./AgentConfiguration";
+import SaveConfirmModal from "./components/SaveConfirmModal";
+
+interface AgentsContentProps {
+  /** Whether currently saving */
+  isSaving?: boolean;
+  /** Connection status */
+  connectionStatus?: ConnectionStatus;
+  /** Is checking connection */
+  isCheckingConnection?: boolean;
+  /** Check connection callback */
+  onCheckConnection?: () => void;
+  /** Callback to expose connection status */
+  onConnectionStatusChange?: (status: ConnectionStatus) => void;
+  /** Callback to expose saving state */
+  onSavingStateChange?: (isSaving: boolean) => void;
+}
+
+/**
+ * AgentsContent - Main component for agent configuration
+ * Can be used in setup flow or as standalone page
+ */
+export default function AgentsContent({
+  isSaving: externalIsSaving,
+  connectionStatus: externalConnectionStatus,
+  isCheckingConnection: externalIsCheckingConnection,
+  onCheckConnection: externalOnCheckConnection,
+  onConnectionStatusChange,
+  onSavingStateChange,
+}: AgentsContentProps) {
+  const agentConfigRef = useRef<AgentConfigHandle | null>(null);
+  const [showSaveConfirm, setShowSaveConfirm] = useState(false);
+  const pendingNavRef = useRef<null | (() => void)>(null);
+  
+  // Use custom hook for common setup flow logic
+  const {
+    canAccessProtectedData,
+    pageVariants,
+    pageTransition,
+  } = useSetupFlow({
+    requireAdmin: true,
+    externalConnectionStatus,
+    externalIsCheckingConnection,
+    onCheckConnection: externalOnCheckConnection,
+    onConnectionStatusChange,
+    nonAdminRedirect: "/setup/knowledges",
+  });
+
+  const [internalIsSaving, setInternalIsSaving] = useState(false);
+  const isSaving = externalIsSaving ?? internalIsSaving;
+
+  // Update external saving state
+  useEffect(() => {
+    onSavingStateChange?.(isSaving);
+  }, [isSaving, onSavingStateChange]);
+
+  return (
+    <>
+      <motion.div
+        initial="initial"
+        animate="in"
+        exit="out"
+        variants={pageVariants}
+        transition={pageTransition}
+        style={{width: "100%", height: "100%"}}
+      >
+        {canAccessProtectedData ? (
+          <AgentConfig ref={agentConfigRef} canAccessProtectedData={canAccessProtectedData} />
+        ) : null}
+      </motion.div>
+
+      <SaveConfirmModal
+        open={showSaveConfirm}
+        onCancel={async () => {
+          // Reload data from backend to discard changes
+          await agentConfigRef.current?.reloadCurrentAgentData?.();
+          setShowSaveConfirm(false);
+          const go = pendingNavRef.current;
+          pendingNavRef.current = null;
+          if (go) go();
+        }}
+        onSave={async () => {
+          try {
+            setInternalIsSaving(true);
+            await agentConfigRef.current?.saveAllChanges?.();
+            setShowSaveConfirm(false);
+            const go = pendingNavRef.current;
+            pendingNavRef.current = null;
+            if (go) go();
+          } catch (e) {
+            // errors are surfaced by underlying save
+          } finally {
+            setInternalIsSaving(false);
+          }
+        }}
+      />
+    </>
+  );
+}
+

…ts/components/AgentSetupOrchestrator.tsx …ts/components/AgentSetupOrchestrator.tsxfrontend/app/[locale]/setup/agents/components/AgentSetupOrchestrator.tsx renamed to frontend/app/[locale]/agents/components/AgentSetupOrchestrator.tsx frontend/app/[locale]/setup/agents/components/AgentSetupOrchestrator.tsx renamed to frontend/app/[locale]/agents/components/AgentSetupOrchestrator.tsx

@@ -4,7 +4,7 @@ import { useState, useEffect, useCallback, useRef, useMemo } from "react";
 import { useTranslation } from "react-i18next";
 import { TFunction } from "i18next";
 
-import { App, Modal, Typography, Button } from "antd";
+import { App, Modal, Button } from "antd";
 import { WarningFilled } from "@ant-design/icons";
 
 import { TooltipProvider } from "@/components/ui/tooltip";