[Improvement] The suffixes of LLM and embedding models are not consistent during configuration #1402

Author: Zhi-a

doc/docs/en/user-guide/model-configuration.md

@@ -19,6 +19,12 @@ Nexent will soon support seamless integration with the ModelEngine platform, ena
    - **Display Name:** Optionally set a display name for the model (defaults to the model name).
    - **Model URL (required):** Enter the API endpoint provided by the model provider.
    - **API Key:** Enter your API key.
+
+> ⚠️ **Notes**:
+> 1. Obtain the model name from the model provider, typically in the format `model series/model name`. For example, if the model series is `Qwen` and the model name is `Qwen3-8B`, the model name is `Qwen/Qwen3-8B`.
+> 2. Obtain the model URL from the model provider's API documentation. For example, if the model provider is Silicon Flow, the URL for the large language model is `https://api.siliconflow.cn/v1`, the URL for the vector model is `https://api.siliconflow.cn/v1/embeddings`, and the URL for the visual language model is `https://api.siliconflow.cn/v1`.
+> 3. Create and obtain an API key from the model provider's API key management page.
+
 4. **Connectivity Verification**
    - Click the "Verify" button. The system will send a test request and return the result.
 5. **Save Model**

doc/docs/zh/user-guide/model-configuration.md

@@ -9,7 +9,7 @@ Nexent即将支持与ModelEngine平台的无缝对接，届时可自动同步并
 ## 🛠️ 添加自定义模型
 
 ### 添加单个模型
-
+#### 添加单个模型步骤
 1. **添加自定义模型**
    - 点击"添加自定义模型"按钮，进入添加模型弹窗。
 2. **选择模型类型**
@@ -19,6 +19,12 @@ Nexent即将支持与ModelEngine平台的无缝对接，届时可自动同步并
    - **展示名称**：可为模型设置一个展示名称，默认与模型名称相同。
    - **模型URL（必填）**：输入模型提供商的API端点。
    - **API Key**：输入您的API密钥。
+
+> ⚠️ **注意事项**：
+> 1. 模型名称通过模型提供商获取，通常格式为`模型系列/模型名字`。以模型系列是`Qwen`，模型名字是`Qwen3-8B`为例，模型名称为`Qwen/Qwen3-8B`。
+> 2. 模型URL通过模型提供商的API文档获取。以模型提供商是硅基流动为例，大语言模型URL为`https://api.siliconflow.cn/v1` ，向量模型URL为`https://api.siliconflow.cn/v1/embeddings` ，视觉语言模型URL为`https://api.siliconflow.cn/v1` 。
+> 3. API Key通过模型提供商的API Key密钥管理页面创建并获取API Key。
+
 4. **连通性验证**
    - 点击"连通性验证"按钮，系统会发送测试请求并返回验证结果。
 5. **保存模型**
@@ -34,7 +40,7 @@ Nexent即将支持与ModelEngine平台的无缝对接，届时可自动同步并
 
 1. **批量添加模型**
    - 在添加模型弹窗中，打开批量添加模型开关。
-4. **选择模型提供商**
+2. **选择模型提供商**
    - 点击模型提供商下拉框，选择模型提供商。
 3. **选择模型类型**
    - 点击模型类型下拉框，选择要添加的模型类型（大语言模型/向量化模型/视觉语言模型）。

frontend/app/[locale]/setup/models/components/model/ModelAddDialog.tsx

@@ -645,9 +645,56 @@ export const ModelAddDialog = ({ isOpen, onClose, onSuccess }: ModelAddDialogPro
               <InfoCircleFilled className="text-md text-blue-500 mr-3" />
               <p className="font-bold text-medium">{t('model.dialog.help.title')}</p>
             </div>
-            <p className="mt-0.5 ml-6">
-              {form.isBatchImport ? t('model.dialog.help.content.batchImport') : t('model.dialog.help.content')}
-            </p>
+            <div className="mt-0.5 ml-6">
+              {(form.isBatchImport ? t('model.dialog.help.content.batchImport') : t('model.dialog.help.content')).split('\n').map((line, index) => {
+                // Parse Markdown-style links: [text](url)
+                const markdownLinkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+                const parts: (string | { text: string; url: string })[] = [];
+                let lastIndex = 0;
+                let match;
+                
+                while ((match = markdownLinkRegex.exec(line)) !== null) {
+                  // Add text before the link
+                  if (match.index > lastIndex) {
+                    parts.push(line.substring(lastIndex, match.index));
+                  }
+                  // Add the link object
+                  parts.push({ text: match[1], url: match[2] });
+                  lastIndex = match.index + match[0].length;
+                }
+                
+                // Add remaining text after the last link
+                if (lastIndex < line.length) {
+                  parts.push(line.substring(lastIndex));
+                }
+                
+                // If no links found, just add the whole line
+                if (parts.length === 0) {
+                  parts.push(line);
+                }
+                
+                return (
+                  <p key={index} className={index > 0 ? 'mt-1' : ''}>
+                    {parts.map((part, partIndex) => {
+                      if (typeof part === 'object') {
+                        return (
+                          <a 
+                            key={partIndex}
+                            href={part.url} 
+                            target="_blank" 
+                            rel="noopener noreferrer"
+                            className="text-blue-600 hover:text-blue-800 underline"
+                          >
+                            {part.text}
+                          </a>
+                        );
+                      }
+                      return <span key={partIndex}>{part}</span>;
+                    })}
+                  </p>
+                );
+              })}
+            </div>
             <div className="mt-2 ml-6 flex items-center">
               <span>{t('model.dialog.label.currentlySupported')}</span>
               {form.isBatchImport && (

frontend/public/locales/en/common.json

@@ -551,8 +551,8 @@
   "model.dialog.button.verifying": "Verifying...",
   "model.dialog.button.add": "Add",
   "model.dialog.help.title": "Model Configuration Guide",
-  "model.dialog.help.content": "Please fill in the model's basic information. API Key and display name are optional, other fields are required. It's recommended to verify connectivity before adding the model.",
-  "model.dialog.help.content.batchImport": "Please fill in the provider's basic information. API Key and provider name are required, other fields are optional. It's recommended to verify connectivity before adding the model.",
+  "model.dialog.help.content": "Please fill in the model's basic information. API Key and display name are optional, other fields are required. It's recommended to verify connectivity before adding the model. For detailed configuration methods, please refer to [Model Configuration](https://modelengine-group.github.io/nexent/en/user-guide/model-configuration.html).",
+  "model.dialog.help.content.batchImport": "Please fill in the provider's basic information. API Key and provider name are required, other fields are optional. It's recommended to verify connectivity before adding the model. For detailed configuration methods, please refer to [Model Configuration](https://modelengine-group.github.io/nexent/en/user-guide/model-configuration.html).",
   "model.dialog.warning.incompleteForm": "Please complete the model configuration information first",
   "model.dialog.status.verifying": "Verifying model connectivity...",
   "model.dialog.success.connectivityVerified": "Model connectivity verification successful!",

frontend/public/locales/zh/common.json

@@ -552,8 +552,8 @@
   "model.dialog.button.verifying": "验证中...",
   "model.dialog.button.add": "添加",
   "model.dialog.help.title": "模型配置说明",
-  "model.dialog.help.content": "请填写模型的基本信息，API Key、展示名称为可选项，其他字段为必填项。建议先验证连通性后再添加模型。",
-  "model.dialog.help.content.batchImport": "请填写提供商的基本信息，API Key和提供商名称为必填项，其他字段为可选项。",
+  "model.dialog.help.content": "请填写模型的基本信息，API Key、展示名称为可选项，其他字段为必填项。建议先验证连通性后再添加模型。详细配置方法请参考[模型配置](https://modelengine-group.github.io/nexent/zh/user-guide/model-configuration.html)。",
+  "model.dialog.help.content.batchImport": "请填写提供商的基本信息，API Key和提供商名称为必填项，其他字段为可选项。详细配置方法请参考[模型配置](https://modelengine-group.github.io/nexent/zh/user-guide/model-configuration.html)。",
   "model.dialog.warning.incompleteForm": "请先填写完整的模型配置信息",
   "model.dialog.status.verifying": "正在验证模型连通性...",
   "model.dialog.error.addFailed": "添加模型失败：{{error}}",