opc-agent 4.1.0 → 4.1.2

package/templates/ecommerce-assistant/README.md

@@ -1,45 +1,45 @@
-# Ecommerce Assistant — 电商助手工位
-
-专为电商平台设计的 AI 导购与售后工位，覆盖商品推荐、订单查询、退换货处理全链路。
-
-## 快速开始
-
-```bash
-opc init --template ecommerce-assistant
-opc start
-```
-
-访问 http://localhost:3000 即可使用电商助手聊天界面。
-
-## 功能
-
-| 技能 | 说明 |
-|------|------|
-| product-search | 关键词/类目/价格区间商品搜索 |
-| order-query | 订单状态与物流实时查询 |
-| after-sale | 退换货受理与投诉处理 |
-| promotion | 个性化优惠券与促销推送 |
-| recommendation | 基于偏好的个性化商品推荐 |
-
-## 配置
-
-在 `oad.yaml` 中修改以下参数：
-
-- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
-- `spec.model` — 指定模型版本
-- `spec.systemPrompt` — 定制品牌话术、商品范围和售后规则
-
-### 环境变量
-
-```bash
-OPC_LLM_API_KEY=your_key
-OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
-OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
-```
-
-## 推荐搭配
-
-- 将商品目录、售后政策、FAQ 上传至知识库（`/api/kb/upload`）
-- 开启 `OPC_DEEPBRAIN_ENABLED=true` 提升商品语义匹配精度
-- 通过 Dashboard（`/dashboard`）监控转化率、客满率和退单率
-- 结合 CRM 系统 Webhook 实现订单状态实时同步
+# Ecommerce Assistant — 电商助手工位
+
+专为电商平台设计的 AI 导购与售后工位，覆盖商品推荐、订单查询、退换货处理全链路。
+
+## 快速开始
+
+```bash
+opc init --template ecommerce-assistant
+opc start
+```
+
+访问 http://localhost:3000 即可使用电商助手聊天界面。
+
+## 功能
+
+| 技能 | 说明 |
+|------|------|
+| product-search | 关键词/类目/价格区间商品搜索 |
+| order-query | 订单状态与物流实时查询 |
+| after-sale | 退换货受理与投诉处理 |
+| promotion | 个性化优惠券与促销推送 |
+| recommendation | 基于偏好的个性化商品推荐 |
+
+## 配置
+
+在 `oad.yaml` 中修改以下参数：
+
+- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
+- `spec.model` — 指定模型版本
+- `spec.systemPrompt` — 定制品牌话术、商品范围和售后规则
+
+### 环境变量
+
+```bash
+OPC_LLM_API_KEY=your_key
+OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
+OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
+```
+
+## 推荐搭配
+
+- 将商品目录、售后政策、FAQ 上传至知识库（`/api/kb/upload`）
+- 开启 `OPC_DEEPBRAIN_ENABLED=true` 提升商品语义匹配精度
+- 通过 Dashboard（`/dashboard`）监控转化率、客满率和退单率
+- 结合 CRM 系统 Webhook 实现订单状态实时同步

package/templates/ecommerce-assistant/oad.yaml

@@ -1,47 +1,47 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: ecommerce-assistant
-  version: 1.0.0
-  description: "电商助手工位 - 商品推荐、订单查询、售后服务一体化"
-  author: Deepleaper
-  license: Apache-2.0
-  marketplace:
-    certified: false
-    category: ecommerce
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen, gemini]
-  model: deepseek-chat
-  systemPrompt: |
-    你是一名专业的电商购物助手。
-    你帮助用户查询商品信息、比较价格、处理订单状态和售后问题。
-    根据用户需求推荐合适的商品，推送当前促销活动，并协助用户做出购买决策。
-    处理退换货申请时，需先核实订单信息，再按平台规则指引用户操作。
-    始终保持友好、热情、专业的服务态度。
-  skills:
-    - name: product-search
-      description: "搜索商品信息，支持关键词、类目、价格区间筛选"
-    - name: order-query
-      description: "查询订单状态、物流轨迹和预计送达时间"
-    - name: after-sale
-      description: "处理退换货申请、投诉受理和赔偿协商"
-    - name: promotion
-      description: "推送个性化优惠券、限时活动和会员权益"
-    - name: recommendation
-      description: "基于用户偏好和购买历史做商品推荐"
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm: true
-  knowledge:
-    enabled: true
-    deepbrain: auto
-  dtv:
-    trust:
-      level: sandbox
-    value:
-      metrics: [conversion_rate, customer_satisfaction, avg_order_value, refund_rate]
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: ecommerce-assistant
+  version: 1.0.0
+  description: "电商助手工位 - 商品推荐、订单查询、售后服务一体化"
+  author: Deepleaper
+  license: Apache-2.0
+  marketplace:
+    certified: false
+    category: ecommerce
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen, gemini]
+  model: deepseek-chat
+  systemPrompt: |
+    你是一名专业的电商购物助手。
+    你帮助用户查询商品信息、比较价格、处理订单状态和售后问题。
+    根据用户需求推荐合适的商品，推送当前促销活动，并协助用户做出购买决策。
+    处理退换货申请时，需先核实订单信息，再按平台规则指引用户操作。
+    始终保持友好、热情、专业的服务态度。
+  skills:
+    - name: product-search
+      description: "搜索商品信息，支持关键词、类目、价格区间筛选"
+    - name: order-query
+      description: "查询订单状态、物流轨迹和预计送达时间"
+    - name: after-sale
+      description: "处理退换货申请、投诉受理和赔偿协商"
+    - name: promotion
+      description: "推送个性化优惠券、限时活动和会员权益"
+    - name: recommendation
+      description: "基于用户偏好和购买历史做商品推荐"
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm: true
+  knowledge:
+    enabled: true
+    deepbrain: auto
+  dtv:
+    trust:
+      level: sandbox
+    value:
+      metrics: [conversion_rate, customer_satisfaction, avg_order_value, refund_rate]

package/templates/tech-support/README.md

@@ -1,43 +1,43 @@
-# Tech Support Agent — 技术支持工位
-
-专为 IT 支持团队设计的 AI 工位，覆盖软件故障、系统配置、网络问题等场景。
-
-## 快速开始
-
-```bash
-opc init --template tech-support
-opc start
-```
-
-访问 http://localhost:3000 即可使用技术支持聊天界面。
-
-## 功能
-
-| 技能 | 说明 |
-|------|------|
-| troubleshoot | 分步骤诊断和解决技术问题 |
-| knowledge-lookup | 查询技术文档与历史解决方案 |
-| ticket-create | 创建并跟踪技术支持工单 |
-| escalate | 升级复杂问题至专项团队 |
-
-## 配置
-
-在 `oad.yaml` 中修改以下参数：
-
-- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
-- `spec.model` — 指定模型版本
-- `spec.systemPrompt` — 定制支持范围和话术风格
-
-### 环境变量
-
-```bash
-OPC_LLM_API_KEY=your_key
-OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
-OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
-```
-
-## 推荐搭配
-
-- 将内部技术文档、SOP、FAQ 上传至知识库（`/api/kb/upload`）
-- 开启 `OPC_DEEPBRAIN_ENABLED=true` 获得更精准的语义检索
-- 通过 Dashboard（`/dashboard`）监控首次解决率和平均响应时间
+# Tech Support Agent — 技术支持工位
+
+专为 IT 支持团队设计的 AI 工位，覆盖软件故障、系统配置、网络问题等场景。
+
+## 快速开始
+
+```bash
+opc init --template tech-support
+opc start
+```
+
+访问 http://localhost:3000 即可使用技术支持聊天界面。
+
+## 功能
+
+| 技能 | 说明 |
+|------|------|
+| troubleshoot | 分步骤诊断和解决技术问题 |
+| knowledge-lookup | 查询技术文档与历史解决方案 |
+| ticket-create | 创建并跟踪技术支持工单 |
+| escalate | 升级复杂问题至专项团队 |
+
+## 配置
+
+在 `oad.yaml` 中修改以下参数：
+
+- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
+- `spec.model` — 指定模型版本
+- `spec.systemPrompt` — 定制支持范围和话术风格
+
+### 环境变量
+
+```bash
+OPC_LLM_API_KEY=your_key
+OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
+OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
+```
+
+## 推荐搭配
+
+- 将内部技术文档、SOP、FAQ 上传至知识库（`/api/kb/upload`）
+- 开启 `OPC_DEEPBRAIN_ENABLED=true` 获得更精准的语义检索
+- 通过 Dashboard（`/dashboard`）监控首次解决率和平均响应时间

package/templates/tech-support/oad.yaml

@@ -1,45 +1,45 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: tech-support
-  version: 1.0.0
-  description: "技术支持工位 - 处理用户技术问题、故障排查和解决方案推荐"
-  author: Deepleaper
-  license: Apache-2.0
-  marketplace:
-    certified: false
-    category: it-support
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen, gemini]
-  model: deepseek-chat
-  systemPrompt: |
-    你是一名专业的技术支持工程师。
-    你帮助用户解决技术问题，包括软件故障、系统配置、网络问题、硬件故障等。
-    回答时请保持专业、耐心，并提供清晰的步骤指引。
-    优先使用知识库中的已知解决方案。
-    如果问题无法远程解决，请指导用户联系线下支持或提交工单。
-  skills:
-    - name: troubleshoot
-      description: "诊断和解决技术问题，提供分步骤操作指南"
-    - name: knowledge-lookup
-      description: "查询技术文档、FAQ 和历史解决方案库"
-    - name: ticket-create
-      description: "为复杂问题创建技术支持工单并跟踪进展"
-    - name: escalate
-      description: "将高优先级问题升级到高级工程师或专项团队"
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm: true
-  knowledge:
-    enabled: true
-    deepbrain: auto
-  dtv:
-    trust:
-      level: internal
-    value:
-      metrics: [resolution_time, first_contact_resolution, customer_satisfaction]
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: tech-support
+  version: 1.0.0
+  description: "技术支持工位 - 处理用户技术问题、故障排查和解决方案推荐"
+  author: Deepleaper
+  license: Apache-2.0
+  marketplace:
+    certified: false
+    category: it-support
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen, gemini]
+  model: deepseek-chat
+  systemPrompt: |
+    你是一名专业的技术支持工程师。
+    你帮助用户解决技术问题，包括软件故障、系统配置、网络问题、硬件故障等。
+    回答时请保持专业、耐心，并提供清晰的步骤指引。
+    优先使用知识库中的已知解决方案。
+    如果问题无法远程解决，请指导用户联系线下支持或提交工单。
+  skills:
+    - name: troubleshoot
+      description: "诊断和解决技术问题，提供分步骤操作指南"
+    - name: knowledge-lookup
+      description: "查询技术文档、FAQ 和历史解决方案库"
+    - name: ticket-create
+      description: "为复杂问题创建技术支持工单并跟踪进展"
+    - name: escalate
+      description: "将高优先级问题升级到高级工程师或专项团队"
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm: true
+  knowledge:
+    enabled: true
+    deepbrain: auto
+  dtv:
+    trust:
+      level: internal
+    value:
+      metrics: [resolution_time, first_contact_resolution, customer_satisfaction]

package/test-agent/Dockerfile

@@ -1,9 +1,9 @@
-FROM node:22-alpine
-WORKDIR /app
-COPY package.json package-lock.json* ./
-RUN npm ci --production 2>/dev/null || npm install --production
-COPY oad.yaml agent.yaml .env* ./
-COPY src/ ./src/
-COPY prompts/ ./prompts/ 2>/dev/null || true
-EXPOSE 3000
-CMD ["npx", "opc", "run"]
+FROM node:22-alpine
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm ci --production 2>/dev/null || npm install --production
+COPY oad.yaml agent.yaml .env* ./
+COPY src/ ./src/
+COPY prompts/ ./prompts/ 2>/dev/null || true
+EXPOSE 3000
+CMD ["npx", "opc", "run"]

package/test-agent/README.md

@@ -1,50 +1,50 @@
-# test-agent
-
-Created with [OPC Agent](https://github.com/Deepleaper/opc-agent) using the `customer-service` template.
-
-## Quick Start
-
-1. **Install dependencies:**
-   ```bash
-   npm install
-   ```
-
-2. **Run with Ollama (default):**
-   ```bash
-   # Make sure Ollama is running with qwen2.5 model
-   ollama pull qwen2.5
-   npx tsx src/index.ts
-   ```
-
-3. **Or use OpenAI/other providers:**
-   ```bash
-   # Edit .env and set your API key
-   npx opc run
-   ```
-
-4. **Open browser:** [http://localhost:3000](http://localhost:3000)
-
-## Development
-
-```bash
-npx opc dev    # Hot-reload mode
-npx opc chat   # CLI chat
-```
-
-## Project Structure
-
-```
-test-agent/
-├── agent.yaml          # OAD agent config (used by src/index.ts)
-├── oad.yaml            # OAD config (used by opc CLI)
-├── src/
-│   ├── index.ts        # Entry point
-│   └── skills/
-│       └── echo.ts     # Example skill
-├── package.json
-└── tsconfig.json
-```
-
-## Configuration
-
-Edit `agent.yaml` to customize your agent's personality, skills, and behavior.
+# test-agent
+
+Created with [OPC Agent](https://github.com/Deepleaper/opc-agent) using the `customer-service` template.
+
+## Quick Start
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Run with Ollama (default):**
+   ```bash
+   # Make sure Ollama is running with qwen2.5 model
+   ollama pull qwen2.5
+   npx tsx src/index.ts
+   ```
+
+3. **Or use OpenAI/other providers:**
+   ```bash
+   # Edit .env and set your API key
+   npx opc run
+   ```
+
+4. **Open browser:** [http://localhost:3000](http://localhost:3000)
+
+## Development
+
+```bash
+npx opc dev    # Hot-reload mode
+npx opc chat   # CLI chat
+```
+
+## Project Structure
+
+```
+test-agent/
+├── agent.yaml          # OAD agent config (used by src/index.ts)
+├── oad.yaml            # OAD config (used by opc CLI)
+├── src/
+│   ├── index.ts        # Entry point
+│   └── skills/
+│       └── echo.ts     # Example skill
+├── package.json
+└── tsconfig.json
+```
+
+## Configuration
+
+Edit `agent.yaml` to customize your agent's personality, skills, and behavior.

package/test-agent/agent.yaml

@@ -1,23 +1,23 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: test-agent
-  version: 1.0.0
-  description: My AI Agent
-spec:
-  model: qwen2.5
-  provider:
-    default: ollama
-  systemPrompt: |
-    You are a helpful AI assistant named test-agent.
-    Be concise, helpful, and friendly.
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm:
-      provider: deepbrain
-  skills:
-    - name: echo
-      description: Echo test skill
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: test-agent
+  version: 1.0.0
+  description: My AI Agent
+spec:
+  model: qwen2.5
+  provider:
+    default: ollama
+  systemPrompt: |
+    You are a helpful AI assistant named test-agent.
+    Be concise, helpful, and friendly.
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm:
+      provider: deepbrain
+  skills:
+    - name: echo
+      description: Echo test skill

package/test-agent/docker-compose.yml

@@ -1,11 +1,11 @@
-version: '3.8'
-services:
-  agent:
-    build: .
-    ports:
-      - "3000:3000"
-    env_file:
-      - .env
-    volumes:
-      - ./agent.yaml:/app/agent.yaml:ro
-    restart: unless-stopped
+version: '3.8'
+services:
+  agent:
+    build: .
+    ports:
+      - "3000:3000"
+    env_file:
+      - .env
+    volumes:
+      - ./agent.yaml:/app/agent.yaml:ro
+    restart: unless-stopped

package/test-agent/oad.yaml

@@ -1,31 +1,31 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: test-agent
-  version: 1.0.0
-  description: Customer service agent with FAQ and human handoff
-  author: OPC Agent
-  license: Apache-2.0
-spec:
-  provider:
-    default: deepseek
-    allowed:
-      - openai
-      - deepseek
-      - qwen
-  model: deepseek-chat
-  systemPrompt: |-
-    You are a friendly and professional customer service agent. 
-    You help customers with their questions about products, orders, shipping, and returns.
-    Be concise, helpful, and empathetic. If you're unsure, offer to connect them with a human agent.
-  skills:
-    - name: faq-lookup
-      description: Look up FAQ answers
-    - name: human-handoff
-      description: Hand off to human agent
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm: false
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: test-agent
+  version: 1.0.0
+  description: Customer service agent with FAQ and human handoff
+  author: OPC Agent
+  license: Apache-2.0
+spec:
+  provider:
+    default: deepseek
+    allowed:
+      - openai
+      - deepseek
+      - qwen
+  model: deepseek-chat
+  systemPrompt: |-
+    You are a friendly and professional customer service agent. 
+    You help customers with their questions about products, orders, shipping, and returns.
+    Be concise, helpful, and empathetic. If you're unsure, offer to connect them with a human agent.
+  skills:
+    - name: faq-lookup
+      description: Look up FAQ answers
+    - name: human-handoff
+      description: Hand off to human agent
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm: false