◆ Sparround

İnterfeyslər: CLI, API server, IDE, səs

Eyni agentə çatmağın bir neçə yolu var və hər yol fərqli iş üçündür:

  • CLI / TUI — gündəlik iş, dərin sessiyalar, tam alət dəsti
  • Desktop tətbiqi — qrafik interfeys istəyənlər üçün
  • Messaging gateway — telefondan, komandadan, hərəkətdə ikən
  • API server — OpenAI-uyğun HTTP endpoint; başqa proqramlar Hermes-i model kimi çağırır
  • ACP / IDE — VS Code, Zed, JetBrains kimi redaktorların içində
  • Dashboard — brauzerdə konfiqurasiya və monitorinq
  • Səs rejimi — CLI və messaging platformalarında səsli qarşılıqlı əlaqə

API server ən çox yanlış anlaşılan hissədir. O, Hermes-i OpenAI-uyğun endpoint kimi göstərir — yəni OpenAI API-si ilə işləyən istənilən proqram (öz tətbiqin, n8n, redaktor plugin-i) Hermes-ə sorğu göndərə bilir. Fərq isə budur: adi model endpoint-i mətn qaytarır, Hermes isə alətləri işlədib cavab qaytarır.

Sənədlərə görə API server rejimində bəzi interaktiv alətlər (məsələn aydınlaşdırıcı sual və mətn-səs) sıradan çıxarılır — çünki cavabı gözləyən adam yoxdur.

İnterfeysƏmrTipik iş
CLI / TUI`hermes`, `hermes --tui`Kod, araşdırma, uzun sessiyalar
Skript rejimi`hermes -z "..."`Cron, CI, boru xətləri
Desktop`hermes desktop`Qrafik interfeys
API server`hermes serve`Başqa proqramların qoşulması
IDE (ACP)`hermes acp`Redaktor içində iş
Dashboard`hermes dashboard`Konfiqurasiya və monitorinq

İnterfeys seçimi həm də təhlükəsizlik qərarıdır: CLI-də sən hər təsdiqi görürsən, API server və cron rejimində isə interaktiv təsdiq mümkün deyil. Sənədlərdə bunun üçün ayrıca parametrlər var — məsələn cron və tək-sorğuluq rejimlərində təsdiq davranışının defoltu deny-dır. Yəni interfeys dəyişdikcə təsdiq siyasətini də şüurlu seçmək lazımdır.

Praktika. hermes serve ilə API server-i qaldır və ona adi bir HTTP sorğusu göndər (curl və ya OpenAI SDK ilə). Sonra eyni sualı CLI-dən ver və iki cavabı müqayisə et. Hazır sayılır: API rejimində hansı alətin işləmədiyini və nəyə görə işləmədiyini deyə bilirsən.

📚 Mənbələr və sənədlər