Projektek¶

Adj minden munkának saját polcot. A projekt egy saját mappa az ügynököd szerverén, saját fájlokkal, saját utasításokkal és saját beszélgetésekkel. A felújítás a felújításnál marad, a szakdolgozat a szakdolgozatnál, mindez egyetlen ügynökön.

🏠 Általánosa fő mappád

💬Heti terv
💬Adóbevallási kérdések

📁 Felújításaz új csevegések itt indulnak

📝„Keret 15 ezer €, mindig vess össze három árajánlatot”
📄arajanlatok.pdf · alaprajz.png
💬Konyhai csempe
💬A villanyszerelő időpontjai

📁 Családi utazás👥 megosztott

📄jegyek.pdf
💬Program napról napra

Mit ad egy projekt¶

Saját mappa

Az ügynök a projekt mappájában dolgozik: oda kerülnek a projekt beszélgetéseiben küldött fájlok, és ugyanígy az általa készített fájlok, a futtatott kód és az ütemezett feladatok is.
Saját utasítások

Egy jegyzet, amelyet az ügynök a projekt minden beszélgetésének elején elolvas: mire való a projekt, hogyan dolgozzon, mire figyeljen.
Saját beszélgetések

A beszélgetéslista azt a projektet mutatja, amelyben éppen vagy, és minden új csevegés ott indul. Nem kell semmit fejben tartani, és utólag sem kell rendezgetni.
Privát vagy megosztott

Ha az ügynököt másokkal is megosztod, egy projekt lehet csak a tiéd, vagy közös mindenkivel, a fájlokkal és a beszélgetésekkel együtt.

Minden más minden projektben ugyanaz: az ügynök memóriája és személyisége, a készségei, a modell és a beállítások, a kulcsok és a bejelentkezések, valamint a kredited. A panel Fájlkezelő és Terminál nézete mindig a teljes szervert mutatja. A projektváltás azt változtatja meg, hol dolgozik az ügynök, azt nem, hogy kicsoda.

1 Kapcsold be a projekteket¶

A projektek addig ki vannak kapcsolva, amíg valaki be nem kapcsolja őket, és addig semmi sem látszik belőlük: minden beszélgetés a fő mappádban dolgozik. Mivel újak, a panel Béta jelzéssel látja el őket.

Panel: Beállítások → Projektek → Projektek használata.
Telegram: küldd el a /projects parancsot, és koppints a ▶️ Projektek bekapcsolása gombra.

A kapcsoló az egész ügynökre vonatkozik: bárki, aki használja, legyen az a tulajdonos vagy egy meghívott felhasználó, be- és kikapcsolhatja. A kikapcsolás egyetlen mappához sem nyúl hozzá. A projektben elindított beszélgetések továbbra is ott dolgoznak; csak az újak kerülnek vissza a fő mappádba.

2 Hozz létre egy projektet¶

Panel: nyisd meg a projektváltót az oldalsáv tetején, és válaszd az Új projekt lehetőséget. Adj neki nevet, nyomd meg a Projekt hozzáadása gombot, és már benne is vagy, egy új csevegés pedig rád vár.
Telegram: /projects → ➕ Új projekt, majd küldd el a nevét. A bot létrehozza a projektet, és át is vált rá.
A Beállítások → Projektek → + Új projekt úgy hoz létre egyet, hogy közben nem hagyod el azt a projektet, amelyben éppen vagy.

Minden projekt saját mappát kap az ügynök szerverén.

💡 Ha az ügynöködön be van kapcsolva a További felhasználók engedélyezése, a panel azt is megkérdezi, Ki láthatja: Csak én vagy Az ügynök minden felhasználója. Ezt később is megváltoztathatod, lásd Projektek megosztott ügynökön. A Telegramban létrehozott projekt privátként indul.

3 Válts a projektek között¶

A panelen a beszélgetéslista fölötti projektváltó mutatja, melyik projektben vagy. Válassz egy másikat: a lista annak beszélgetéseivel telik meg, és az új csevegések is ott indulnak. Ugyanennek a menünek az alján a Projektek kezelése megnyitja a beállításokat.

A Telegramban a /projects (vagy a /menu → Beállítások → 📁 Projektek) felsorolja a projektjeidet: 🏠 a fő mappád, 📁 a sajátjaid, 👥 a megosztottak, az aktívon ✅ jellel. A váltáshoz koppints egy másikra. Ha az a csevegés, amelyben éppen vagy, egy másik projekthez tartozik, a kiválasztott projektben rögtön új beszélgetés indul, és a kitűzött címe a projekt nevével kezdődik. A /sessions ezután az adott projekt beszélgetéseit listázza, a tetején a projekt nevével.

Az átnevezés, a megosztás, az utasítások és az eltávolítás a panelen történik.

Jó tudni:

A beszélgetés ott marad, ahol elindult. A váltás sosem mozgat át egy már folyamatban lévő csevegést. Az megtartja a projektjét, a mappáját és az utasításait; a váltás csak azt dönti el, hol indul a következő.
A panel és a Telegram külön választ. Lehetsz a Telegramban a Felújítás projektben, miközben a panel a Szakdolgozat projektet mutatja. Mindkettő a saját választását jegyzi meg.

4 Adj utasításokat a projektnek¶

Beállítások → Projektek → a projekt melletti ⋯ → Utasítások…

Írd ide, amit az ügynöknek tudnia kell: mire való a projekt, kik vesznek részt benne, milyen döntések születtek már, hogyan szeretnéd, hogy a munka készüljön. Az ügynök a projekt minden beszélgetésének elején elolvassa, így nem kell minden alkalommal újra elmagyaráznod a hátteret.

Például

„A lakásunk felújítása. Keret 15 000 €, márciusra legyen kész. Mindig vess össze legalább három árajánlatot. Vezess folyamatosan költségtáblát a koltsegek.xlsx fájlban, és frissítsd, valahányszor ajánlat érkezik.”

A lényeg kerüljön az elejére

A már folyamatban lévő beszélgetés megtartja azokat az utasításokat, amelyekkel elindult, így a módosítás a következő csevegéstől érvényes. Hosszú utasítás is lehet, de csak az első néhány ezer karakter jut el közvetlenül az ügynökhöz; a többit szükség esetén a fájlból olvassa el.

Az utasítások a projekt mappájában vannak, egy közönséges fájlban (AGENTS.md), így azt is kérheted az ügynöktől, hogy ő írja meg vagy frissítse őket helyetted.

A fő mappád¶

Mindenkinek, aki az ügynököt használja, saját fő mappája van, amely a projektváltóban Általános néven jelenik meg. Itt dolgoznak a beszélgetések, amíg a projektek ki vannak kapcsolva, és itt van minden, ami a projektek előtti időből származik.

Az Általános nem projekt, hanem az otthonod: nem lehet átnevezni, megosztani vagy eltávolítani. Ez a hely a több projektet átfogó munkákhoz is. Egy projektből az ügynök az adott projekt mappájában marad, az Általánosból viszont mindegyikhez hozzáfér.

Projektek megosztott ügynökön¶

Ha megosztod az ügynöködet másokkal, mindenki saját fő mappát és saját projekteket kap. Minden projekt kétféle lehet:

Privát (alapértelmezett)

Csak neked jelenik meg a listában, és csak a te beszélgetéseid kerülnek bele.
Megosztott

Az ügynök minden felhasználójának megjelenik a listában, Megosztott jelöléssel. Mindenki ugyanazokkal a fájlokkal és utasításokkal dolgozik, és a benne folyó beszélgetések is közösek.

Megosztott projektben a beszélgetések közös terepet jelentenek. Mindenki látja őket a projekt listájában, és elolvashatja, folytathatja, átnevezheti vagy törölheti őket, így többen is dolgozhatnak ugyanabban a csevegésben: a panelen vagy a Telegramban, ahol a /sessions 👥 jellel jelöli őket, és egy koppintással be lehet kapcsolódni. Minden üzenetnél látszik, ki írta, és az ügynök tudja, kinek válaszol. Egyszerre egy üzenetre felel: ha éppen valaki más üzenetére válaszol, a panel vagy a bot szól, és a sajátodat akkor küldheted el, amikor a válasz megérkezett.

Megosztás vagy priváttá tétel a projekt ⋯ menüjéből: Megosztás minden felhasználóval vagy Priváttá tétel. A priváttá tett projekt eltűnik a többiek listájáról, az abban folytatott beszélgetéseik pedig a saját fő mappájukban mennek tovább.
Ki kezeli a megosztott projektet: aki létrehozta, és az ügynök tulajdonosa. Az átnevezés és az eltávolítás az ő dolguk. Priváttá csak a létrehozó teheti vissza.
A megosztott projekt háttérfeladatai mindenkié. Minden felhasználó látja őket a Beállítások → Háttérfeladatok alatt, módosíthatja őket, és megkapja az értesítéseiket a panelen és a Telegramban.
Ha egy felhasználót eltávolítanak, az általa megosztott projektek megosztottak maradnak, és a tulajdonoshoz kerülnek. A privát projektjei lekerülnek a listákról, a fájlok pedig a szerveren maradnak.

Privát: rejtett, de nem elzárt

A meghívott felhasználók megbízható felhasználók. Mindenki munkája ugyanazon a fiókon fut az ügynök szerverén, ezért a privát projekt ugyan nem jelenik meg mások listájában, de nem széf. Ami igazán titkos, azt ne tartsd megosztott ügynökön.

Projekt eltávolítása vagy végleges törlése¶

A törlés két lépésben történik, hogy semmi ne tűnjön el véletlenül:

⋯ → Eltávolítás a listából. A projekt lekerül a listákról, de a fájljai és a beszélgetései a szerveren maradnak, a belőle származó beszélgetéseid pedig az Általános alatt jelennek meg. A projektet a Beállítások → Projektek alján, az Eltávolított projektek között találod, ahol a Vissza a listára visszahozza.
Eltávolított projektek → ⋯ → Végleges törlés… Ez törli a mappát a benne lévő összes fájllal és minden beszélgetéssel, amely benne dolgozott, és nem vonható vissza. A megerősítéshez be kell írnod a mappa nevét. Megosztott projektnél a panel azt is jelzi, hány másik felhasználónak vannak benne beszélgetései.

Jó tudni¶

Az átnevezés csak a nevet változtatja meg. A mappa megtartja azt a nevet, amellyel létrejött, így a rá hivatkozó linkek, szkriptek és eszközök tovább működnek. Az utasítások ablaka a mappa valódi nevét mutatja.
Az elküldött fájlok a projektnél maradnak. A projekt beszélgetésében küldött fájl a projektmappa uploads könyvtárába másolódik, és az ügynök ott helyben dolgozik vele. Kikapcsolt projektek mellett a fájlok ugyanúgy tárolódnak, mint eddig.
A háttérfeladatok egy projektben futnak. A Beállítások → Háttérfeladatok alatt egy feladat első mezője a projektje, és az új feladat abban a projektben indul, amelyik éppen nyitva van. Ha egy projekt beszélgetésében kérsz feladatot az ügynöktől, az abban a projektben fut. A megosztott projekt feladata mindenkit értesít, aki az ügynököt használja, minden más feladat csak téged. Amíg a projektek ki vannak kapcsolva, minden feladat csak azt értesíti, akié.
A keresés mindenre kiterjed. Az ügynök az összes beszélgetésed előzményeiben keres, bármelyik projektben legyenek is, és meg tudja mondani, melyik projektből származik egy találat.
Az API az Általánosban dolgozik. Az ügynök OpenAI-kompatibilis API-ján érkező hívások mindig a hívó fő mappájában dolgoznak.
Legfeljebb 50 projekt fér el egy ügynökön, mindenkiét beleszámítva. Egy név legfeljebb 60 karakter hosszú lehet.