智能体概述

智能体是标准化的 AI 工作流，通过组合提示词（prompts）、规则（rules）与工具（tools），完成特定且可重复的任务。

智能体是自定义的 AI 工作流，由提示词、规则和工具（如 MCP 及其他集成）组成，用于执行特定、可复用的任务。它可托管在 Agent Hub 中，通过 Web 界面方式运行，也可在IDE内容本地创建并使用。

智能体组成部分

组件	说明	示例
模型（Model）	驱动智能体推理与输出生成的大语言模型。	Qwen3
规则（Rules）	规定智能体响应时需遵循的一致性标准或行为准则，确保使用结果的可靠性。	“在总结工作时，必须包含相关的 Issue 。”
提示词（Prompt）	触发智能体核心行为的指令。调用时，用户输入会追加到该提示词之后。	示例提示词：“总结当前工作进展，包括状态、阻塞点和下一步计划。使用 Markdown 格式，语言简洁专业。”
工具 Tools/MCP	扩展外部能力（数据库、API、CLI）	GitHub、PostHog、Supabase

智能体类型

VJSP AI Studio 支持三类智能体，按管理方式区分：

官方智能体（通过引用方式使用）
Hub 自定义智能体
本地智能体

智能体结构和组件配置

所有本地智能体均通过 config.yaml 定义，位于项目根目录的 .vjsp/agents/ 文件夹中。

基础结构

yaml

# This is an example configuration file
name: Config    # 必填
version: 1.0.0  # 必填
schema: v1  # 必填

# Define which models can be used
models:   # 模型配置
  - name: 
    provider: openai
    model: 
    apiKey: YOUR_OPENAI_API_KEY_HERE

核心组件配置说明

模型（Models）

定义驱动智能体的语言模型。

yaml

models:
  - name: 
    provider: openai
    model: 
    apiKey: YOUR_OPENAI_API_KEY_HERE
    roles:
      - chat
      - edit
      - apply
    capabilities: 
      - tool_use
    requestOptions:
      headers:
        vjsp-api-key: your_api_key

roles：指定模型用途（chat/edit/autocomplete/apply）
capabilities：启用高级功能（如 tool_use 用于调用 MCP）

规则(Rules)

强制 AI 遵循编码规范。

格式如下：

yaml

---
description: A description of your rule
---

Your rule content

提示词

通过 /命令快速触发任务。

yaml

---
name: New prompt
description: New prompt
invokable: true
---

Please write a thorough suite of unit tests for this code, making sure to cover all relevant edge cases

MCP 工具（mcpServers）

连接外部系统与数据库。

yaml

name: New MCP server
version: 0.0.1
schema: v1
mcpServers:
  - name: New MCP server
    command: npx
    args:
      - -y
      - <your-mcp-server>
    env: {}

自定义本地智能体

操作步骤：

步骤 1. 在IDE中打开VJSP 插件

确保已登录并启用 VJSP AI Studio 插件。

步骤 2. 创建配置文件

在 IDE 中打开 智能体管理 面板
点击设置 → 配置 → 添加配置
系统将在项目根目录自动创建 .vjsp/config.yaml 文件

创建智能体

步骤 3. 填写基础信息

编辑 config.yaml，定义智能体元数据和模型配置。示例如下：

name: TestCaseGenerator
version: 1.0.0
schema: v1

models:
- name: Qwen3
  provider: openai
  model: Qwen3
  apiBase: https://xxx.xx.cn/v1
  capabilities:
  - tool_use    # 启用工具调用（MCP 必需）
  roles:
  - chat        # 支持聊天模式
  - edit        # 支持编辑模式
  - apply       # 支持应用生成结果
  requestOptions:
      headers:
          vjsp-api-key: b4xxxxxx

📌 字段说明

capabilities: [tool_use] 是使用 MCP 工具的前提

roles 决定该模型在哪些 IDE 模式下可用

步骤 4. 配置核心组件（关键步骤）

用户设置：插件全局设置,设置字体大小，格式化，代码块自动换行等等
配置模型：指定不同模式使用的 LLM
配置规则：强制编码规范或行为约束
配置提示词：定义 /命令触发的任务模板
工具配置：集成数据库、API、CLI 等外部能力

步骤 5. 启用智能体

保存所有配置文件
在 IDE 中点击 🔄 重新加载智能体
在聊天窗口顶部切换至新创建的本地智能体
开始使用（支持 Chat / Edit / Agent 等模式）

注意事项

🔒 作用域限制：本地智能体仅对当前项目有效，不会自动同步到 Web 端。
🔄 生效机制：修改配置后必须 手动重载 才能生效。
🧪 实验性功能：多轮工具调用、复杂工作流等高级能力可能需要在插件设置中 启用“实验性智能体功能”。
复用建议：若需在多个项目中使用，请在 Agent Hub 创建 Web 端智能体。

智能体概述 ​

智能体组成部分 ​

智能体类型 ​

智能体结构和组件配置 ​

基础结构 ​

核心组件配置说明 ​

模型（Models） ​

规则(Rules) ​

提示词 ​

MCP 工具（mcpServers） ​

自定义本地智能体 ​

步骤 1. 在IDE中打开VJSP 插件 ​

步骤 2. 创建配置文件 ​

步骤 3. 填写基础信息 ​

步骤 4. 配置核心组件（关键步骤） ​

步骤 5. 启用智能体 ​

注意事项 ​

智能体概述

智能体组成部分

智能体类型

智能体结构和组件配置

基础结构

核心组件配置说明

模型（Models）

规则(Rules)

提示词

MCP 工具（mcpServers）

自定义本地智能体

步骤 1. 在IDE中打开VJSP 插件

步骤 2. 创建配置文件

步骤 3. 填写基础信息

步骤 4. 配置核心组件（关键步骤）

步骤 5. 启用智能体

注意事项