feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。
This commit is contained in:
@ -1,105 +1,93 @@
|
||||
# DACP PromptX Service
|
||||
# DACP 协议演示服务
|
||||
|
||||
统一的 DACP 服务,提供多个 demo actions 供 PromptX 调用。
|
||||
## 概述
|
||||
|
||||
## 功能特性
|
||||
这是一个轻量级的DACP (Deepractice Agent Context Protocol) 协议演示服务,通过calculator和email两个典型场景验证DACP协议的完整性和可行性。
|
||||
|
||||
- 📧 **Email Action**: 智能邮件发送功能
|
||||
- 📅 **Calendar Action**: 会议日程管理
|
||||
- 📄 **Document Action**: 文档创建和管理
|
||||
- 🚀 **更多 Actions**: 持续扩展中...
|
||||
⚠️ **重要说明**:这是协议演示服务,不是生产级业务服务。真实的DACP服务应该独立部署。
|
||||
|
||||
## 启动方式
|
||||
## 设计目标
|
||||
|
||||
### 1. 独立启动 DACP 服务
|
||||
- **协议验证**:验证DACP协议标准的可行性
|
||||
- **演示参考**:为第三方DACP服务开发提供实现参考
|
||||
- **最小复杂度**:聚焦协议本质,避免业务逻辑干扰
|
||||
|
||||
## 演示功能
|
||||
|
||||
### 1. Calculator (`calculate`)
|
||||
- 中文自然语言数学表达式解析
|
||||
- 智能运算符转换:`加/乘/减/除` → `+/*/-/÷`
|
||||
- 标准数学运算和结果格式化
|
||||
|
||||
### 2. Email (`send_email`)
|
||||
- 自然语言邮件需求理解
|
||||
- 上下文感知内容生成
|
||||
- 专业邮件格式化
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 通过PromptX MCP启动(推荐)
|
||||
```bash
|
||||
./scripts/start-mcp.sh --with-dacp
|
||||
```
|
||||
|
||||
### 独立启动
|
||||
```bash
|
||||
cd src/dacp/dacp-promptx-service
|
||||
npm start
|
||||
npm install
|
||||
node server.js
|
||||
```
|
||||
|
||||
服务将在 http://localhost:3002 启动。
|
||||
服务地址:`http://localhost:3002`
|
||||
|
||||
### 2. 通过 MCP 自动启动(推荐)
|
||||
## 基础测试
|
||||
|
||||
```bash
|
||||
# 在项目根目录
|
||||
promptx mcp-server --with-dacp
|
||||
# 健康检查
|
||||
curl http://localhost:3002/health
|
||||
|
||||
# 计算器演示
|
||||
curl -X POST http://localhost:3002/dacp \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"service_id": "dacp-promptx-service",
|
||||
"action": "calculate",
|
||||
"parameters": {"user_request": "计算 25 + 37 * 3"}
|
||||
}'
|
||||
|
||||
# 邮件演示
|
||||
curl -X POST http://localhost:3002/dacp \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"service_id": "dacp-promptx-service",
|
||||
"action": "send_email",
|
||||
"parameters": {"user_request": "发送测试邮件"}
|
||||
}'
|
||||
```
|
||||
|
||||
这将同时启动 MCP Server 和 DACP 服务。
|
||||
## 架构原则
|
||||
|
||||
## API 接口
|
||||
基于Sean的产品哲学:
|
||||
|
||||
### DACP 协议接口
|
||||
### 奥卡姆剃刀原则
|
||||
- 最小复杂度验证最大价值
|
||||
- 两个典型场景覆盖协议核心能力
|
||||
|
||||
POST http://localhost:3002/dacp
|
||||
### 架构分离
|
||||
- 演示服务与生产服务分离
|
||||
- 避免在MCP客户端承担过多业务逻辑
|
||||
|
||||
请求格式:
|
||||
```json
|
||||
{
|
||||
"service_id": "dacp-promptx-service",
|
||||
"action": "send_email",
|
||||
"parameters": {
|
||||
"user_request": "给张三发个会议提醒邮件",
|
||||
"context": {
|
||||
"urgency": "high"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
### 扩展指导
|
||||
- 真实DACP服务应独立部署
|
||||
- 此演示提供标准协议实现参考
|
||||
|
||||
## 支持的 Actions
|
||||
## 文档
|
||||
|
||||
1. **send_email** - 发送邮件
|
||||
- 自然语言邮件内容解析
|
||||
- 智能主题识别
|
||||
- 专业邮件格式生成
|
||||
详细的API调用指南请参考:[DACP-API-GUIDE.md](./DACP-API-GUIDE.md)
|
||||
|
||||
2. **schedule_meeting** - 安排会议
|
||||
- 时间解析
|
||||
- 参会人员管理
|
||||
- 会议议程生成
|
||||
## 下一步
|
||||
|
||||
3. **create_document** - 创建文档
|
||||
- 多种文档模板
|
||||
- 智能内容生成
|
||||
- Markdown 格式输出
|
||||
|
||||
## 开发指南
|
||||
|
||||
### 添加新的 Action
|
||||
|
||||
1. 在 `actions/` 目录下创建新文件
|
||||
2. 导出 action 函数
|
||||
3. 实现 DACP 协议规范
|
||||
|
||||
示例:
|
||||
```javascript
|
||||
// actions/custom.js
|
||||
async function custom_action(parameters) {
|
||||
const { user_request, context } = parameters;
|
||||
// 实现逻辑
|
||||
return {
|
||||
// 返回结果
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = { custom_action };
|
||||
```
|
||||
|
||||
## 测试
|
||||
|
||||
```bash
|
||||
# 运行测试
|
||||
npm test
|
||||
```
|
||||
|
||||
## 配置
|
||||
|
||||
配置文件:`dacp.config.json`
|
||||
|
||||
主要配置项:
|
||||
- `service.id`: 服务标识
|
||||
- `deployment.port`: 服务端口
|
||||
- `capabilities.actions`: 支持的 actions 列表
|
||||
基于此演示框架,开发独立部署的专业DACP服务:
|
||||
- `dacp-finance-service` (财务服务)
|
||||
- `dacp-crm-service` (客户管理服务)
|
||||
- `dacp-analytics-service` (数据分析服务)
|
||||
Reference in New Issue
Block a user