Ein Portfolio, das Urteilskraft zeigt

Ein Portfolio im KI-Engineering ist die Arbeit, die Sie einem Arbeitgeber zeigen, und es sollte zeigen, wie Sie entscheiden. Zwei Personen zeigen je einen Chatbot. Die eine teilt einen Screenshot. Die andere teilt eine Tabelle mit Evaluationsergebnissen, eine Liste bekannter Fehler und die Betriebskosten einer Woche.

Wer Personal auswählt, erfährt aus dem zweiten Portfolio viel mehr. In dieser Lektion bauen Sie diese zweite Art aus Ihren Abschlussprojekten.

Besucher geben Ihrem Repository ein, zwei Minuten. Die README muss diese Minute tragen.

Sagen Sie in einem Satz, was das Projekt tut. Sagen Sie, warum Sie es gebaut haben und für wen. Dann sagen Sie in wenigen Schritten, wie man es startet, mit festen Beispieldaten, damit es reproduzierbar ist. Die Evaluationsergebnisse gehören nach oben, nicht ans Ende.

Behaupten kann jeder, dass eine Funktion funktioniert. Ein Beleg ist eine Zahl, die andere nachprüfen können: ein Evaluationsergebnis, Kosten, eine Latenz.

Bekannte Grenzen zählen genauso. Wer sagt, wo das Projekt scheitert, zeigt, dass er es getestet hat. Und er zeigt, dass er weiß, was als Nächstes zu verbessern ist. Das Programm prüft die Überschriften einer README gegen eine Checkliste.

# Die Überschriften in der README eines Abschlussprojekts.
ueberschriften = ["Was es tut", "So starten Sie es", "Ergebnisse der Evaluation"]

checkliste = [
    "Was es tut",
    "Warum ich es gebaut habe",
    "So starten Sie es",
    "Ergebnisse der Evaluation",
    "Bekannte Grenzen",
    "Was ich als Nächstes tun würde",
]

fehlend = 0
for punkt in checkliste:
    if punkt in ueberschriften:
        print("ok      ", punkt)
    else:
        print("fehlt   ", punkt)
        fehlend = fehlend + 1

print(fehlend, "von", len(checkliste), "fehlen")
# Fügen Sie "Bekannte Grenzen" zu ueberschriften hinzu und starten Sie neu.

Bevor ein Repository öffentlich wird, prüfen Sie drei Dinge. Keine Geheimnisse: keine Schlüssel oder Passwörter, auch nicht im Verlauf. Keine personenbezogenen Daten: Nutzen Sie erfundene Namen und Beispieldokumente.

Und es ist Ihr eigenes: Sagen Sie, welche Teile ein Assistent geschrieben hat, und nennen Sie übernommenen Code. Fügen Sie eine Lizenz hinzu, damit andere wissen, was sie damit tun dürfen.