DI įrankiai ir veiksmai
Kai bendraujate su Administratoriaus DI asistentu, modelis nespėlioja atsakymų -- jis turi įrankių rinkinį, kurį gali iškviesti, kad skaitytų jūsų duomenis ir atliktų veiksmus. Šis straipsnis dokumentuoja šiuos įrankius, kad tiksliai suprastumėte, ką DI gali daryti užkulisiuose.
Šie įrankiai prieinami tik administratoriaus pokalbiui. Nariams skirtas pokalbis neturi jokių įrankių ir yra tik skaitymui.
Šeši administratoriaus įrankiai
| # | Įrankis | Ką jis daro | Keičia duomenis? |
|---|---|---|---|
| 1 | create_announcement |
Parengia naujo skelbimo juodraštį | Taip -- kaip neaktyvų juodraštį, po jūsų patvirtinimo |
| 2 | create_event |
Parengia naujo renginio juodraštį | Taip -- kaip neaktyvų juodraštį, po jūsų patvirtinimo |
| 3 | search_events |
Randa renginius pagal datų intervalą ar raktažodį | Ne -- tik skaitymui |
| 4 | search_people |
Randa žmones pagal vardą ar statusą | Ne -- tik skaitymui |
| 5 | update_person_status |
Atnaujina vieno žmogaus narystės/aktyvumo statusą | Taip -- po jūsų patvirtinimo |
| 6 | query_database |
Vykdo tik skaitymui skirtus skaičiavimus, sąrašus, vidurkius, grupavimus | Ne -- tik skaitymui |
Patvirtinimo garantija: Kiekvienas įrankis, rašantis į duomenų bazę, pirmiausia grąžina peržiūrą ir laukia jūsų aiškaus paspaudimo „Sukurti" / „Patvirtinti". DI negali tyliai keisti jūsų duomenų.
1. create_announcement
Parengia naujo skelbimo juodraštį ir parodo jums peržiūrą.
- Įvestys:
title(privaloma),content(privaloma),category(neprivaloma:general,urgent,event,ministry) - Išvestis: Visada išsaugoma kaip
is_active = false(juodraštis). Jūs paskelbiate jį rankiniu būdu iš Skelbimų sąrašo.
2. create_event
Parengia naujo renginio juodraštį ir parodo jums peržiūrą.
- Įvestys:
title(privaloma),starts_at(privaloma,YYYY-MM-DD HH:MM),ends_at(neprivaloma),location(neprivaloma),description(neprivaloma) - Išvestis: Išsaugoma kaip neaktyvus. Jūs aktyvuojate jį rankiniu būdu iš Renginių sąrašo.
3. search_events
Randa renginius nieko nekeisdamas.
- Įvestys:
start_date,end_date,keyword(visos neprivalomos) - Išvestis: Pavadinimas, data, laikas, vieta kiekvienam atitikmeniui.
4. search_people
Randa žmones pagal vardą ar narystės statusą.
- Įvestys:
name,membership_status(member,regular_attender,visitor,inactive),is_active(loginė reikšmė) -- visos neprivalomos - Išvestis: Vardai ir pagrindiniai duomenys, apriboti jūsų leidimais (komandų vadovai mato tik jiems priskirtas grupes).
5. update_person_status
Atnaujina vieno žmogaus narystės statusą ar aktyvumo žymą.
- Įvestys:
person_id(privaloma),membership_status,is_active,reason(neprivaloma, pvz., „Persikėlė į kitą valstiją") - Išvestis: Rodo dabartinę ir siūlomą būseną, tada laukia jūsų patvirtinimo. Reikalinga administratoriaus prieiga.
6. query_database -- duomenų DSL
Tai galingiausias įrankis. Jis priima nedidelį JSON DSL, aprašantį, ko norite, o DI paverčia jūsų natūralios kalbos klausimą tinkamu iškvietimu.
Schema
{
"entity": "people | events | groups | announcements | attendance",
"operation": "count | average | sum | list | min | max | group_by",
"field": "age | birthdate | created_at | ...",
"filters": { "...": "..." },
"group_by": "membership_status | gender | age_group",
"limit": 20
}Objektai (entities)
- people -- parapijos įrašai (su pritaikytu anonimizavimu)
- events -- kalendoriaus renginiai
- groups -- grupės ir klasės
- announcements -- skelbimų įrašai
- attendance -- lankomumo įrašai
Operacijos
| Operacija | Ką ji daro | Klausimo pavyzdys |
|---|---|---|
count |
Grąžina vieną skaičių | „Kiek aktyvių narių?" |
average |
Skaitinio lauko vidurkis | „Koks mūsų jaunimo vidutinis amžius?" |
sum |
Skaitinio lauko suma | „Kiek iš viso lankomumo įrašų per praėjusį mėnesį?" |
list |
Grąžina eilutes (ribojama limit) |
„Parodyk visus svečius" |
min / max |
Mažiausia / didžiausia reikšmė | „Kas mūsų vyriausias narys?" |
group_by |
Skaičiai, sugrupuoti pagal lauką | „Suskirstyk narystę pagal statusą" |
Filtrų pavyzdžiai
DI sudaro objektą filters iš jūsų klausimo. Dažnos formos:
{"membership_status": "member"}{"is_active": true}{"gender": "female"}{"age_min": 18, "age_max": 30}{"birth_month": 2}-- vasario gimtadieniai{"birth_day": 14}-- konkreti mėnesio diena{"created_after": "2026-01-01"}
Pavyzdiniai vertimai
| Jūs klausiate | DI iškviečia |
|---|---|
| „Kiek aktyvių narių?" | entity: people, operation: count, filters: {membership_status: member, is_active: true} |
| „Vidutinis moterų iki 40 metų amžius" | entity: people, operation: average, field: age, filters: {gender: female, age_max: 40} |
| „Gimtadienių sąrašas kovo mėnesiui" | entity: people, operation: list, filters: {birth_month: 3}, limit: 50 |
| „Grupių dydžiai" | entity: groups, operation: list, field: member_count |
| „Narystės statuso suskirstymas" | entity: people, operation: group_by, group_by: membership_status |
Audito žurnalas
Kiekvienas įrankio vykdymas registruojamas su:
- Įrankio pavadinimu ir argumentais
- Veikiančio naudotojo ID
- Bažnyčios ID
- Laiko žyma
Kiekviena įrankio užklausa ir kiekvienas patvirtintas veiksmas įrašomas sistemos žurnale, kad galėtumėte tiksliai matyti, ką ir kada DI padarė.
Saugumo santrauka
- Jokių trynimų. Nė vienas įrankis negali ištrinti įrašų.
- Tik juodraščiai. Visi įrankiai
create_*išsaugo kaip neaktyvius. - Peržiūra + patvirtinimas. Kiekvienas rašymas reikalauja jūsų aiškaus patvirtinimo paspaudimo.
- Apribota leidimais. Įrankiai gerbia jūsų rolę; komandų vadovai negali užklausti duomenų už savo grupių ribų.
- Pagal numatytuosius nustatymus tik skaitymui. Keturi iš šešių įrankių yra grynai skaitymui.
Susiję straipsniai
- Administratoriaus DI pokalbių asistentas -- naudotojui matoma patirtis
- Ką žino DI -- kuriuos laukus ir įrašus gali matyti kiekvienas įrankis
- DI trikčių šalinimas -- kai įrankis grąžina klaidą