Filozofija

Zašto konfiguracija, a ne kod

Filozofija QueryMT-a: tvoj AI agent treba biti datoteka, a ne program.

Problem s kodom

Danas gotovo svaki okvir za AI agente traži pisanje koda. Python, TypeScript ili nešto treće: ponašanje definiraš imperativno. To znači:

  • Teško za pregled. Ne možeš pogledati Python skriptu od 200 redaka i odmah vidjeti što agent radi.
  • Teško za dijeljenje. Dijeljenje agenta često znači stablo ovisnosti, virtualenv i nadu da će sve raditi.
  • Nije zaista prenosivo. Kod je vezan za runtime. LangChain agent ne radi isto u browseru ili na telefonu.
  • Teško za reviziju. Diff između dvije verzije ne pokazuje jasno kako se ponašanje agenta promijenilo.

Zašto TOML

TOML datoteka je izjava namjere. Govori što agent treba napraviti, ne kako. Za način izvedbe brine okvir.

# Ovo je potpuni agent
[agent]
provider = "anthropic"
model = "claude-sonnet-4-5-20250929"
tools = ["shell", "knowledge_ingest", "knowledge_query"]

[agent.execution]
max_steps = 30

[[middleware]]
type = "limits"
max_turns = 15

Što dobivaš

  • Pregledno: Otvori datoteku. Pročitaj je. Točno znaš što agent radi.
  • Djeljivo: Zalijepi TOML u Slack poruku. To je sve.
  • Prenosivo: Isti config radi u CLI-ju, dashboardu, VS Codeu, iOS-u i Androidu.
  • Lako za reviziju: git diff točno pokazuje što se promijenilo u ponašanju agenta.
  • Verzionirano: Konfiguracije žive u gitu uz tvoj kod. Povratak na staru verziju je trivijalan.

Kompromis

Pristup vođen konfiguracijom znači da ne možeš izraziti proizvoljnu logiku. Ako ti treba prilagođeni algoritam rutiranja ili namjenski alat, moraš napisati Rust kod i uključiti ga u okvir. Sustav konfiguracije pokriva 90% slučajeva upotrebe. Rust API pokriva ostatak.

To je namjerno. Konfiguracija je proizvod. Kod je platforma.