# PoE2 Agent

Open-source AI agents for Path of Exile 2 build analysis and generation.

## Overview

This repo provides two agents that share a common tool-calling layer:

- **chat-agent** — Answer questions about a PoB build using LLM + tool calling (current focus)
- **build-agent** — Full agentic build generator with multi-step reasoning (future)

Both are library crates, designed to be called from the web server in [poe2-app](../app-main).

## Architecture

```
poe2-app (server)
  └─ chat-agent
       └─ tool-calling (LLM client + tool definitions)
            ├─ pob-headless (PoB Lua engine)
            ├─ wiki (poewiki.net data)
            └─ knowledge (game mechanics for LLM context)
```

## Crates

| Crate | Description |
|-------|-------------|
| `tool-calling` | Shared LLM client and tool definitions |
| `chat-agent` | Simple single-turn agent for the web app |
| `build-agent` | Complex multi-step build generator (has its own docs and backlog) |
| `pob-headless` | Path of Building 2 Lua engine wrapper |
| `wiki` | PoE2 wiki data fetcher with caching |
| `knowledge` | Pre-summarized game concepts for LLM context |

## Building

```bash
cargo build --release
```

## Usage

```bash
# Set your OpenAI API key
export OPENAI_API_KEY="sk-..."

# Clone PoB2 (if not already present)
git clone https://github.com/PathOfBuildingCommunity/PathOfBuilding-PoE2.git vendor/PathOfBuilding-PoE2

# Run the build agent CLI
poe2-build-agent "cold DoT occultist for endgame bossing"
```

## Development

See [CLAUDE.md](./CLAUDE.md) for project conventions.

The build-agent has its own design docs and ticket backlog in `crates/build-agent/`.

## License

TBD
