# 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**: 2025-12-21

## 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
python scripts/alert_demo.py
```

## 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. 注册到智能体管理系统中

## 许可证

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