12 KiB
🚀 Modul 1: Grundlagen des Microsoft Foundry Toolkits
📋 Lernziele
Am Ende dieses Moduls werden Sie in der Lage sein:
- ✅ Die Microsoft Foundry Toolkit Extension für VS Code zu installieren und zu konfigurieren
- ✅ Den Modellkatalog zu navigieren und verschiedene Modellquellen zu verstehen
- ✅ Den Playground für Modeltests und Experimente zu nutzen
- ✅ Maßgeschneiderte KI-Agenten mit dem Agent Builder zu erstellen
- ✅ Die Modellleistung bei verschiedenen Anbietern zu vergleichen
- ✅ Best Practices für Prompt Engineering anzuwenden
🧠 Einführung in das Microsoft Foundry Toolkit
Die Microsoft Foundry Toolkit Extension für VS Code ist Microsofts Flaggschiff-Erweiterung, die VS Code in eine umfassende KI-Entwicklungsumgebung verwandelt. Sie schlägt eine Brücke zwischen KI-Forschung und praktischer Anwendungsentwicklung und macht generative KI für Entwickler aller Erfahrungsstufen zugänglich.
🌟 Hauptfunktionen
| Funktion | Beschreibung | Anwendungsfall |
|---|---|---|
| 🗂️ Modellkatalog | Zugriff auf über 100 Modelle von GitHub, ONNX, OpenAI, Anthropic, Google | Modellentdeckung und -auswahl |
| 🔌 BYOM-Unterstützung | Integration eigener Modelle (lokal/remote) | Eigene Modellbereitstellung |
| 🎮 Interaktiver Playground | Echtzeit-Modelltests mit Chat-Oberfläche | Schnelles Prototyping und Testen |
| 📎 Multi-Modale Unterstützung | Verarbeitung von Text, Bildern und Anhängen | Komplexe KI-Anwendungen |
| ⚡ Stapelverarbeitung | Gleichzeitiges Ausführen mehrerer Prompts | Effiziente Testworkflows |
| 📊 Modellevaluation | Eingebaute Metriken (F1, Relevanz, Ähnlichkeit, Kohärenz) | Leistungsbewertung |
🎯 Warum das Microsoft Foundry Toolkit wichtig ist
- 🚀 Beschleunigte Entwicklung: Vom Konzept zum Prototyp in Minuten
- 🔄 Einheitlicher Workflow: Eine Schnittstelle für mehrere KI-Anbieter
- 🧪 Einfache Experimente: Modelle ohne komplexe Einrichtung vergleichen
- 📈 Produkttauglich: Nahtloser Übergang von Prototyp zu Einsatz
🛠️ Voraussetzungen & Einrichtung
📦 Microsoft Foundry Toolkit Extension installieren
Schritt 1: Zugang zum Erweiterungen-Marktplatz
- Öffnen Sie Visual Studio Code
- Navigieren Sie zur Erweiterungsansicht (
Ctrl+Shift+XoderCmd+Shift+X) - Suchen Sie nach "Microsoft Foundry Toolkit"
Schritt 2: Wählen Sie Ihre Version
- 🟢 Release: Empfohlen für produktiven Einsatz
- 🔶 Vorabversion: Frühzugang zu neuen Funktionen
Schritt 3: Installation und Aktivierung
✅ Prüfcheckliste
- Microsoft Foundry Toolkit-Symbol erscheint in der VS Code-Seitenleiste
- Erweiterung ist aktiviert und funktionsfähig
- Keine Installationsfehler im Ausgabefenster
🧪 Praktische Übung 1: GitHub-Modelle erkunden
🎯 Ziel: Den Modellkatalog meistern und Ihr erstes KI-Modell testen
📊 Schritt 1: Den Modellkatalog navigieren
Der Modellkatalog ist Ihr Tor zur KI-Ökosystem. Er aggregiert Modelle verschiedener Anbieter, wodurch das Entdecken und Vergleichen leicht fällt.
🔍 Navigationsanleitung:
Klicken Sie im Microsoft Foundry Toolkit in der Seitenleiste auf MODELS - Catalog
💡 Profi-Tipp: Suchen Sie nach Modellen mit bestimmten Fähigkeiten, die Ihren Anwendungsfall erfüllen (z.B. Code-Generierung, kreatives Schreiben, Analyse).
⚠️ Hinweis: GitHub-gehostete Modelle (d.h., GitHub-Modelle) sind kostenlos nutzbar, unterliegen jedoch Rate Limits bei Anfragen und Tokens. Für den Zugriff auf Nicht-GitHub-Modelle (also externe Modelle, die über Azure AI oder andere Endpunkte gehostet werden) benötigen Sie den entsprechenden API-Schlüssel oder Authentifizierung.
🚀 Schritt 2: Ihr erstes Modell hinzufügen und konfigurieren
Modellauswahlstrategie:
- GPT-4.1: Am besten für komplexes Denken und Analyse
- Phi-4-mini: Leichtgewichtig, schnelle Antworten für einfache Aufgaben
🔧 Konfigurationsprozess:
- Wählen Sie OpenAI GPT-4.1 aus dem Katalog
- Klicken Sie auf Zu meinen Modellen hinzufügen – dies registriert das Modell zur Nutzung
- Wählen Sie Im Playground testen zum Starten der Testumgebung
- Warten Sie auf die Modellinitialisierung (Erstsetup kann kurz dauern)
⚙️ Verständnis der Modellparameter:
- Temperature: Steuert die Kreativität (0 = deterministisch, 1 = kreativ)
- Max Tokens: Maximale Antwortlänge
- Top-p: Nucleus Sampling für Diversität der Antwort
🎯 Schritt 3: Die Playground-Benutzeroberfläche meistern
Der Playground ist Ihr Labor für KI-Experimente. So nutzen Sie ihn optimal:
🎨 Best Practices im Prompt Engineering:
- Seien Sie spezifisch: Klare, detaillierte Anweisungen liefern bessere Ergebnisse
- Kontext bereitstellen: Relevante Hintergrundinformationen einschließen
- Beispiele nutzen: Zeigen Sie dem Modell, was Sie wollen, mit Beispielen
- Iterieren: Prompts anhand erster Ergebnisse verfeinern
🧪 Test-Szenarien:
# Example 1: Code Generation
"Write a Python function that calculates the factorial of a number using recursion. Include error handling and docstrings."
# Example 2: Creative Writing
"Write a professional email to a client explaining a project delay, maintaining a positive tone while being transparent about challenges."
# Example 3: Data Analysis
"Analyze this sales data and provide insights: [paste your data]. Focus on trends, anomalies, and actionable recommendations."
🏆 Herausforderungsübung: Modellleistungsvergleich
🎯 Ziel: Verschiedene Modelle mit identischen Prompts vergleichen, um ihre Stärken zu verstehen
📋 Anleitung:
- Fügen Sie Phi-4-mini Ihrem Workspace hinzu
- Verwenden Sie denselben Prompt für GPT-4.1 und Phi-4-mini
- Vergleichen Sie Antwortqualität, Geschwindigkeit und Genauigkeit
- Dokumentieren Sie Ihre Ergebnisse im Ergebnisbereich
💡 Wichtige Erkenntnisse:
- Wann LLM vs. SLM einsetzen
- Kosten- und Leistungsabwägungen
- Spezialisierte Fähigkeiten verschiedener Modelle
🤖 Praktische Übung 2: Eigene Agenten mit dem Agent Builder erstellen
🎯 Ziel: Spezialisierte KI-Agenten für bestimmte Aufgaben und Workflows entwickeln
🏗️ Schritt 1: Agent Builder verstehen
Der Agent Builder ist die Kernstärke des Microsoft Foundry Toolkits. Er ermöglicht die Erstellung maßgeschneiderter KI-Assistenten, die die Leistung großer Sprachmodelle mit spezifischen Anweisungen, Parametern und Fachwissen kombinieren.
🧠 Komponenten der Agentenarchitektur:
- Core Model: Das Basis-LLM (GPT-4, Groks, Phi usw.)
- System-Prompt: Definiert Persönlichkeit und Verhalten des Agenten
- Parameter: Feinjustierung für optimale Leistung
- Werkzeugintegration: Anbindung an externe APIs und MCP-Dienste
- Speicher: Gesprächskontext und Sitzungsbeständigkeit
⚙️ Schritt 2: Gründliche Agentenkonfiguration
🎨 Effektive System-Prompts erstellen:
# Template Structure:
## Role Definition
You are a [specific role] with expertise in [domain].
## Capabilities
- List specific abilities
- Define scope of knowledge
- Clarify limitations
## Behavior Guidelines
- Response style (formal, casual, technical)
- Output format preferences
- Error handling approach
## Examples
Provide 2-3 examples of ideal interactions
Natürlich können Sie auch Generate System Prompt nutzen, um AI beim Erstellen und Optimieren von Prompts zu unterstützen
🔧 Parameteroptimierung:
| Parameter | Empfohlener Bereich | Anwendungsfall |
|---|---|---|
| Temperature | 0.1-0.3 | Technische/faktische Antworten |
| Temperature | 0.7-0.9 | Kreative/Brainstorming-Aufgaben |
| Max Tokens | 500-1000 | Knackige Antworten |
| Max Tokens | 2000-4000 | Ausführliche Erklärungen |
🐍 Schritt 3: Praxisübung – Python-Programmierungsagent
🎯 Mission: Einen spezialisierten Python-Coding-Assistenten erstellen
📋 Konfigurationsschritte:
-
Modellauswahl: Wählen Sie Claude 3.5 Sonnet (exzellent für Code)
-
System Prompt Design:
# Python Programming Expert Agent
## Role
You are a senior Python developer with 10+ years of experience. You excel at writing clean, efficient, and well-documented Python code.
## Capabilities
- Write production-ready Python code
- Debug complex issues
- Explain code concepts clearly
- Suggest best practices and optimizations
- Provide complete working examples
## Response Format
- Always include docstrings
- Add inline comments for complex logic
- Suggest testing approaches
- Mention relevant libraries when applicable
## Code Quality Standards
- Follow PEP 8 style guidelines
- Use type hints where appropriate
- Handle exceptions gracefully
- Write readable, maintainable code
- Parameter-Konfiguration:
- Temperature: 0.2 (für konsistenten, zuverlässigen Code)
- Max Tokens: 2000 (ausführliche Erklärungen)
- Top-p: 0.9 (ausgewogene Kreativität)
🧪 Schritt 4: Ihren Python-Agenten testen
Testszenarien:
- Basiskfunktion: "Erstelle eine Funktion zum Finden von Primzahlen"
- Komplexer Algorithmus: "Implementiere einen binären Suchbaum mit Einfügen, Löschen und Suchen"
- Praxisproblem: "Baue einen Web-Scraper, der Rate Limiting und Wiederholungen berücksichtigt"
- Fehlerbehebung: "Behebe diesen Code [buggy code einfügen]"
🏆 Erfolgskriterien:
- ✅ Code läuft fehlerfrei
- ✅ Enthält aussagekräftige Dokumentation
- ✅ Hält sich an Python Best Practices
- ✅ Bietet klare Erklärungen
- ✅ Schlägt Verbesserungen vor
🎓 Abschluss Modul 1 & nächste Schritte
📊 Wissenscheck
Testen Sie Ihr Verständnis:
- Können Sie den Unterschied zwischen Modellen im Katalog erklären?
- Haben Sie erfolgreich einen eigenen Agenten erstellt und getestet?
- Verstehen Sie, wie Parameter für verschiedene Anwendungsfälle optimiert werden?
- Können Sie effektive System-Prompts entwerfen?
📚 Zusätzliche Ressourcen
- Microsoft Foundry Toolkit Dokumentation: Offizielle Microsoft Docs
- Prompt Engineering Guide: Best Practices
- Modelle im Microsoft Foundry Toolkit: Modelle in Entwicklung
🎉 Herzlichen Glückwunsch! Sie haben die Grundlagen des Microsoft Foundry Toolkits gemeistert und sind bereit, fortgeschrittene KI-Anwendungen zu entwickeln!
🔜 Weiter zum nächsten Modul
Bereit für fortgeschrittene Funktionen? Fahren Sie fort zu Modul 2: MCP mit Microsoft Foundry Toolkit Grundlagen, wo Sie lernen, wie Sie:
- Ihre Agenten mit externen Tools über das Model Context Protocol (MCP) verbinden
- Browser-Automatisierungsagenten mit Playwright erstellen
- MCP-Server mit Ihren Microsoft Foundry Toolkit-Agenten integrieren
- Ihre Agenten mit externen Daten und Fähigkeiten aufladen
Haftungsausschluss: Dieses Dokument wurde mit dem KI-Übersetzungsdienst Co-op Translator übersetzt. Obwohl wir uns um Genauigkeit bemühen, beachten Sie bitte, dass automatisierte Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in seiner Ursprungssprache gilt als maßgebliche Quelle. Bei kritischen Informationen wird eine professionelle menschliche Übersetzung empfohlen. Wir übernehmen keine Haftung für Missverständnisse oder Fehlinterpretationen, die aus der Verwendung dieser Übersetzung entstehen.







