Cxbrainskill (Virenderverma Spec)

CS智能平台

Meow Mobile的人工智能客户服务副驾驶，将Claude与Zendesk集成在一起。

建筑

┌─────────────────────────────────────────────────────────────────┐
│                      ZENDESK AGENT WORKSPACE                     │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    Ticket View                            │   │
│  │  ┌────────────────────────────────────────────────────┐  │   │
│  │  │              CS Copilot Sidebar                     │  │   │
│  │  │  • Auto-loads customer profile                     │  │   │
│  │  │  • Quick actions (Diagnose, Draft, Escalate)       │  │   │
│  │  │  • AI chat for agent questions                     │  │   │
│  │  └────────────────────────────────────────────────────┘  │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      EXPRESS SERVER                              │
│  POST /api/chat                                                  │
│  • Loads skills from .claude/skills/*.md                        │
│  • Injects into Claude system prompt                            │
│  • Connects to Boss API, Databricks, Zendesk                    │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      CLAUDE API                                  │
│  • Skills provide troubleshooting flows                         │
│  • Tools enable real-time data lookups                          │
│  • Returns diagnosis + recommended actions                       │
└─────────────────────────────────────────────────────────────────┘

项目结构

Cxbrainskill/
├── .claude/
│   └── skills/                    # CS Knowledge Base
│       ├── cs-agent-guide.md      # Master routing skill
│       ├── esim-troubleshooting.md
│       ├── portin-troubleshooting.md
│       ├── payment-issues.md
│       ├── network-connectivity.md
│       ├── account-management.md
│       ├── escalation-guide.md
│       ├── airvet-support.md
│       ├── mochi-handoff.md
│       ├── email-handling.md
│       └── cxbrain.md
│
├── server/                        # Backend Server
│   ├── server.js                  # Express app
│   ├── package.json
│   ├── .env.example
│   ├── lib/
│   │   └── skill-loader.js        # Loads skills into prompt
│   └── routes/
│       └── chat.js                # AI chat endpoint
│
├── zendesk-app/                   # Zendesk Sidebar App
│   ├── manifest.json              # ZAF configuration
│   └── assets/
│       ├── iframe.html            # Sidebar UI
│       └── main.js                # Frontend logic
│
└── README.md

设置

1.安装服务器依赖关系

cd server
npm install

2.配置环境

cp .env.example .env
# Edit .env with your API keys:
# - ANTHROPIC_API_KEY
# - BOSS_API_URL / BOSS_API_TOKEN
# - ZENDESK credentials
# - DATABRICKS credentials

3.启动服务器

npm start
# Or for development with auto-reload:
npm run dev

4.测试技能加载

npm run test-skills
# Should output list of loaded skills

5.部署Zendesk应用程序

cd zendesk-app

# Install ZCLI (Zendesk CLI) if not installed
npm install -g @zendesk/zcli

# Validate the app
zcli apps:validate

# Deploy to Zendesk
zcli apps:create

运作原理

技能

技能是教导Claude如何处理特定问题类型的标记文件：

• 触发器：激活技能的短语
• 诊断流程：逐步排除故障
• 决策树：如果是X，就做Y
• 响应模板：预先写好的客户信息
• 升级标准：何时交接

示例流程

1. 客服为有eSIM问题的客户打开工单
2. 侧栏通过Boss API自动加载客户档案
3. 客服点击“诊断”或提问
4. 服务器将所有技能加载到Claude的上下文中
5. 克劳德紧随其后 esim-troubleshooting 技能：

- 检查订单状态 - 检查eSIM配置状态 - 确定根本原因

1. 返回诊断+建议行动+草稿响应
2. 代理发送响应或采取建议的操作

支持的频道

技能根据渠道自动调整响应风格：

API终点

POST/api/聊天

向AI助手发送消息。

{
  "message": "Customer can't activate eSIM, what should I do?",
  "ticketId": "12345",
  "customerEmail": "customer@example.com",
  "channel": "email",
  "subject": "Can't activate eSIM",
  "conversationHistory": []
}

答复：

{
  "response": "## Diagnosis for Jane Doe\n\n**Issue:** eSIM not installed...",
  "conversationHistory": [...]
}

GET/api/技能

列出可用技能。

POST/api/聊天/重新加载技能

从磁盘强制重新加载技能。

添加新技能

1. 创建新 .md 文件在 .claude/skills/
2. 遵循技能模板：

# Skill Name

Brief description.

## Triggers
- "phrase that activates this"

## Diagnostic Flow
### Step 1: ...
### Step 2: ...

## Response Templates
...

## Escalation Criteria
...

1. 重新启动服务器或调用 /api/chat/reload-skills

连接API

这 chat.js 文件具有API调用的占位符函数。替换为实际实现：

async function callBossAPI(endpoint, method, body) {
  const response = await fetch(`${process.env.BOSS_API_URL}${endpoint}`, {
    method,
    headers: {
      'Authorization': `Bearer ${process.env.BOSS_API_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: body ? JSON.stringify(body) : null
  });
  return response.json();
}

环境变量