KI-Tools und -Aktionen
Wenn Sie mit dem Administrator-KI-Assistenten chatten, rät das Modell nicht einfach -- es hat eine Reihe von Tools, die es aufrufen kann, um Ihre Daten zu lesen und Aktionen durchzuführen. Dieser Artikel dokumentiert diese Tools, damit Sie genau verstehen, was die KI im Hintergrund tun kann.
Diese Tools stehen nur dem Administrator-Chat zur Verfügung. Der mitgliederorientierte Chat hat keine Tools und ist schreibgeschützt.
Die sechs Administrator-Tools
| Nr. | Tool | Was es tut | Ändert Daten? |
|---|---|---|---|
| 1 | create_announcement |
Entwirft eine neue Ankündigung | Ja -- als inaktiver Entwurf, nach Ihrer Bestätigung |
| 2 | create_event |
Entwirft eine neue Veranstaltung | Ja -- als inaktiver Entwurf, nach Ihrer Bestätigung |
| 3 | search_events |
Findet Veranstaltungen nach Datumsbereich oder Schlüsselwort | Nein -- schreibgeschützt |
| 4 | search_people |
Findet Personen nach Name oder Status | Nein -- schreibgeschützt |
| 5 | update_person_status |
Aktualisiert Mitgliedschafts-/Aktiv-Status einer Person | Ja -- nach Ihrer Bestätigung |
| 6 | query_database |
Führt schreibgeschützte Anzahlen, Listen, Durchschnittswerte, Gruppierungen aus | Nein -- schreibgeschützt |
Bestätigungsgarantie: Jedes Tool, das in die Datenbank schreibt, gibt zuerst eine Vorschau zurück und wartet auf Ihren ausdrücklichen Klick auf „Erstellen" / „Bestätigen". Die KI kann Ihre Daten nicht stillschweigend ändern.
1. create_announcement
Entwirft eine neue Ankündigung und zeigt Ihnen eine Vorschau.
- Eingaben:
title(erforderlich),content(erforderlich),category(optional:general,urgent,event,ministry) - Ausgabe: Wird immer als
is_active = false(Entwurf) gespeichert. Sie veröffentlichen sie manuell aus der Ankündigungsliste.
2. create_event
Entwirft eine neue Veranstaltung und zeigt Ihnen eine Vorschau.
- Eingaben:
title(erforderlich),starts_at(erforderlich,YYYY-MM-DD HH:MM),ends_at(optional),location(optional),description(optional) - Ausgabe: Als inaktiv gespeichert. Sie aktivieren sie manuell aus der Veranstaltungsliste.
3. search_events
Findet Veranstaltungen, ohne etwas zu ändern.
- Eingaben:
start_date,end_date,keyword(alle optional) - Ausgabe: Titel, Datum, Uhrzeit, Ort für jede Übereinstimmung.
4. search_people
Findet Personen nach Name oder Mitgliedschaftsstatus.
- Eingaben:
name,membership_status(member,regular_attender,visitor,inactive),is_active(boolescher Wert) -- alle optional - Ausgabe: Namen und grundlegende Informationen, auf Ihre Berechtigungen beschränkt (Teamleiter sehen nur ihre zugewiesenen Gruppen).
5. update_person_status
Aktualisiert den Mitgliedschaftsstatus oder das Aktiv-Flag einer Person.
- Eingaben:
person_id(erforderlich),membership_status,is_active,reason(optional, z. B. „In einen anderen Staat gezogen") - Ausgabe: Zeigt aktuellen gegenüber vorgeschlagenem Zustand, dann wartet auf Ihre Bestätigung. Administratorberechtigung erforderlich.
6. query_database -- die Daten-DSL
Dies ist das leistungsstärkste Tool. Es akzeptiert eine kleine JSON-DSL, die beschreibt, was Sie möchten, und die KI konvertiert Ihre natürlichsprachige Frage in den richtigen Aufruf.
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
}Entitäten
- people -- Gemeindedatensätze (mit angewendeter Anonymisierung)
- events -- Kalenderveranstaltungen
- groups -- Gruppen und Klassen
- announcements -- Ankündigungsdatensätze
- attendance -- Anwesenheitseinträge
Operationen
| Operation | Was sie tut | Beispielfrage |
|---|---|---|
count |
Gibt eine einzelne Zahl zurück | „Wie viele aktive Mitglieder?" |
average |
Durchschnitt eines numerischen Felds | „Was ist das Durchschnittsalter unserer Jugend?" |
sum |
Summe eines numerischen Felds | „Wie viele Anwesenheitseinträge letzten Monat insgesamt?" |
list |
Gibt Zeilen zurück (begrenzt durch limit) |
„Alle Besucher anzeigen" |
min / max |
Kleinster / größter Wert | „Wer ist unser ältestes Mitglied?" |
group_by |
Anzahlen gruppiert nach einem Feld | „Mitgliedschaft nach Status aufschlüsseln" |
Filter-Beispiele
Die KI erstellt das filters-Objekt aus Ihrer Frage. Häufige Formen:
{"membership_status": "member"}{"is_active": true}{"gender": "female"}{"age_min": 18, "age_max": 30}{"birth_month": 2}-- Februargeburtstage{"birth_day": 14}-- bestimmter Tag des Monats{"created_after": "2026-01-01"}
Beispielübersetzungen
| Sie fragen | KI ruft auf |
|---|---|
| „Wie viele aktive Mitglieder?" | entity: people, operation: count, filters: {membership_status: member, is_active: true} |
| „Durchschnittsalter der Frauen unter 40" | entity: people, operation: average, field: age, filters: {gender: female, age_max: 40} |
| „Geburtstagsliste für März" | entity: people, operation: list, filters: {birth_month: 3}, limit: 50 |
| „Gruppengrößen" | entity: groups, operation: list, field: member_count |
| „Aufschlüsselung des Mitgliedschaftsstatus" | entity: people, operation: group_by, group_by: membership_status |
Prüfprotokollierung
Jede Tool-Ausführung wird protokolliert mit:
- Tool-Name und Argumente
- Benutzer-ID des handelnden Benutzers
- Gemeinde-ID
- Zeitstempel
Suchen Sie nach Einträgen AI Tool execution requested und AI Action confirmed in Ihrem Laravel-Protokoll, um genau zu sehen, was die KI wann getan hat.
Sicherheitszusammenfassung
- Keine Löschungen. Kein Tool kann Datensätze löschen.
- Nur Entwürfe. Alle
create_*-Tools speichern als inaktiv. - Vorschau + Bestätigung. Jeder Schreibvorgang erfordert Ihren ausdrücklichen Bestätigungsklick.
- Berechtigungsbegrenzt. Tools respektieren Ihre Rolle; Teamleiter können keine Daten außerhalb ihrer Gruppen abfragen.
- Standardmäßig schreibgeschützt. Vier der sechs Tools sind reine Leseoperationen.
Verwandte Artikel
- Administrator-KI-Chat-Assistent -- die benutzerseitige Erfahrung
- Was die KI kennt -- welche Felder und Datensätze jedes Tool einsehen kann
- Fehlerbehebung KI -- wenn ein Tool einen Fehler zurückgibt