Facilioo-Agent-CLI (Deutsch)

facilioo-agent-cli

Wann zu verwenden

Verwenden Sie dieses Skill, wenn eine Aufgabe echte Arbeit in Facilioo erfordert und die bevorzugte Oberfläche eine Terminal-Workflow ist, nicht die Weboberfläche.

Verwenden Sie es besonders, wenn ein Agent:

• sich von der Kommandozeile aus bei Facilioo authentifizieren muss,
• Kontext zu einer Immobilie, einem Eingang, einer Einheit oder einem Kontakt aufbauen muss,
• Anfragen, Prozesse, Arbeitsaufträge, Termine, Benutzeraufgaben, Mitteilungen oder Benachrichtigungen einsehen muss,
• Dokumente herunterladen oder hochladen muss,
• eine Konferenzagenda oder ein Protokoll bearbeiten muss,
• geschützte Updates durchführen muss, ohne rohe HTTP-Aufrufe zu improvisieren.

Vorbedingungen

• Behandeln Sie facilioo-agent-cli als die Produktoberfläche.
• Überprüfen Sie zuerst, ob es im PATH existiert:
  • facilioo-agent-cli --help
  • facilioo-agent-skill --help
• Falls es fehlt, installieren Sie es über das öffentliche Paket:
  • npm install -g @codecell-germany/facilioo-agent-skill
  • facilioo-agent-skill install --force
• Umgehen Sie nicht die öffentliche CLI, indem Sie repo-lokales dist/, versteckte Codex-Tool-Ordner oder alte lokale Shim-Dateien durchsuchen.
• Beginnen Sie nicht mit Ad-hoc-Swagger-Aufrufen, wenn die CLI den Workflow bereits bereitstellt.

Erstausführungserkennung

Führen Sie vor jeder tatsächlichen Facilioo-Arbeit Folgendes aus:

facilioo-agent-cli auth status --json
facilioo-agent-cli doctor --profile auth --json

Behandeln Sie die Umgebung als nicht bereit, wenn eines der folgenden zutrifft:

• die CLI fehlt
• keine persistente Sitzung existiert
• die konfigurierte Authentifizierungsmethode ist API-Key-Login, aber kein API-Key verfügbar
• doctor schlägt fehl
• der Benutzer sagt, dies sei die erste Einrichtung

Wenn die Einrichtung unvollständig ist, wechseln Sie sofort in den Onboarding-Modus. Starten Sie nicht mit context, ops, documents oder conferences.

Onboarding-Modus

Dies ist die genaue Reihenfolge für einen neuen oder teilweise konfigurierten Benutzer beim ersten Start:

1. Teilen Sie dem Benutzer mit, dass die Einrichtung noch nicht abgeschlossen ist.
2. Drucken Sie die integrierte Einrichtungsanleitung in der bevorzugten Sprache des Benutzers:
   • Englisch: facilioo-agent-cli setup --language en
   • Deutsch: facilioo-agent-cli setup --language de
3. Sammeln Sie zuerst nur die statischen Werte:
   • FACILIOO_BASE_URL
   • FACILIOO_API_VERSION
   • FACILIOO_AUTH_METHOD
4. Standardmäßig den lokalen Passwort-Flow verwenden, wenn ein Mensch am Terminal anwesend ist:
   • facilioo-agent-cli auth login --method password --interactive --persist
5. API-Key-Login nur verwenden, wenn der Benutzer explizit ein technisches oder automatisierungsorientiertes Setup wünscht:
   • FACILIOO_API_KEY
   • facilioo-agent-cli auth login --method api-key --persist
6. Niemals nach:
   • Access-Tokens
   • Refresh-Tokens
   • rohen Browser-Cookies fragen
7. Nach dem Login erneut ausführen:
   • facilioo-agent-cli auth status --json
   • facilioo-agent-cli doctor --profile core-read --json
8. Erst dann mit Geschäftsbefehlen fortfahren.

Kern-Workflow

1. Setup validieren:
   • facilioo-agent-cli auth status --json
   • facilioo-agent-cli doctor --profile core-read --json
2. Kontext aufbauen:
   • facilioo-agent-cli context lookup --search "Musterstraße 12" --json
   • facilioo-agent-cli context property --id 123 --include entrances,units,tenant,documents,ops --json
   • facilioo-agent-cli context unit --id 456 --include documents,ops --json
3. Betriebswarteschlangen bearbeiten:
   • facilioo-agent-cli ops inbox --property-id 123 --json
   • facilioo-agent-cli ops processes search --property-id 123 --open-only --json
   • facilioo-agent-cli ops tasks mine --json
   • facilioo-agent-cli ops notifications mine --json
4. Dokumente bearbeiten:
   • facilioo-agent-cli documents search --property-id 123 --search "Versicherung" --json
   • facilioo-agent-cli documents download --id 5001 --output /absolute/path/file.pdf --json
5. Konferenzen bearbeiten:
   • facilioo-agent-cli conferences search --property-id 123 --json
   • facilioo-agent-cli conferences protocol --id 7001 --json

Leitplanken

• Leseoperationen sind standardmäßig sicher.
• Schreibvorgänge erfordern:
  • --execute --confirm-write yes
• Jeder bereitgestellte Löschvorgang erfordert:
  • --execute --allow-delete --confirm-delete yes
• Verwenden Sie --preview vor sensiblen Änderungen oder Löschungen.
• Passwort-Login ist nur interaktiv und sollte lokal von einem Menschen in einem echten TTY abgeschlossen werden.
• auth export ist opt-in und sollte nur verwendet werden, wenn ein anderer Prozess explizit Umgebungsexporte benötigt.
• Geben Sie Tokens nicht in Eingabeaufforderungen, Tickets, Chats oder Screenshots weiter.
• Behandeln Sie rohe API-Pfade nicht als normalen Weg, wenn ein Befehl auf hoher Ebene existiert.

Löschregel

Die Löschregel ist in diesem Skill global, nicht nur prozessspezifisch.

Beispiele:

facilioo-agent-cli ops processes delete --id 987 --preview --json
facilioo-agent-cli ops processes delete --id 987 --execute --allow-delete --confirm-delete yes --json

facilioo-agent-cli documents delete --id 5001 --preview --json
facilioo-agent-cli documents delete --id 5001 --execute --allow-delete --confirm-delete yes --json

Wenn der Benutzer einen Löschvorgang nicht explizit genehmigt hat, führen Sie ihn nicht aus.

Referenzen

• Agent-Onboarding-Runbook: references/agent-onboarding.md
• Hauptübersicht: references/overview.md
• Befehls-Spickzettel: references/command-cheatsheet.md
• Erstausführungseinrichtung: references/facilioo-first-run.md