# industry_agent_platform

**Repository Path**: zcakin/industry_agent_platform

## Basic Information

- **Project Name**: industry_agent_platform
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# industry-agent-platform

`industry-agent-platform` 是一个 Python FastAPI 行业智能体任务执行平台初始工程。第一阶段聚焦可运行、可测试、边界清晰的后端骨架。

## 项目定位

平台采用知识服务与任务编排解耦架构：

- RAGFlow 作为外部知识服务，负责文档解析、知识库管理和检索问答。
- Python Harness Runtime 作为任务编排主控层，负责意图路由、固定工作流、Skill 执行、证据聚合和任务追踪。
- 场景化 Skill Pack 承载行业任务能力。

## 快速启动

```bash
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
uvicorn app.main:app --reload
```

## 环境变量

复制 `.env.example` 并按需调整：

```bash
APP_NAME=industry-agent-platform
APP_ENV=dev
LOG_LEVEL=INFO
RAGFLOW_BASE_URL=http://localhost:9380
RAGFLOW_API_KEY=change-me
RAGFLOW_TIMEOUT_SECONDS=30
LLM_PROVIDER=mock
DATABASE_URL=sqlite+aiosqlite:///./dev.db
REDIS_URL=redis://localhost:6379/0
```

## 运行命令

```bash
uvicorn app.main:app --reload
pytest
ruff check .
```

## 示例请求

健康检查：

```bash
curl http://127.0.0.1:8000/api/health
```

知识问答：

```bash
curl -X POST http://127.0.0.1:8000/api/chat/knowledge \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"u1\",\"domain\":\"building_energy\",\"query\":\"冷冻水泵运行标准是什么？\",\"chat_id\":null,\"need_citation\":true}"
```

任务执行：

```bash
curl -X POST http://127.0.0.1:8000/api/tasks \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"u1\",\"domain\":\"building_energy\",\"task_type\":\"anomaly_analysis\",\"query\":\"分析冷冻水泵异常原因并生成报告\",\"input_data\":{},\"need_citation\":true,\"async_mode\":false}"
```

## 第一阶段不做什么

- 不实现完全自主 Agent。
- 不实现多智能体协作。
- 不自动生成 Skill。
- 不实现复杂权限系统。
- 不替代 RAGFlow 的文档解析和知识库管理。
- 不实现复杂前端。

## 后续计划

后续按 `docs/CODEX_TASKS.md` 逐项推进真实 RAGFlow API、持久化、Review API、异步队列、更多场景和前端管理页面。