# OpenAgents

**Repository Path**: cep/open-agents

## Basic Information

- **Project Name**: OpenAgents
- **Description**: OpenAgents
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Demo: Content Creation Team

多 Agent 内容创作协作系统。支持博客/文章、技术文档、报告、论文等内容类型的协作创作。

## 概述

本 Demo 展示了 **ContentWorkflow Mod** 的使用，实现多阶段内容创作工作流：
- 编排器接收创作请求，创建工作流
- 专业 Agent 协作完成各阶段任务
- 审核反馈与迭代修订机制
- 最终输出高质量内容

## 架构

```
                    ┌─────────────────────┐
    创作请求   ────▶│    Orchestrator     │
                    │    (编排器)          │
                    └──────────┬──────────┘
                               │ create_workflow
                               ▼
                    ┌─────────────────────┐
                    │  ContentWorkflow    │
                    │      Mod            │
                    └──────────┬──────────┘
                               │ task_assigned
         ┌─────────────────────┼─────────────────────┐
         │                     │                     │
         ▼                     ▼                     ▼
  ┌─────────────┐       ┌───────────┐       ┌─────────────┐
  │ Researcher  │       │  Writer   │       │  Reviewer   │
  │  (研究员)    │       │ (写作者)   │       │  (审核员)   │
  └──────┬──────┘       └─────┬─────┘       └──────┬──────┘
         │                    │                    │
         └────────────────────┼────────────────────┘
                              │
                              ▼
                       ┌───────────┐
                       │  Editor   │
                       │ (编辑者)   │
                       └───────────┘
```

## 工作流阶段

不同内容类型对应不同的阶段序列：

| 内容类型 | 阶段序列 |
|---------|---------|
| `article` (文章) | research → writing → review → editing |
| `technical_doc` (技术文档) | research → outline → writing → review → editing |
| `report` (报告) | research → analysis → writing → review → editing |
| `paper` (论文) | research → outline → writing → review → revision → editing |

## Agent 角色

| Agent | 角色 | 职责 |
|-------|------|------|
| `orchestrator` | 编排器 | 接收请求，创建工作流，监控进度 |
| `researcher` | 研究员 | 收集素材，调研背景，分析数据 |
| `writer` | 写作者 | 设计大纲，撰写内容，修订 |
| `reviewer` | 审核员 | 审核质量，评分，提供反馈 |
| `editor` | 编辑者 | 最终润色，格式化，发布准备 |

## 快速开始

### 1. 启动网络

```bash
cd demos/content_creation_team
openagents network start network.yaml
```

### 2. 启动 Agent

在不同终端中：

```bash
openagents agent start agents/orchestrator.yaml
openagents agent start agents/researcher.yaml
openagents agent start agents/writer.yaml
openagents agent start agents/reviewer.yaml
openagents agent start agents/editor.yaml
```

或使用启动脚本：

```bash
python run.py all
```

### 3. 连接 Studio

```bash
cd studio && npm start
# 连接到 localhost:8800
```

### 4. 开始创作

在 Studio 中向 Orchestrator 发送创作请求：

> "请帮我写一篇关于 AI 编程助手发展趋势的技术文章"

## 创作示例

**文章类型：**
> "写一篇关于 Python 3.12 新特性的博客文章"

**技术文档：**
> "创建一份 REST API 设计最佳实践的技术文档"

**报告类型：**
> "撰写一份 2024 年前端框架市场分析报告"

**论文类型：**
> "写一篇关于大语言模型在代码生成领域应用的研究论文"

## 工作流配置

| 参数 | 默认值 | 说明 |
|-----|-------|------|
| `max_revisions` | 3 | 最大修订次数 |
| `quality_threshold` | 7.0 | 质量评分阈值 (0-10) |

## 审核机制

审核员对内容进行评分 (0-10)，根据评分决定：
- **approve** (≥7.0): 通过，进入下一阶段
- **revise** (<7.0): 需要修订，返回写作阶段
- **reject**: 拒绝，工作流失败

## 配置说明

- **网络端口:** 8800 (HTTP), 8801 (gRPC)
- **Mod:** `openagents.mods.workspace.content_workflow`
- **Agent 组:** `orchestrators`, `content_workers`

## 目录结构

```
content_creation_team/
├── network.yaml          # 网络配置
├── run.py               # 启动脚本
├── README.md            # 说明文档
└── agents/
    ├── orchestrator.yaml  # 编排器配置
    ├── researcher.yaml    # 研究员配置
    ├── writer.yaml        # 写作者配置
    ├── reviewer.yaml      # 审核员配置
    └── editor.yaml        # 编辑者配置
```