# auto-decision-agent

**Repository Path**: code-me/auto-decision-agent

## Basic Information

- **Project Name**: auto-decision-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Auto Decision Agent

参考青藤无相安全自主智能体架构，构建一个支持长链路任务规划与多智能体协作的自主决策智能体框架，适用于复杂安全场景下的自动化研判与响应。

## 项目概述

本项目旨在构建一个自主决策智能体框架，具有以下特点：

- 长链路任务自动规划（Planner）
- 多源上下文感知与状态监控（Perception）
- 工具调用与执行反馈闭环（Execution）
- 基于ReAct范式的决策循环控制
- 多类安全专用Agent（检测/分析/响应/溯源/合规等）

## 技术架构

采用三层架构 + Agent协作模式：

- 感知层（perception）：采集环境状态与上下文
- 规划层（brain）：任务拆解、知识推理、决策生成
- 执行层（execution）：工具调用、结果反馈、状态更新
- 控制流：通过ReAct循环驱动整体流程
- 协作机制：多个专用Agent通过Task Manager协调工作

## 快速开始

### 环境要求

- Python >= 3.10
- pip 包管理工具

### 安装依赖

```bash
pip install -r requirements.txt
```

### 运行应用

```bash
# 启动API服务器
python src/main.py

# API将在 http://localhost:8000 启动
# 访问 http://localhost:8000/docs 查看API文档
```

### 运行测试

```bash
# 运行所有测试
python run_tests.py unit

# 运行集成测试
python run_tests.py integration

# 运行特定测试文件
python run_tests.py specific tests/test_brain_planner.py

# 查看所有可用测试
python run_tests.py list
```

## API文档

资产管理API提供了完整的RESTful接口用于资产的增删改查、风险评估、关系管理等功能。

### API访问

- API基础路径: `http://localhost:8000/api/v1/`
- API文档: `http://localhost:8000/docs`
- ReDoc文档: `http://localhost:8000/redoc`

### API使用示例

详细使用示例请参考 [API使用示例文档](docs/api_usage_examples.md)

## 目录结构

```
src/
├── core/
│   ├── brain/        # 规划层
│   ├── perception/   # 感知层
│   └── execution/    # 执行层
├── agents/           # 智能体实现
├── engines/          # 引擎实现
├── react/            # ReAct循环
└── utils/            # 工具函数

scripts/              # 演示脚本
docs/                 # 文档
```

## 功能模块

### 核心模块

1. **资产管理** (`src/core/perception`)
   - 资产发现与分类
   - 资产关系管理
   - 风险评估
   - 变更监控

2. **智能体系统** (`src/agents`)
   - 资产智能体
   - 集成协调智能体

3. **任务规划** (`src/core/brain`)
   - 任务分解与规划

### 资产发现方式

系统支持多种资产发现方式：

1. 网络扫描（Nmap, SNMP等）
2. 代理收集
3. API集成（云服务商API、CMDB等）
4. 日志分析
5. 流量分析

## 开发指南

### 添加新的资产发现器

1. 继承 `AssetDiscoverer` 基类
2. 实现 `discover_assets` 和 `discover_relationships` 方法
3. 注册到发现框架中

### 添加新的智能体

1. 继承 `BaseAgent` 基类
2. 实现具体的任务处理逻辑
3. 注册到智能体管理系统中

## 文档

项目包含详细的模块文档和使用指南：

### 架构文档
- `designs/architecture.md` - 总体架构设计
- `designs/workflow.md` - 工作流设计
- `designs/agent_design.md` - 智能体设计

### 模块文档
- `src/core/brain/README.md` - 大脑/规划层文档
- `src/core/perception/README.md` - 感知层文档
- `src/core/execution/README.md` - 执行层文档
- `src/engines/README.md` - 引擎层文档
- `src/react/README.md` - ReAct循环文档
- `src/agents/README.md` - 智能体模块文档
- `src/apis/README.md` - API接口文档
- `src/utils/README.md` - 工具模块文档

## 测试

项目包含全面的测试套件：

### 测试结构
```
tests/
├── __init__.py                 # 测试包初始化
├── conftest.py                 # pytest配置和fixtures
├── test_brain_planner.py       # 大脑规划器测试
├── test_perception_asset.py    # 资产感知测试
├── test_execution_executor.py  # 执行器测试
├── test_engines_plan_ai.py     # Plan AI引擎测试
├── test_react_loop.py          # ReAct循环测试
└── test_integration_workflow.py # 集成测试
```

### 运行测试

使用提供的测试运行脚本：

```bash
# 运行所有单元测试
python run_tests.py unit

# 运行集成测试
python run_tests.py integration

# 生成覆盖率报告
python run_tests.py unit --coverage

# 运行特定测试
python run_tests.py specific tests/test_brain_planner.py::TestPlanner::test_create_plan_rule_based_security_analysis
```

### 测试覆盖

- **单元测试**: 覆盖核心组件的独立功能
- **集成测试**: 验证组件间的协作
- **端到端测试**: 验证完整业务流程
- **性能测试**: 验证系统性能指标

## 开发指南

### 代码规范

项目遵循以下代码规范：

- 使用 `black` 进行代码格式化
- 使用 `isort` 进行导入排序
- 使用 `mypy` 进行类型检查
- 使用 `pytest` 进行测试

### 开发工作流

1. 创建功能分支
2. 编写代码和测试
3. 运行测试确保通过
4. 提交代码和测试
5. 创建Pull Request

### 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建Pull Request

## 许可证

本项目仅供学习和研究使用。