# 基于deepseek的市场营销团队

**Repository Path**: joey2022/deepseek

## Basic Information

- **Project Name**: 基于deepseek的市场营销团队
- **Description**: 开发一个多智能体分工协作的市场营销团队，使用多个智能体模拟专业营销团队，用户委托简短的需求，团队最终为用户提供一个营销规划书。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-07-30
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ChatAd: 基于deepseek的市场营销团队
———AI 驱动的广告活动策划与投放系统

## 1. 项目简介

ChatAd 是一个基于大型语言模型的AI智能体系统，旨在自动化广告活动策划的流程。用户只需输入一个任务目标（例如，"为某款新手游制定推广方案"），系统便能通过模拟一个多角色的专业团队（如CEO, 广告策划，文案专员等）的协作，一步步地分析、讨论并最终生成一套完整的广告投放策划方案，包括文档、策划案、策划书和其他相关产出。

## 2. 功能特性

- **Web 用户界面**: 提供一个可视化的操作界面，用户可以轻松提交任务、监控进度、查看结果并下载最终方案。
- **高度可配置**: 项目的核心流程、阶段、角色和提示语等都可以通过JSON文件进行灵活配置，方便用户根据不同需求进行定制。
- **数据驱动**: 能够整合外部数据（如行业排行、推广数据等）作为知识库，为AI决策提供依据。
- **自动化工作流**: 模拟真实团队的工作流程，包括头脑风暴、任务分解、方案执行、报告生成等多个阶段。

## 3. 文件夹结构

```
.
├── CompanyConfig/      # 存放核心配置文件，如角色、阶段和聊天链的定义
│   └── Default/        # 默认的配置文件
├── WareHouse/          # 所有生成任务的输出目录，每次运行会在此创建唯一的项目文件夹
├── camel/              # 核心依赖框架，提供了构建AI智能体的基础能力
├── chatad/             # 项目核心逻辑，实现了广告策划的聊天链（ChatChain）
├── logs/               # 存放系统运行日志和任务输出日志
├── visualizer/         # Web服务器和前端界面代码
│   ├── app.py          # Flask应用主程序
│   └── static/         # 前端静态文件 (HTML, CSS, JS)
├── 推广/               # 存放原始的推广数据Excel文件，作为AI的知识库
├── .gitignore
├── load_promotion_data.py  # 用于将"推广"目录下的Excel数据加载到SQLite数据库的脚本
├── promotion_data.sqlite   # 存储推广数据的SQLite数据库文件
├── readme.md               # 本文档
└── run.py                  # 项目的主命令行入口
```

## 4. 安装

我们提供了 `environment.yml` 文件来统一管理项目依赖。请使用 Conda 来创建和管理虚拟环境。

**创建并激活 Conda 环境**

```bash
# 使用 environment.yml 文件创建虚拟环境
conda env create -f environment.yml

# 激活环境
conda activate chatad_env
```

该命令会根据 `environment.yml` 文件自动安装所有必需的依赖项，包括 Python 版本和所有必需的库。

## 5. 数据准备

本项目可以利用外部数据进行更精准的策划。数据源位于 `推广/` 目录下。

1.  将您的Excel数据文件（.xlsx）放入 `推广/` 目录。
2.  运行以下脚本，将这些Excel文件的数据加载到 `promotion_data.sqlite` 数据库中。

```bash
python load_promotion_data.py
```

该脚本会读取 `推广/` 目录下的所有 `.xlsx` 文件，并将其内容存入数据库，供AI在决策时查询。

## 6. 如何运行

您可以通过两种方式运行本项目：

需要保证电脑路径**无英文**，避免意料之外的错误
解决之前需要设置电脑为utf-8的问题，在执行项目前设置python临时变量
    ```bash
set $env:PYTHONIOENCODING="UTF-8"
    ```
### 方式一：使用 Web 界面 (推荐)

这是最简单直接的方式，提供了图形化操作界面。

1.  启动 Web 服务器：

```bash
python visualizer/app.py --port 8946
```

2.  服务器启动后，在浏览器中打开 `http://127.0.0.1:8946`。

3.  在网页上输入您的**任务描述**和**项目名称**，点击提交即可开始。

4.  您可以在界面上实时查看AI团队成员的对话流程，任务完成后可以下载完整的项目文件压缩包。

### 方式二：使用命令行

如果您希望在后端直接运行，可以使用 `run.py` 脚本。

```bash
python run.py --task "您的任务描述" --name "您的项目名称"
```

任务完成后，最终的产出文件会保存在 `WareHouse/` 目录下一个以项目名和时间戳命名的文件夹中。

## 7. 配置说明

您可以对AI团队的行为进行深度定制，所有配置均位于 `CompanyConfig/` 目录下。

-   **创建新配置**:
    1.  在 `CompanyConfig/` 下复制 `Default` 文件夹并重命名，例如 `MyConfig`。
    2.  修改 `MyConfig` 文件夹内的JSON文件以满足您的需求。
        -   `RoleConfig.json`: 定义团队中有哪些角色（如`首席执行官`, `广告策划师`），以及他们的职责描述。
        -   `PhaseConfig.json`: 定义项目的各个阶段（如`需求分析`, `方案设计`），以及每个阶段由哪些角色参与、需要完成什么任务。
        -   `ChatChainConfig.json`: 将所有阶段串联起来，形成完整的工作流。
-   **使用新配置**:
    -   **Web 界面**: Web界面目前硬编码使用 `Default` 配置。如需修改，请直接更改 `CompanyConfig/Default/` 下的文件，或修改 `visualizer/app.py` 中调用 `run.py` 的命令参数。
    -   **命令行**: 通过 `--config` 参数指定您的配置名称。
        ```bash
        python run.py --config MyConfig --task "您的任务" --name "您的项目"
        ```

## 8. 命令行参数

以下是 `run.py` 支持的所有命令行参数：

| 参数 | 默认值 | 帮助说明 |
| :--- | :--- | :--- |
| `--config` | `Default` | `CompanyConfig/` 目录下的配置名称。 |
| `--org` | `DefaultOrganization` | 组织名称，用于构建输出目录。 |
| `--task` | "为某品牌制定一份广告投放方案..." | 具体的软件任务提示。 |
| `--name` | `AdCampaign` | 项目的名称，用于构建输出目录。 |
| `--model` | `DEFAULT_MODEL` | 使用的AI模型类型。 |


## 9.其他
如果需要修改deepseek key和ppt key请在这些位置修改:
deepseek key在:visualizer\app.py第94行
ppt key在：visualizer\static\index.html的第572行