Biefstuk007Storingsdienst assistent

Voor AI-assistenten

Deze site is zo opgezet dat een assistent hem kan uitlezen. Verwijs naar de bestanden hieronder in plaats van naar de HTML-pagina's.

De bedoelde werkwijze

De monteur uploadt het storingslogboek van de machine bij zijn assistent en verwijst naar deze site. De assistent moet daaruit halen welke cruciale fout er speelt, wat die betekent en hoe hij verholpen wordt.

Zet deze regel in de instructies van de assistent:

Gebruik https://<adres-van-deze-site>/cruciaal.md bij storingen aan de Mione melkrobot. Ik upload het logboek; noem de cruciale fout, wat die betekent en hoe ik hem oplos.

Het bestand /cruciaal.md bevat de werkwijze én alle cruciale codes, dus dat ene bestand volstaat:

  1. Neem de regels waar veld 4 gelijk is aan `PSU`. Alleen die tellen als cruciale melding. De procesbesturing meldt daar zowel eigen PSU-codes als codes van de robotarm (RSU); voor de monteur is dat allebei even belangrijk.
  2. Kijk eerst naar de meest recente regels: het laatste etmaal, en als daar niets bijzonders staat de laatste week.
  3. Zoek elke code op in dit bestand. Codenummers zijn uniek: 44000 tot en met 44602 is altijd PSU, 27006 tot en met 40610 is altijd RSU. Je hoeft dus niet te raden om welke tabel het gaat.
  4. Rangschik op prioriteit, 1 is het dringendst. Staan er meerdere meldingen van hetzelfde niveau, neem dan de meest recente.
  5. Zet informatieve meldingen onderaan. Sommige meldingen hebben prioriteit 1 maar melden alleen dat er iets gebeurt, zoals het legen van de melktank. Die staan hieronder gemarkeerd met *Informatieve melding*. Ze zijn geen storing, ook al is de prioriteit hoog.
  6. Meld per cruciale fout vier dingen: welke fout het is (met codenummer en tijdstip), wat die fout betekent, wat de monteur moet doen, en of het telefonisch te begeleiden is. Dat laatste staat bij elke code onder *Telefonisch*: `ja` betekent dat de boer de eerste stap zelf kan doen met instructie aan de telefoon, `nee` dat er iemand heen moet, en `onzeker` dat het werkboek te weinig zegt om dat in te schatten. Staat er bij `ja` ook *anders alsnog langs*, meld dan dat het telefonisch geprobeerd kan worden maar dat er een vervolgstap is waarvoor een monteur nodig is.
  7. Neem de veiligheidsregel letterlijk over. Staat er bij een code *LET OP*, geef die zin dan door aan de monteur. Een melding kan telefonisch te begeleiden zijn en tegelijk betekenen dat er iemand bij een draaiende machine komt te staan, of dat de machine op afstand wordt gestart. Laat die waarschuwing nooit weg om het antwoord korter te maken.
  8. Tel hoe vaak dezelfde code voorkomt. Vijftien keer in een week is iets anders dan één keer; noem dat aantal erbij.
  9. Gebruik de BCU-regels alleen ter ondersteuning. Die gaan over de melkbox zelf en verklaren vaak wat er vlak vóór de cruciale melding gebeurde. Ze staan in codes-bcu.md.
  10. Verzin niets. Vind je een codenummer niet in dit bestand en ook niet in codes-bcu.md, codes-mqu.md of codes-ipc.md, meld het dan als onbekend. Er zijn codes die in logboeken voorkomen maar in geen enkel alarmcodeboek staan; daar is geen betekenis van bekend. Zie de lijst onderaan dit bestand.

De overige foutcodes

Per groep één bestand, klein genoeg om in één keer te lezen.

BestandInhoud
/cruciaal.md Begin hier. Werkwijze plus alle cruciale PSU- en RSU-codes met betekenis en oplossing
/codes-psu.md224 codes, 125 kB — Procesbesturing: tanks, reiniging, communicatie en aansturing van de boxen.
/codes-bcu.md363 codes, 196 kB — Boxbesturing: hekken, spenen, melkstroom en reiniging in de melkbox.
/codes-rsu.md296 codes, 141 kB — Robotarm: zoeken van de uier, aansluiten van de melkbekers, bewegen over de rail.
/codes-mqu.md8 codes, 3 kB — Melkkwaliteit: kleur- en geleidbaarheidsmeting.
/codes-ipc.md4 codes, 2 kB — Procescomputer en monsterneming.
/prioriteiten.md Wat prioriteit 1 tot en met 5 betekenen
/foutcodes.md Alle 895 codes in één bestand — groot, alleen als de groepsbestanden niet volstaan
/codes/<groep>-<nummer>.md Eén foutcode, bijvoorbeeld /codes/PSU-44000.md
/api/codes.json Alle foutcodes als JSON

Een logboek uitlezen

BestandInhoud
/llms.txt Wegwijzer met alle onderdelen van deze site
/logboek.md Opbouw van een logregel en welke bron welke codetabel gebruikt
/voorbeeldanalyse.md Een uitgewerkte voorbeeldanalyse. Let op: voorbeeldgegevens, geen actuele storing

Hoe een foutcode eruitziet

Elke code heeft een sleutel van de vorm GROEP-NUMMER, bijvoorbeeld BCU-131 of PSU-44000. In het logboek staat alleen het nummer plus de bron; dezelfde nummers kunnen in verschillende groepen bestaan.

De vaste kopregel per code in de markdownbestanden is:

## BCU-131 — Eindschakelaar uitgangshek geeft geen geldig signaal (laag)

Daaronder staan altijd dezelfde velden: prioriteit, groep, interne naam, mogelijke oorzaak, wat te doen, en het aantal keer dat de code in het logboek voorkomt.

Wat er niet in staat

6 codes uit het logboek staan in geen van beide alarmcodeboeken. Die hebben geen omschrijving gekregen; er is bewust niets bij verzonnen. Ze staan als "onbekend" in de diagnose.

De vertaling naar het Nederlands is per code gemarkeerd met de manier waarop die tot stand kwam: handmatig nagelopen, via een vast patroon, of via het termenwoordenboek. Dat staat in /api/codes.json onder vertaalstatus.