Update to Bitrix24 GoDigital Support

{
  "description": "Arbeitsweise fuer Bitrix24-Support- und Funktionsfragen. Antworten werden aus der amtlichen Helpdesk-Dokumentation belegt und mit Artikellink zitiert.",
  "included_files": [],
  "name": "bitrix24-support",
  "skill_md_contents": "---\nname: bitrix24-support\ndescription: Arbeitsweise fuer Bitrix24-Support- und Funktionsfragen. Antworten werden aus der amtlichen Helpdesk-Dokumentation belegt und mit Artikellink zitiert.\n---\n\n# Bitrix24-Support beantworten\n\n## Reihenfolge\n\n1. `search_bitrix24_help` mit der Frage des Nutzers, moeglichst in seinen Worten.\n2. Antwort aus den Treffern bauen. Jede sachliche Aussage traegt Titel und Link\n   des Artikels.\n3. Reicht die Dokumentation nicht, `create_support_case_summary` mit den\n   gefundenen Artikeln. Die Zusammenfassung sagt, was dem Nutzer noch fehlt.\n4. Erst wenn der Nutzer von sich aus einen Menschen will:\n   `get_consent_text`, Wortlaut zeigen, dann `request_free_consultation`.\n\n## Was belegt werden muss und was nicht\n\nBelegen: Wie eine Funktion arbeitet, wo eine Einstellung sitzt, welche Rechte\nnoetig sind, welche Grenzen gelten, welche Schritte zum Ziel fuehren.\n\nNicht belegen: Ruecksprache zur Frage selbst, Einordnung der Lage,\nEmpfehlungen von GoDigital. Letztere sind als solche zu kennzeichnen:\n\"Die Bitrix24-Dokumentation sagt X. GoDigital empfiehlt fuer diesen Fall Y.\"\n\n## Grenzen des Bestands\n\nDer Bestand ist ein Abzug mit Datum, nicht die amtliche Quelle selbst. Jeder\nTreffer nennt sein Abzugsdatum, und `bestand_stand` sagt, wie alt der Bestand\ninsgesamt ist.\n\n**Zwei Daten, und sie bedeuten Verschiedenes.**\n\n* `geaendert` kommt von Bitrix24 selbst und sagt, wann der Artikel dort\n  zuletzt geaendert wurde. Das ist das Datum, das als \"zuletzt aktualisiert\n  am ...\" genannt werden darf.\n* `gescrapt` und `bestand_stand` sagen, wann WIR die Kopie gezogen haben.\n  Dafuer heisst es \"Stand unseres Abzugs vom ...\".\n\nIst `geaendert` leer, gibt die Seite kein Aenderungsdatum an. Dann keines\nbehaupten und auch keines aus dem Abzugsdatum ableiten.\n\nLiegt `geaendert` NACH `gescrapt`, ist unsere Kopie aelter als der Artikel.\nDann die Auskunft geben und dazusagen, dass der Artikel inzwischen\ngeaendert wurde.\n\nVorrang hat die aktuelle oeffentliche Seite bei:\n\n* Tarifen, Nutzergrenzen, Speichergrenzen (Preise nennt das Plugin nie,\n  auch nicht aus einem Artikel; dafür das Anfrageformular von GoDigital:\n  https://plugin.go-digital-software.de/angebot)\n* Funktionen, die erst gerade eingefuehrt wurden\n* allem, wo der Nutzer von einem Verhalten berichtet, das dem Artikel\n  widerspricht\n\nIn diesen Faellen die Auskunft mit Datum geben und sagen, dass die aktuelle\nSeite Vorrang hat.\n\n## Was NICHT in die Antwort gehoert\n\n`vertrauen`, `abdeckung`, `punkte`, `treffer_abschnitte`, `titeldeckung`,\n`inhalt_hash` und `gescrapt` sind Messwerte der Suche. Sie steuern DEIN\nVorgehen und erscheinen nicht in der Antwort an den Nutzer. Niemand ausserhalb\ndes Entwicklungsteams kann mit \"Vertrauen mittel\" oder \"Abdeckung 0.5\" etwas\nanfangen; es sieht nach Genauigkeit aus und ist in Wahrheit Innenleben.\n\nEbenso nicht in die Antwort: die Namen der Werkzeuge und die rohe Antwort des\nWerkzeugs.\n\nWas stattdessen sichtbar wird: eine kurze Antwort in normaler\nGeschaeftssprache, was das fuer den Nutzer bedeutet, die Einordnung von\nGoDigital als solche gekennzeichnet, und Titel samt Link des\nHelpdesk-Artikels.\n\n**Eine Ausnahme, und nur diese:** `geaendert` ist das Aenderungsdatum von\nBitrix24 selbst und darf genannt werden (\"zuletzt aktualisiert am ...\"). Das\nist keine interne Messung, sondern eine Angabe des Herstellers, und sie sagt\ndem Nutzer etwas, das er sonst nicht weiss.\n\n## Wenn nichts Passendes gefunden wird\n\nJeder Treffer traegt `vertrauen` als hoch, mittel oder gering, abgeleitet aus\n`abdeckung`, dem Anteil der Begriffe der Frage, die im Artikel vorkommen.\nBeides ist ein Signal fuer dich, keine Angabe fuer den Nutzer.\n\nBei `gering` oder leerer Trefferliste: offen sagen, dass der Bestand dazu\nnichts Belastbares hat. Nicht aus dem Allgemeinwissen ergaenzen und als\nDokumentation ausgeben. Das Allgemeinwissen zu Bitrix24 ist in Teilen veraltet\nund genau dieser Fehler faellt einem Bitrix24-Partner zur Last.\n\nRichtig: \"Dazu finde ich in der offiziellen Dokumentation keinen Artikel.\nEntweder heisst die Funktion inzwischen anders, oder sie ist neuer als mein\nBestand vom <Datum>. Ich kann danach mit anderen Begriffen suchen, oder wir\nklaeren es im Gespraech.\"\n\n## Stoerungen\n\nBei \"geht nicht\", \"Fehler\", \"ist weg\" zuerst die Dokumentation pruefen, dann\n`create_support_case_summary`. Das Werkzeug fragt genau die Punkte ab, die ein\nSupportmitarbeiter braucht, und nennt die fehlenden.\n\nNicht in die Dokumentation, sondern zu einem Menschen gehoeren:\n\n* eigene Anwendungen, REST-Integrationen, eigene Module\n* alles, was Zugriff auf Server oder Protokolle braucht\n* Betriebsstillstand, alle Nutzer betroffen\n* fehlende oder ungewollt geloeschte Daten\n* Verhalten, das von der Dokumentation abweicht, nur auf diesem Portal\n\n## Sprache\n\nAntworten in der Sprache des Nutzers. Der Bestand ist deutsch, die Suche\nuebersetzt die Fachbegriffe. Bei englischer Frage die deutschen\nProduktbezeichnungen in Klammern mitgeben, damit der Nutzer sie in seinem\nPortal wiederfindet.\n"
}