Glossary
Quick lookup for the abbreviations and TnsAI-specific terms that appear in the rest of the documentation. Linked terms go to the page that explains the concept in depth.
| Term | Definition |
|---|---|
| Action | A unit of work an agent can execute. Declared via @ActionSpec on a role method. |
| Agent | Long-lived object that runs a BDI loop — perceives input, plans intentions, executes actions. |
| BDI | Belief–Desire–Intention. The mental model TnsAI agents are built around. |
| Capability | A reusable contract (interface with default-method actions) a role can implement. |
| Channel | Adapter for an external messaging platform — Telegram, Slack, CLI, Email, etc. |
| FSM | Finite State Machine. The agent lifecycle (CREATED → STARTING → RUNNING → STOPPING → STOPPED + FAILED) is one. |
| Gaia | Multi-agent methodology that frames a system as roles, environment, and relationships. TnsAI's coordination module borrows from it. |
| GOAP | Goal-Oriented Action Planning. One of the planners under tnsai-intelligence. |
| HTN | Hierarchical Task Network — the other built-in planning style. |
| KB / Knowledge Base | Vector + BM25-indexed corpus that backs @KnowledgeSource / @Retrieval. |
| LAM | Language-Action Model — the pattern that maps LLM output to typed action calls. See LAM pattern. |
| MCP | Model Context Protocol. Lets agents expose tools to (or consume tools from) MCP-compatible peers. |
| RAG | Retrieval-Augmented Generation. |
| ReAct | Reasoning-and-Acting pattern: interleave LLM "thought" steps with tool calls. |
| Role | Bundle of capabilities and actions an agent plays. |
| SCOP | A separate Java multi-agent framework — see scop-framework.netlify.app. TnsAI ships an integration bridge. |
| SPI | Service Provider Interface — Java's ServiceLoader discovery pattern, the framework's main extensibility seam. |
| ToT | Tree of Thoughts — branching reasoning pattern that explores multiple lines before committing. |
Configuration Reference
A consolidated reference for the knobs you can set on TnsAI from outside the code (env vars) or through builders. This page indexes the canonical sources rather than duplicating them — the goal is to tell you where to look, not to mirror state that will drift.
Tutorials
End-to-end walkthroughs. Each tutorial takes a real scenario and builds a working agent from scratch.