Redmine

A Codumentor kapcsolatba tud lépni a szervezeted Redmine rendszerével — jegyeket keres, ellenőrzi a naplózott időt, és jegyeket hoz létre vagy módosít —, mindezt anélkül, hogy elhagynád a csevegést. Nincs külön Redmine panel; egyszerűen természetes nyelven kéred, amire szükséged van, és az asszisztens meghívja a megfelelő eszközt.

Ez a funkció nem minden környezetben érhető el. Ha a Redmine-jegyekkel kapcsolatos kérdések nem működnek, előfordulhat, hogy az adminisztrátorodnál nincs engedélyezve.

A fiókod összekapcsolása

A Redmine-eszközök teként járnak el, a saját Redmine API-kulcsodat használva — nincs megosztott, példányszintű hitelesítő adat. Mielőtt az asszisztens bármit is le tudna kérdezni a nevedben:

1. A Redmine-ban nyisd meg a My account → API access key oldalt, és jelenítsd meg (vagy generáld le) a kulcsodat.
2. A Codumentorban nyisd meg a Beállítások → Felhasználói titkok menüt, és adj hozzá egy redmine_api_key nevű titkot (előfordulhat, hogy az adminisztrátorod más nevet állított be) ezzel az értékkel.

Ha ennek beállítása előtt kérsz valamit a Redmine-nal kapcsolatban, az asszisztens jelezni fogja, hogy hiányzik a kulcs, és megkér, hogy add hozzá — magától nem próbálkozik újra, amíg meg nem erősíted, hogy a titok be van állítva.

Mit tehetsz

Kérj természetes nyelven; az asszisztens kiválasztja a megfelelő műveletet. Tipikus kérések:

"Milyen Redmine-jegyek vannak most rám kiosztva?"

"Mutasd meg a #4213-as jegyet, az előzményeivel és csatolmányaival együtt."

"Hány órát naplóztam a Redmine-ban ebben a hónapban?"

"Hozz létre egy Redmine hibajegyet a Codumentor projektben 'Login fails on Safari' címmel, ezzel a leírással..."

"Adj hozzá egy megjegyzést a #4213-as jegyhez, hogy a javítás élesítve lett."

"Jelöld megoldottnak a #4213-as jegyet, és rendeld hozzá Annához."

Ezek mögött az asszisztens a következőkhöz fér hozzá:

• Jegyek keresése és olvasása — jegyek listázása vagy szűrése projekt, állapot, felelős vagy szöveges egyezés szerint, illetve egy jegy teljes részletének lekérése (leírás, előzmények, csatolmányok).
• Projektek listázása — mely Redmine projektekhez férsz hozzá.
• Naplózott idő ellenőrzése — összesített vagy tételes óraszám felhasználó, projekt, jegy vagy dátumtartomány szerint. Ez az egyetlen megbízható módja annak, hogy megválaszoljuk: "mennyi időt naplóztam ebben a hónapban" — egy jegy saját óraösszege ugyanis élettartam-szintű, nem időszakonkénti.
• Csatolmány letöltése — egy jegy csatolmányát ideiglenes helyre húzza le, hogy az asszisztens elolvashassa vagy bemásolhassa egy repositoryba; a tartalma nem kerül közvetlenül a beszélgetésbe.
• Jegy létrehozása — tárgy, leírás, projekt, tracker, prioritás, felelős, és bármely, a Redmine-példányodban definiált egyéni mező.
• Jegy módosítása — állapot, felelős, tárgy, leírás, prioritás, készültségi százalék és egyéni mezők.
• Megjegyzés hozzáadása egy meglévő jegyhez, opcionálisan privátként megjelölve.

A lekérdezések azonnal, rákérdezés nélkül lefutnak. Egy jegy létrehozása, módosítása vagy megjegyzéssel ellátása előbb a te jóváhagyásodat kéri, ugyanúgy, ahogy egy shell parancs esetén is.

A subagensek kevesebbet kapnak

Ha az asszisztens a kérésed egy részét egy subagensre bízza, az a subagens jellemzően továbbra is le tudja kérdezni és olvasni a Redmine-jegyeket, de alapértelmezetten nem hozhat létre, nem módosíthat és nem kommentelhet jegyet — ezt csak a fő beszélgetés teheti meg. Az adminisztrátorod ezt megváltoztathatja.

Egyéni mezők és szokatlan kérések

A Redmine-példányok gyakran definiálnak egyéni mezőket (egy "Bejelentő e-mail" mezőt, egy prioritási sémát, egy kötelező jóváhagyási mezőt). Említsd meg természetesen — "vedd fel a 'Needs QA' egyéni mezőbe" —, és az asszisztens beveszi, ha megtalálja a megfelelő mezőt. Néhány olyan dologhoz, amihez nincs beépített művelet (egy enumerációs lista, egy mentett lekérdezés), az asszisztens egy általánosabb Redmine-kéréshez folyamodhat; minden, ami túlmutat egy egyszerű lekérdezésen, továbbra is előbb a jóváhagyásodat kéri.

Amit érdemes tudnod a korlátokról

• Csak az érhető el, amit a saját Redmine-fiókod amúgy is lát vagy megtehet — az asszisztens teként hitelesít, így soha nem olvashat el olyan projektet vagy hajthat végre olyan műveletet, amit a saját Redmine-jogosultságaid nem engednének meg.
• Egy jegy saját naplózottóra-összege nem szűrhető dátum szerint; ha egy konkrét időszakra van szükséged, kérdezz rá kifejezetten, hogy az asszisztens közvetlenül az időbejegyzéseket kérdezze le.
• A csatolmányok tartalma nem kerül automatikusan a beszélgetésbe — kérd meg az asszisztenst, hogy olvassa el a letöltött másolatot, ha meg szeretnéd beszélni.