Agendi runtime

Mayros käivitab ühe manustatud agendi runtime'i, mis on tuletatud pi-mono-st.

Tööruum (nõutud)

Mayros kasutab üht agendi tööruumi kataloogi (agents.defaults.workspace) agendi ainsa töökataloogi (cwd) jaoks tööriistade ja konteksti jaoks.

Soovitatav: kasuta mayros setup, et luua ~/.mayros/mayros.json kui puudub ja initsialiseeri tööruumi failid.

Täielik tööruumi paigutus + varundamise juhend: Agendi tööruum

Kui agents.defaults.sandbox on lubatud, saavad mitte-peamised sessioonid seda alistada sessiooni kohta tööruumidega agents.defaults.sandbox.workspaceRoot all (vaata Gateway konfiguratsioon).

Bootstrap failid (süstitud)

agents.defaults.workspace sees ootab Mayros neid kasutaja muudetavaid faile:

  • AGENTS.md — tööjuhised + "mälu"
  • MAYROS.md — persoona, piirid, toon
  • TOOLS.md — kasutaja hooldatavad tööriista märkmed (nt imsg, sag, konventsioonid)
  • BOOTSTRAP.md — ühekordne esmakordne rituaal (kustutatud pärast lõpetamist)
  • IDENTITY.md — agendi nimi/vibe/emoji
  • USER.md — kasutaja profiil + eelistatud aadress

Uue sessiooni esimesel käigul süstib Mayros nende failide sisu otse agendi konteksti.

Tühjad failid jäetakse vahele. Suured failid kärbitakse ja lühendatakse märgiga, et viibad jääksid lahjaks (loe faili täieliku sisu jaoks).

Kui fail puudub, süstib Mayros ühe "puuduva faili" märgi rea (ja mayros setup loob ohutu vaikimisi malli).

BOOTSTRAP.md luuakse ainult täiesti uue tööruumi jaoks (pole teisi bootstrap faile olemas). Kui kustutad selle pärast rituaali lõpetamist, ei peaks seda hilisemate taaskäivituste korral uuesti looma.

Bootstrap failide loomise täielikuks keelamiseks (eelseemnatud tööruumide jaoks), määra:

json5
{ agent: { skipBootstrap: true } }

Sisseehitatud tööriistad

Põhitööriistad (read/exec/edit/write ja seotud süsteemi tööriistad) on alati saadaval, vastavalt tööriista poliitikale. apply_patch on valikuline ja väravastatud tools.exec.applyPatch abil. TOOLS.md ei kontrolli, millised tööriistad eksisteerivad; see on juhis selle kohta, kuidas sina soovid neid kasutada.

Oskused

Mayros laadib oskusi kolmest asukohast (tööruum võidab nime konfliktis):

  • Kaasasolev (tarnitakse paigaldusega)
  • Hallatav/kohalik: ~/.mayros/skills
  • Tööruum: <workspace>/skills

Oskuseid saab väravastada konfiguratsiooniga/env-iga (vaata skills Gateway konfiguratsioon).

pi-mono integratsioon

Mayros taaskasutab pi-mono codebase'i tükke (mudelid/tööriistad), kuid sessiooni haldus, avastamine ja tööriista ühendamine on Mayros-omanduses.

  • Pole pi-coding agendi runtime'i.
  • Pole ~/.pi/agent ega <workspace>/.pi seadeid konsulteeritud.

Sessioonid

Sessiooni transkriptid salvestatakse JSONL-ina:

  • ~/.mayros/agents/<agentId>/sessions/<SessionId>.jsonl

Sessiooni ID on stabiilne ja valitud Mayros poolt. Pärand Pi/Tau sessiooni kaustu ei loeta.

Juhtimine voogedastamise ajal

Kui järjekorra režiim on steer, süstitakse sissetulevad sõnumid praegusesse käitamisse. Järjekorda kontrollitakse pärast iga tööriista kõnet; kui järjekorras olev sõnum on olemas, jäetakse praegusest assistendi sõnumist ülejäänud tööriista kõned vahele (vea tööriista tulemused "Vahele jäetud järjekorras oleva kasutaja sõnumi tõttu."), seejärel süstitakse järjekorras olev kasutaja sõnum enne järgmist assistendi vastust.

Kui järjekorra režiim on followup või collect, hoitakse sissetulevaid sõnumeid kuni praegune käik lõpeb, seejärel algab uus agendi käik järjekorras olevate kasulikkede koormusega. Vaata Järjekord režiimi + debounce/cap käitumise jaoks.

Bloki voogedastamine saadab lõpetatud assistendi blokid kohe kui need lõppevad; see on vaikimisi väljas (agents.defaults.blockStreamingDefault: "off"). Häälesta piir agents.defaults.blockStreamingBreak kaudu (text_end vs message_end; vaikimisi text_end). Kontrolli pehme bloki tükeldamist agents.defaults.blockStreamingChunk abil (vaikimisi 800–1200 märki; eelistab lõigu pause, seejärel reavahetusi; lauseid viimasena). Ühenda voogedastatud tükid agents.defaults.blockStreamingCoalesce abil, et vähendada ühe rea rämpspost (tühikäigupõhine ühendamine enne saatmist). Mitte-Telegram kanalid nõuavad selgesõnalist *.blockStreaming: true, et lubada bloki vastuseid. Üksikasjalikud tööriista kokkuvõtted emiteeritakse tööriista alguses (pole debounce); Control UI voogedastab tööriista väljundit agendi sündmuste kaudu kui saadaval. Rohkem üksikasju: Voogedastamine + tükeldamine.

Mudeli viited

Mudeli viited konfiguratsioonis (näiteks agents.defaults.model ja agents.defaults.models) parsitakse jagades esimese / järgi.

  • Kasuta provider/model mudelite konfigureerimisel.
  • Kui mudeli ID ise sisaldab / (OpenRouter-stiil), lisa pakkuja eesliide (näide: openrouter/moonshotai/kimi-k2).
  • Kui jätad pakkuja vahele, käsitleb Mayros sisendit aliasena või mudelina vaikimisi pakkuja jaoks (töötab ainult kui mudeli ID-s pole /).

Konfiguratsioon (minimaalne)

Minimaalselt määra:

  • agents.defaults.workspace
  • channels.whatsapp.allowFrom (tungivalt soovitatav)

Järgmine: Grupi vestlused