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

1.1 KiB Raw Blame History