35 lines
1.1 KiB
Markdown
35 lines
1.1 KiB
Markdown
# AGENTS.md
|
|
|
|
This file specifies documentation guidelines for the NaliiaBot project.
|
|
|
|
## Project Overview
|
|
|
|
NaliiaBot is a conversational agent based on LangGraph for appointment scheduling management. It provides customer service through a Telegram-like interface and integrates with LLM models (Anthropic Claude, DeepSeek).
|
|
|
|
## Key Components
|
|
|
|
| Component | Path | Description |
|
|
|-----------|------|-------------|
|
|
| Agent | `src/naliiabot/bot/agent/agent.py` | LangGraph-based conversational agent |
|
|
| Tools | `src/naliiabot/bot/tools/naliia_tools.py` | Tools available to the agent |
|
|
| API | `src/naliiabotapi/main.py` | FastAPI REST API |
|
|
| Database | `docker-compose.yaml` | PostgreSQL for state checkpointing |
|
|
|
|
## Available Commands
|
|
|
|
- `task dev` - Run API server on port 8010
|
|
- `task test` - Run all tests with pytest
|
|
- `task test-cov` - Run tests with coverage report
|
|
|
|
## Development Notes
|
|
|
|
- Uses Python 3.13
|
|
- LLM models configured via `LLM_MODEL` env var (default: "deepseek")
|
|
- MCP server runs on `http://localhost:8001/mcp`
|
|
- Database uses PostgreSQL with checkpoint persistence
|
|
- Timezone: America/Bogota
|
|
|
|
## Testing
|
|
|
|
Run tests with: `pytest -v`
|