opc-agent 1.1.3 → 1.2.1

package/templates/knowledge-base/README.md

@@ -1,28 +1,28 @@
-# Knowledge Base Template
-
-RAG-powered knowledge base agent that answers questions from your company docs.
-
-## Features
-- **Semantic Search**: Uses DeepBrain for intelligent document retrieval
-- **Document Ingestion**: Add docs to build your knowledge base
-- **Source Citations**: Cites sources in answers
-
-## Quick Start
-```bash
-opc init my-kb --template knowledge-base
-cd my-kb
-# Optional: install deepbrain for full RAG support
-npm install deepbrain
-opc run
-```
-
-## How It Works
-1. Ingest company documents into DeepBrain
-2. User asks a question
-3. Agent searches for relevant document chunks
-4. LLM generates answer based on retrieved context
-
-## Configuration
-- `memory.longTerm.provider: deepbrain` — enables semantic memory
-- `memory.longTerm.collection` — DeepBrain collection name
-- Falls back to in-memory if deepbrain is not installed
+# Knowledge Base Template
+
+RAG-powered knowledge base agent that answers questions from your company docs.
+
+## Features
+- **Semantic Search**: Uses DeepBrain for intelligent document retrieval
+- **Document Ingestion**: Add docs to build your knowledge base
+- **Source Citations**: Cites sources in answers
+
+## Quick Start
+```bash
+opc init my-kb --template knowledge-base
+cd my-kb
+# Optional: install deepbrain for full RAG support
+npm install deepbrain
+opc run
+```
+
+## How It Works
+1. Ingest company documents into DeepBrain
+2. User asks a question
+3. Agent searches for relevant document chunks
+4. LLM generates answer based on retrieved context
+
+## Configuration
+- `memory.longTerm.provider: deepbrain` — enables semantic memory
+- `memory.longTerm.collection` — DeepBrain collection name
+- Falls back to in-memory if deepbrain is not installed

package/templates/knowledge-base/oad.yaml

@@ -1,38 +1,38 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: knowledge-base
-  version: 1.0.0
-  description: "RAG-powered knowledge base agent using DeepBrain for semantic search"
-  author: Deepleaper
-  license: Apache-2.0
-  marketplace:
-    certified: false
-    category: knowledge
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen]
-  model: deepseek-chat
-  systemPrompt: |
-    You are a knowledge base assistant. Answer questions using the company documents
-    and knowledge provided to you. If you don't have enough information, say so honestly.
-    Always cite sources when possible. Be accurate and concise.
-  skills:
-    - name: doc-search
-      description: "Search company documents using semantic search"
-    - name: doc-ingest
-      description: "Ingest new documents into the knowledge base"
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm:
-      provider: deepbrain
-      collection: company-knowledge
-  dtv:
-    trust:
-      level: sandbox
-    value:
-      metrics: [queries_answered, accuracy_score, docs_indexed]
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: knowledge-base
+  version: 1.0.0
+  description: "RAG-powered knowledge base agent using DeepBrain for semantic search"
+  author: Deepleaper
+  license: Apache-2.0
+  marketplace:
+    certified: false
+    category: knowledge
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen]
+  model: deepseek-chat
+  systemPrompt: |
+    You are a knowledge base assistant. Answer questions using the company documents
+    and knowledge provided to you. If you don't have enough information, say so honestly.
+    Always cite sources when possible. Be accurate and concise.
+  skills:
+    - name: doc-search
+      description: "Search company documents using semantic search"
+    - name: doc-ingest
+      description: "Ingest new documents into the knowledge base"
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm:
+      provider: deepbrain
+      collection: company-knowledge
+  dtv:
+    trust:
+      level: sandbox
+    value:
+      metrics: [queries_answered, accuracy_score, docs_indexed]

package/templates/sales-assistant/README.md

@@ -1,26 +1,26 @@
-# Sales Assistant Template
-
-AI-powered sales assistant for product Q&A, lead capture, and appointment booking.
-
-## Features
-- **Product Q&A**: Answers questions about your products/services
-- **Lead Capture**: Collects prospect information (name, email, company)
-- **Appointment Booking**: Schedules demos and meetings
-
-## Quick Start
-```bash
-opc init my-sales-bot --template sales-assistant
-cd my-sales-bot
-opc run
-```
-
-## Configuration
-Edit `oad.yaml` to customize:
-- System prompt with your product details
-- Add your product FAQ data
-- Configure appointment scheduling rules
-
-## Value Metrics
-- `leads_captured` — Number of leads collected
-- `appointments_booked` — Demos/meetings scheduled
-- `conversion_rate` — Lead to appointment ratio
+# Sales Assistant Template
+
+AI-powered sales assistant for product Q&A, lead capture, and appointment booking.
+
+## Features
+- **Product Q&A**: Answers questions about your products/services
+- **Lead Capture**: Collects prospect information (name, email, company)
+- **Appointment Booking**: Schedules demos and meetings
+
+## Quick Start
+```bash
+opc init my-sales-bot --template sales-assistant
+cd my-sales-bot
+opc run
+```
+
+## Configuration
+Edit `oad.yaml` to customize:
+- System prompt with your product details
+- Add your product FAQ data
+- Configure appointment scheduling rules
+
+## Value Metrics
+- `leads_captured` — Number of leads collected
+- `appointments_booked` — Demos/meetings scheduled
+- `conversion_rate` — Lead to appointment ratio

package/templates/sales-assistant/oad.yaml

@@ -1,43 +1,43 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: sales-assistant
-  version: 1.0.0
-  description: "AI sales assistant with product Q&A, lead capture, and appointment booking"
-  author: Deepleaper
-  license: Apache-2.0
-  marketplace:
-    certified: false
-    category: sales
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen]
-  model: deepseek-chat
-  systemPrompt: |
-    You are a professional sales assistant. Your goals:
-    1. Answer product questions accurately and enthusiastically
-    2. Capture leads by collecting name, email, and company info
-    3. Book appointments when prospects are ready
-    Be friendly, persuasive but not pushy. Always provide value first.
-  skills:
-    - name: product-qa
-      description: "Answer product-related questions"
-    - name: lead-capture
-      description: "Capture prospect information"
-    - name: appointment-booking
-      description: "Schedule meetings and demos"
-  channels:
-    - type: web
-      port: 3000
-    - type: websocket
-      port: 3002
-  memory:
-    shortTerm: true
-    longTerm:
-      provider: in-memory
-  dtv:
-    trust:
-      level: sandbox
-    value:
-      metrics: [leads_captured, appointments_booked, conversion_rate]
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: sales-assistant
+  version: 1.0.0
+  description: "AI sales assistant with product Q&A, lead capture, and appointment booking"
+  author: Deepleaper
+  license: Apache-2.0
+  marketplace:
+    certified: false
+    category: sales
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen]
+  model: deepseek-chat
+  systemPrompt: |
+    You are a professional sales assistant. Your goals:
+    1. Answer product questions accurately and enthusiastically
+    2. Capture leads by collecting name, email, and company info
+    3. Book appointments when prospects are ready
+    Be friendly, persuasive but not pushy. Always provide value first.
+  skills:
+    - name: product-qa
+      description: "Answer product-related questions"
+    - name: lead-capture
+      description: "Capture prospect information"
+    - name: appointment-booking
+      description: "Schedule meetings and demos"
+  channels:
+    - type: web
+      port: 3000
+    - type: websocket
+      port: 3002
+  memory:
+    shortTerm: true
+    longTerm:
+      provider: in-memory
+  dtv:
+    trust:
+      level: sandbox
+    value:
+      metrics: [leads_captured, appointments_booked, conversion_rate]

package/templates/tech-support/README.md

@@ -0,0 +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`）监控首次解决率和平均响应时间

package/templates/tech-support/oad.yaml

@@ -0,0 +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]

package/tests/a2a.test.ts

@@ -1,66 +1,66 @@
-import { describe, it, expect, beforeEach } from 'vitest';
-import { AgentRegistry } from '../src/core/a2a';
-import { BaseAgent } from '../src/core/agent';
-import { InMemoryStore } from '../src/memory';
-
-function createTestAgent(name: string): BaseAgent {
-  const agent = new BaseAgent({ name, model: 'test', systemPrompt: `I am ${name}` }, new InMemoryStore());
-  return agent;
-}
-
-describe('AgentRegistry (A2A)', () => {
-  let registry: AgentRegistry;
-
-  beforeEach(() => {
-    registry = new AgentRegistry();
-  });
-
-  it('should register and discover agents', () => {
-    const agent = createTestAgent('agent-1');
-    registry.register(agent, [{ name: 'summarize', description: 'Summarize text' }]);
-    
-    const all = registry.discover();
-    expect(all).toHaveLength(1);
-    expect(all[0].agentName).toBe('agent-1');
-  });
-
-  it('should discover by capability', () => {
-    const a1 = createTestAgent('a1');
-    const a2 = createTestAgent('a2');
-    registry.register(a1, [{ name: 'summarize', description: 'Summarize' }]);
-    registry.register(a2, [{ name: 'translate', description: 'Translate' }]);
-
-    const found = registry.discover('translate');
-    expect(found).toHaveLength(1);
-    expect(found[0].agentName).toBe('a2');
-  });
-
-  it('should unregister agents', () => {
-    const agent = createTestAgent('temp');
-    registry.register(agent, []);
-    registry.unregister('temp');
-    expect(registry.discover()).toHaveLength(0);
-  });
-
-  it('should handle request to unknown agent', async () => {
-    const response = await registry.call('a1', 'unknown', 'test', 'hello');
-    expect(response.status).toBe('error');
-  });
-
-  it('should send A2A request and get response', async () => {
-    const agent = createTestAgent('responder');
-    await agent.init();
-    registry.register(agent, [{ name: 'chat', description: 'Chat' }]);
-
-    const response = await registry.call('caller', 'responder', 'chat', 'hello');
-    expect(response.status).toBe('success');
-    expect(response.payload).toBeDefined();
-  });
-
-  it('should get agent by name', () => {
-    const agent = createTestAgent('finder');
-    registry.register(agent, []);
-    expect(registry.getAgent('finder')).toBeDefined();
-    expect(registry.getAgent('none')).toBeUndefined();
-  });
-});
+import { describe, it, expect, beforeEach } from 'vitest';
+import { AgentRegistry } from '../src/core/a2a';
+import { BaseAgent } from '../src/core/agent';
+import { InMemoryStore } from '../src/memory';
+
+function createTestAgent(name: string): BaseAgent {
+  const agent = new BaseAgent({ name, model: 'test', systemPrompt: `I am ${name}` }, new InMemoryStore());
+  return agent;
+}
+
+describe('AgentRegistry (A2A)', () => {
+  let registry: AgentRegistry;
+
+  beforeEach(() => {
+    registry = new AgentRegistry();
+  });
+
+  it('should register and discover agents', () => {
+    const agent = createTestAgent('agent-1');
+    registry.register(agent, [{ name: 'summarize', description: 'Summarize text' }]);
+    
+    const all = registry.discover();
+    expect(all).toHaveLength(1);
+    expect(all[0].agentName).toBe('agent-1');
+  });
+
+  it('should discover by capability', () => {
+    const a1 = createTestAgent('a1');
+    const a2 = createTestAgent('a2');
+    registry.register(a1, [{ name: 'summarize', description: 'Summarize' }]);
+    registry.register(a2, [{ name: 'translate', description: 'Translate' }]);
+
+    const found = registry.discover('translate');
+    expect(found).toHaveLength(1);
+    expect(found[0].agentName).toBe('a2');
+  });
+
+  it('should unregister agents', () => {
+    const agent = createTestAgent('temp');
+    registry.register(agent, []);
+    registry.unregister('temp');
+    expect(registry.discover()).toHaveLength(0);
+  });
+
+  it('should handle request to unknown agent', async () => {
+    const response = await registry.call('a1', 'unknown', 'test', 'hello');
+    expect(response.status).toBe('error');
+  });
+
+  it('should send A2A request and get response', async () => {
+    const agent = createTestAgent('responder');
+    await agent.init();
+    registry.register(agent, [{ name: 'chat', description: 'Chat' }]);
+
+    const response = await registry.call('caller', 'responder', 'chat', 'hello');
+    expect(response.status).toBe('success');
+    expect(response.payload).toBeDefined();
+  });
+
+  it('should get agent by name', () => {
+    const agent = createTestAgent('finder');
+    registry.register(agent, []);
+    expect(registry.getAgent('finder')).toBeDefined();
+    expect(registry.getAgent('none')).toBeUndefined();
+  });
+});

package/tests/agent.test.ts

@@ -1,72 +1,72 @@
-import { describe, it, expect } from 'vitest';
-import { BaseAgent } from '../src/core/agent';
-
-describe('BaseAgent', () => {
-  it('should start in init state', () => {
-    const agent = new BaseAgent({ name: 'test' });
-    expect(agent.state).toBe('init');
-    expect(agent.name).toBe('test');
-  });
-
-  it('should transition through lifecycle', async () => {
-    const agent = new BaseAgent({ name: 'test' });
-    const states: string[] = [];
-    agent.on('state:change', (_from, to) => states.push(to));
-
-    await agent.init();
-    expect(agent.state).toBe('ready');
-
-    await agent.start();
-    expect(agent.state).toBe('running');
-
-    await agent.stop();
-    expect(agent.state).toBe('stopped');
-
-    expect(states).toEqual(['ready', 'running', 'stopped']);
-  });
-
-  it('should not start if not ready', async () => {
-    const agent = new BaseAgent({ name: 'test' });
-    await expect(agent.start()).rejects.toThrow('Cannot start agent in state: init');
-  });
-
-  it('should handle messages with stub provider', async () => {
-    const agent = new BaseAgent({ name: 'test', systemPrompt: 'Be helpful' });
-    await agent.init();
-
-    const response = await agent.handleMessage({
-      id: 'msg_1',
-      role: 'user',
-      content: 'Hello',
-      timestamp: Date.now(),
-    });
-
-    expect(response.role).toBe('assistant');
-    expect(response.content).toContain('Hello');
-  });
-
-  it('should use skills before LLM fallback', async () => {
-    const agent = new BaseAgent({ name: 'test' });
-    await agent.init();
-
-    agent.registerSkill({
-      name: 'greeter',
-      description: 'Greets users',
-      execute: async (_ctx, msg) => {
-        if (msg.content.toLowerCase().includes('hello')) {
-          return { handled: true, response: 'Hi there!', confidence: 1.0 };
-        }
-        return { handled: false, confidence: 0 };
-      },
-    });
-
-    const response = await agent.handleMessage({
-      id: 'msg_1',
-      role: 'user',
-      content: 'Hello!',
-      timestamp: Date.now(),
-    });
-
-    expect(response.content).toBe('Hi there!');
-  });
-});
+import { describe, it, expect } from 'vitest';
+import { BaseAgent } from '../src/core/agent';
+
+describe('BaseAgent', () => {
+  it('should start in init state', () => {
+    const agent = new BaseAgent({ name: 'test' });
+    expect(agent.state).toBe('init');
+    expect(agent.name).toBe('test');
+  });
+
+  it('should transition through lifecycle', async () => {
+    const agent = new BaseAgent({ name: 'test' });
+    const states: string[] = [];
+    agent.on('state:change', (_from, to) => states.push(to));
+
+    await agent.init();
+    expect(agent.state).toBe('ready');
+
+    await agent.start();
+    expect(agent.state).toBe('running');
+
+    await agent.stop();
+    expect(agent.state).toBe('stopped');
+
+    expect(states).toEqual(['ready', 'running', 'stopped']);
+  });
+
+  it('should not start if not ready', async () => {
+    const agent = new BaseAgent({ name: 'test' });
+    await expect(agent.start()).rejects.toThrow('Cannot start agent in state: init');
+  });
+
+  it('should handle messages with stub provider', async () => {
+    const agent = new BaseAgent({ name: 'test', systemPrompt: 'Be helpful' });
+    await agent.init();
+
+    const response = await agent.handleMessage({
+      id: 'msg_1',
+      role: 'user',
+      content: 'Hello',
+      timestamp: Date.now(),
+    });
+
+    expect(response.role).toBe('assistant');
+    expect(response.content).toContain('Hello');
+  });
+
+  it('should use skills before LLM fallback', async () => {
+    const agent = new BaseAgent({ name: 'test' });
+    await agent.init();
+
+    agent.registerSkill({
+      name: 'greeter',
+      description: 'Greets users',
+      execute: async (_ctx, msg) => {
+        if (msg.content.toLowerCase().includes('hello')) {
+          return { handled: true, response: 'Hi there!', confidence: 1.0 };
+        }
+        return { handled: false, confidence: 0 };
+      },
+    });
+
+    const response = await agent.handleMessage({
+      id: 'msg_1',
+      role: 'user',
+      content: 'Hello!',
+      timestamp: Date.now(),
+    });
+
+    expect(response.content).toBe('Hi there!');
+  });
+});