# Intelligence Agent

🧠 **AI-powered Security Blog Automation System**

## Overview

Intelligence Agent는 보안 뉴스를 자동으로 수집하고, LLM(GLM-4.7)을 사용하여 전문가 수준의 블로그 글을 작성한 후, Notion과 GitHub Pages에 자동으로 게시하는 시스템입니다.

## Features

- 🔍 **뉴스 수집**: Google News, arXiv, HackerNews RSS 피드에서 최신 보안 뉴스 수집
- ✍️ **AI 글 작성**: GLM-4.7을 사용하여 3000+ 자의 전문적인 블로그 글 작성
- 📝 **Notion 연동**: 초안 작성 → 검토중 → 검토 완료 상태 관리
- 🚀 **자동 배포**: Git 기반 GitHub Actions으로 자동 블로그 배포
- 📅 **스케줄링**: 매일 08:30 자동 실행 (APScheduler)

## Architecture

```
뉴스 수집 (Collector)
    ↓
GLM-4.7 글 작성 (LLM Client)
    ↓
Notion 저장 (Notion Publisher)
    ↓
사용자 검토 (Human-in-the-Loop)
    ↓
Git 배포 (Git Publisher)
    ↓
GitHub Actions → GitHub Pages
```

## Project Structure

```
intelligence-agent/
├── __init__.py
├── collector.py              # 뉴스 수집기
├── llm_client.py            # GLM-4.7 API 클라이언트
├── llm_client_async.py      # 비동기 LLM 클라이언트
├── notion_publisher.py      # Notion API 연동
├── git_publisher_service.py # Git 배포 서비스
├── publisher_git.py         # Git 퍼블리셔
├── intelligence_pipeline.py # 전체 파이프라인
├── config.py                # 설정
├── models.py                # 데이터 모델
├── prompt_manager.py        # 프롬프트 관리
├── prompts.yaml             # 프롬프트 템플릿
├── requirements.txt         # 의존성
└── README.md                # 이 파일
```

## Installation

```bash
# 저장소 클론
git clone https://github.com/rebugui/intelligence-agent.git
cd intelligence-agent

# 가상환경 생성
python3 -m venv venv
source venv/bin/activate

# 의존성 설치
pip install -r requirements.txt

# 환경 변수 설정
cp .env.example .env
# .env 파일 편집
```

## Configuration

### 필수 환경 변수

```bash
# GLM API
GLM_API_KEY=your_glm_api_key
GLM_BASE_URL=https://api.z.ai/api/coding/paas/v4

# Notion API
NOTION_API_KEY=your_notion_api_key
NOTION_DATABASE_ID=your_database_id

# GitHub
GITHUB_TOKEN=your_github_token
GITHUB_REPO=rebugui/rebugui.github.io

# 블로그
BLOG_LOCAL_PATH=/path/to/blog/repo
```

## Usage

### 1회 실행 (테스트용)

```bash
python intelligence_pipeline.py
```

### 스케줄러 실행 (매일 08:30)

```bash
python scheduler_intelligence.py
```

### 수동 실행

```python
from intelligence_pipeline import IntelligencePipeline

pipeline = IntelligencePipeline()
pipeline.run()
```

## API Reference

### NewsCollector

```python
from collector import NewsCollector

collector = NewsCollector()
articles = collector.collect_all()
# Returns: List[Article]
```

### LLMClient

```python
from llm_client import LLMClient

client = LLMClient()
blog_post = client.generate_blog_post(articles)
# Returns: str (Markdown formatted)
```

### NotionPublisher

```python
from notion_publisher import NotionPublisher

publisher = NotionPublisher()
page_id = publisher.create_page(title, content, status="초안 작성중")
# Returns: str (Page ID)
```

### GitPublisher

```python
from git_publisher_service import GitPublisher

publisher = GitPublisher()
publisher.publish_to_blog(page_id, content)
# Deploys to GitHub Pages
```

## Workflow

### 상태 변화 플로우

```
1. 초안 작성중 (자동 저장)
   ↓
2. 검토중 (사용자 검토 시작)
   ↓
3. 검토 완료 (사용자 승인) → Git 배포 자동 시작
   ↓
4. 게시 완료 (GitHub Pages 배포)
```

### Human-in-the-Loop

- **자동화된 부분**: 뉴스 수집, 글 작성, Notion 저장
- **수동 검토**: Notion에서 내용 확인/수정
- **자동 배포**: "검토 완료" 상태 시 자동 Git 배포

## Technical Stack

- **Language**: Python 3.9+
- **LLM**: GLM-4.7 (Zhipu AI)
- **News Sources**: Google News, arXiv, HackerNews
- **CMS**: Notion API
- **Blog**: Hugo + GitHub Pages
- **Scheduler**: APScheduler
- **State Management**: Notion Database

## Blog

- **URL**: https://rebugui.github.io/
- **Repository**: https://github.com/rebugui/rebugui.github.io
- **Theme**: Hugo Stack Theme

## Monitoring

### 로그 확인

```bash
tail -f logs/intelligence.log
```

### 상태 확인

```bash
python -c "from intelligence_pipeline import IntelligencePipeline; p = IntelligencePipeline(); print(p.get_status())"
```

## Troubleshooting

### GLM API 연결 오류

```bash
# API 키 확인
echo $GLM_API_KEY

# 연결 테스트
curl -X POST https://api.z.ai/api/coding/paas/v4/chat/completions \
  -H "Authorization: Bearer $GLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "glm-4.7", "messages": [{"role": "user", "content": "Hello"}]}'
```

### Notion API 오류

```bash
# Database 권한 확인
# https://www.notion.so/my-integrations 에서 연결 상태 확인
```

### Git 배포 오류

```bash
# Git 권한 확인
ssh -T git@github.com

# 저장소 상태 확인
cd $BLOG_LOCAL_PATH
git status
```

## Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## License

MIT License

## Author

Generated by Builder Agent v3

## Links

- GitHub: https://github.com/rebugui/intelligence-agent
- Blog: https://rebugui.github.io/
- Notion: https://www.notion.so/