wehub-resource-sync🌐 Moduł 2: MCP z fundamentami Microsoft Foundry Toolkit
📋 Cele nauki
Po ukończeniu tego modułu będziesz potrafił:
- ✅ Zrozumieć architekturę i korzyści Model Context Protocol (MCP)
- ✅ Poznać ekosystem serwerów MCP Microsoft
- ✅ Zintegrować serwery MCP z Microsoft Foundry Toolkit Agent Builder
- ✅ Zbudować funkcjonalnego agenta automatyzacji przeglądarki używając Playwright MCP
- ✅ Skonfigurować i przetestować narzędzia MCP w swoich agentach
- ✅ Eksportować i wdrażać agentów napędzanych MCP do użytku produkcyjnego
🎯 Kontynuacja z Modułu 1
W Moduł 1 opanowaliśmy podstawy Microsoft Foundry Toolkit i stworzyliśmy naszego pierwszego agenta w Pythonie. Teraz wzmocnimy Twoich agentów, łącząc ich z zewnętrznymi narzędziami i usługami przez rewolucyjny Model Context Protocol (MCP).
Pomyśl o tym jak o modernizacji z prostego kalkulatora do pełnoprawnego komputera – Twoje AI-agenty zyskają możliwość:
- 🌐 Przeglądania i interakcji ze stronami internetowymi
- 📁 Dostępu i manipulacji plikami
- 🔧 Integracji z systemami korporacyjnymi
- 📊 Przetwarzania danych w czasie rzeczywistym z API
🧠 Zrozumienie Model Context Protocol (MCP)
🔍 Czym jest MCP?
Model Context Protocol (MCP) to „USB-C dla aplikacji AI” – rewolucyjny, otwarty standard łączący Duże Modele Językowe (LLM) z zewnętrznymi narzędziami, źródłami danych i usługami. Tak jak USB-C wyeliminowało chaos kabli poprzez jeden uniwersalny złącze, MCP likwiduje złożoność integracji AI jednym ustandaryzowanym protokołem.
🎯 Problem rozwiązany przez MCP
Przed MCP:
- 🔧 Dedykowane integracje dla każdego narzędzia
- 🔄 Zamknięcie w dostawcy przez rozwiązania własnościowe
- 🔒 Luki bezpieczeństwa wynikające z ad-hoc połączeń
- ⏱️ Miesiące pracy nad prostymi integracjami
Z MCP:
- ⚡ Integracja narzędzi typu plug-and-play
- 🔄 Architektura niezależna od dostawcy
- 🛡️ Wbudowane najlepsze praktyki bezpieczeństwa
- 🚀 Minuty na dodanie nowych funkcji
🏗️ Dogłębna architektura MCP
MCP opiera się na architekturze klient-serwer, tworząc bezpieczny i skalowalny ekosystem:
graph TB
A[Aplikacja/Agent SI] --> B[Klient MCP]
B --> C[Serwer MCP 1: Pliki]
B --> D[Serwer MCP 2: API sieciowe]
B --> E[Serwer MCP 3: Baza danych]
B --> F[Serwer MCP N: Narzędzia niestandardowe]
C --> G[Lokalny system plików]
D --> H[Zewnętrzne API]
E --> I[Systemy baz danych]
F --> J[Systemy korporacyjne]
🔧 Podstawowe komponenty:
| Komponent | Rola | Przykłady |
|---|---|---|
| Hosty MCP | Aplikacje konsumujące usługi MCP | Claude Desktop, VS Code, Microsoft Foundry Toolkit |
| Klienci MCP | Obsługa protokołu (1:1 z serwerami) | Wbudowane w aplikacje hostów |
| Serwery MCP | Udostępniają funkcje przez standardowy protokół | Playwright, Files, Azure, GitHub |
| Warstwa transportowa | Metody komunikacji | stdio, HTTP, WebSockets |
🏢 Ekosystem serwerów MCP Microsoft
Microsoft przewodzi ekosystemowi MCP oferując kompleksowy zestaw serwerów klasy enterprise odpowiadających na rzeczywiste potrzeby biznesowe.
🌟 Polecane serwery MCP Microsoft
1. ☁️ Serwer MCP Azure
🔗 Repozytorium: azure/azure-mcp 🎯 Cel: Kompleksowe zarządzanie zasobami Azure z integracją AI
✨ Kluczowe funkcje:
- Deklaratywne zarządzanie infrastrukturą
- Monitorowanie zasobów w czasie rzeczywistym
- Rekomendacje optymalizacji kosztów
- Kontrola zgodności z bezpieczeństwem
🚀 Scenariusze użycia:
- Infrastruktura jako kod z pomocą AI
- Automatyczne skalowanie zasobów
- Optymalizacja kosztów chmury
- Automatyzacja workflow DevOps
2. 📊 Microsoft Dataverse MCP
📚 Dokumentacja: Microsoft Dataverse Integration 🎯 Cel: Interfejs w naturalnym języku do danych biznesowych
✨ Kluczowe funkcje:
- Zapytania do baz danych w języku naturalnym
- Rozumienie kontekstu biznesowego
- Własne szablony promptów
- Zarządzanie danymi korporacyjnymi
🚀 Scenariusze użycia:
- Raportowanie BI
- Analiza danych klientów
- Wgląd w proces sprzedaży
- Zapytania dotyczące zgodności
3. 🌐 Serwer MCP Playwright
🔗 Repozytorium: microsoft/playwright-mcp 🎯 Cel: Automatyzacja przeglądarki i interakcja ze stronami www
✨ Kluczowe funkcje:
- Automatyzacja międzyprzeglądarkowa (Chrome, Firefox, Safari)
- Inteligentne wykrywanie elementów
- Generowanie zrzutów ekranu i PDF
- Monitorowanie ruchu sieciowego
🚀 Scenariusze użycia:
- Automatyczne testy
- Web scraping i ekstrakcja danych
- Monitorowanie UI/UX
- Automatyzacja analizy konkurencji
4. 📁 Serwer MCP Files
🔗 Repozytorium: microsoft/files-mcp-server 🎯 Cel: Inteligentne operacje na systemie plików
✨ Kluczowe funkcje:
- Deklaratywne zarządzanie plikami
- Synchronizacja zawartości
- Integracja z kontrolą wersji
- Ekstrakcja metadanych
🚀 Scenariusze użycia:
- Zarządzanie dokumentacją
- Organizacja repozytoriów kodu
- Workflow publikacji treści
- Obsługa plików w pipeline danych
5. 📝 Serwer MCP MarkItDown
🔗 Repozytorium: microsoft/markitdown 🎯 Cel: Zaawansowane przetwarzanie i manipulacja Markdown
✨ Kluczowe funkcje:
- Zaawansowane parsowanie Markdown
- Konwersja formatów (MD ↔ HTML ↔ PDF)
- Analiza struktury treści
- Przetwarzanie szablonów
🚀 Scenariusze użycia:
- Workflow dokumentacji technicznej
- Systemy zarządzania treścią
- Generowanie raportów
- Automatyzacja baz wiedzy
6. 📈 Serwer MCP Clarity
📦 Pakiet: @microsoft/clarity-mcp-server 🎯 Cel: Analityka webowa i wgląd w zachowania użytkowników
✨ Kluczowe funkcje:
- Analiza danych heatmap
- Nagrania sesji użytkowników
- Metryki wydajności
- Analiza lejków konwersji
🚀 Scenariusze użycia:
- Optymalizacja stron www
- Badania UX
- Analiza testów A/B
- Dashboardy BI
🌍 Ekosystem społecznościowy
Poza serwerami Microsoft, ekosystem MCP obejmuje:
- 🐙 GitHub MCP: zarządzanie repozytoriami i analiza kodu
- 🗄️ MCP bazy danych: integracje z PostgreSQL, MySQL, MongoDB
- ☁️ MCP dostawców chmurowych: AWS, GCP, Digital Ocean
- 📧 MCP komunikacji: integracje Slack, Teams, Email
🛠️ Praktyczne laboratorium: Budowa agenta automatyzacji przeglądarki
🎯 Cel projektu: Stworzyć inteligentnego agenta automatyzacji przeglądarki z użyciem serwera Playwright MCP, który będzie mógł przeglądać strony, wyciągać informacje i wykonywać złożone interakcje internetowe.
🚀 Faza 1: Ustawienie podstaw agenta
Krok 1: Inicjalizacja agenta
- Otwórz Microsoft Foundry Toolkit Agent Builder
- Utwórz nowego agenta z następującą konfiguracją:
- Nazwa:
BrowserAgent - Model: Wybierz GPT-4o
- Nazwa:
🔧 Faza 2: Workflow integracji MCP
Krok 3: Dodaj integrację serwera MCP
- Przejdź do sekcji Narzędzia w Agent Builder
- Kliknij "Dodaj narzędzie", aby otworzyć menu integracji
- Wybierz "Serwer MCP" z dostępnych opcji
🔍 Zrozumienie typów narzędzi:
- Narzędzia wbudowane: wstępnie skonfigurowane funkcje Microsoft Foundry Toolkit
- Serwery MCP: integracje z usługami zewnętrznymi
- API niestandardowe: Twoje własne punkty końcowe usług
- Wywołania funkcji: bezpośredni dostęp do funkcji modelu
Krok 4: Wybór serwera MCP
-
Wybierz opcję "Serwer MCP" by kontynuować
-
Przeglądaj katalog MCP aby odkryć dostępne integracje
🎮 Faza 3: Konfiguracja Playwright MCP
Krok 5: Wybierz i skonfiguruj Playwright
- Kliknij "Użyj polecanych serwerów MCP" by uzyskać dostęp do zweryfikowanych serwerów Microsoft
- Wybierz "Playwright" z listy polecanych
- Zaakceptuj domyślne ID MCP lub dostosuj do swojego środowiska
Krok 6: Włącz funkcje Playwright
🔑 Krok krytyczny: Wybierz WSZYSTKIE dostępne metody Playwright dla maksymalnej funkcjonalności
🛠️ Nieodzowne narzędzia Playwright:
- Nawigacja:
goto,goBack,goForward,reload - Interakcja:
click,fill,press,hover,drag - Ekstrakcja:
textContent,innerHTML,getAttribute - Walidacja:
isVisible,isEnabled,waitForSelector - Zrzut:
screenshot,pdf,video - Sieć:
setExtraHTTPHeaders,route,waitForResponse
Krok 7: Zweryfikuj pomyślność integracji
✅ Wskaźniki powodzenia:
- Wszystkie narzędzia widoczne w interfejsie Agent Builder
- Brak komunikatów o błędach w panelu integracji
- Status serwera Playwright pokazuje "Connected"
🔧 Rozwiązywanie typowych problemów:
- Błąd połączenia: Sprawdź dostęp do internetu i ustawienia zapory
- Brak narzędzi: Upewnij się, że wszystkie funkcje zostały wybrane podczas konfiguracji
- Błędy uprawnień: Zweryfikuj, czy VS Code ma niezbędne uprawnienia systemowe
🎯 Faza 4: Zaawansowana inżynieria promptów
Krok 8: Projektuj inteligentne prompty systemowe
Stwórz zaawansowane prompt’y wykorzystujące pełne możliwości Playwright:
# Web Automation Expert System Prompt
## Core Identity
You are an advanced web automation specialist with deep expertise in browser automation, web scraping, and user experience analysis. You have access to Playwright tools for comprehensive browser control.
## Capabilities & Approach
### Navigation Strategy
- Always start with screenshots to understand page layout
- Use semantic selectors (text content, labels) when possible
- Implement wait strategies for dynamic content
- Handle single-page applications (SPAs) effectively
### Error Handling
- Retry failed operations with exponential backoff
- Provide clear error descriptions and solutions
- Suggest alternative approaches when primary methods fail
- Always capture diagnostic screenshots on errors
### Data Extraction
- Extract structured data in JSON format when possible
- Provide confidence scores for extracted information
- Validate data completeness and accuracy
- Handle pagination and infinite scroll scenarios
### Reporting
- Include step-by-step execution logs
- Provide before/after screenshots for verification
- Suggest optimizations and alternative approaches
- Document any limitations or edge cases encountered
## Ethical Guidelines
- Respect robots.txt and rate limiting
- Avoid overloading target servers
- Only extract publicly available information
- Follow website terms of service
Krok 9: Twórz dynamiczne prompty dla użytkownika
Projektuj prompt’y pokazujące różnorodne możliwości:
🌐 Przykład analizy stron:
Navigate to github.com/kinfey and provide a comprehensive analysis including:
1. Repository structure and organization
2. Recent activity and contribution patterns
3. Documentation quality assessment
4. Technology stack identification
5. Community engagement metrics
6. Notable projects and their purposes
Include screenshots at key steps and provide actionable insights.
🚀 Faza 5: Wykonanie i testowanie
Krok 10: Uruchom pierwszą automatyzację
- Kliknij "Run" aby rozpocząć sekwencję automatyzacji
- Monitoruj wykonanie na żywo:
- Uruchamia się przeglądarka Chrome
- Agent przechodzi do docelowej strony
- Zrzuty ekranu dokumentują każdy ważny krok
- Wyniki analizy przesyłane są w czasie rzeczywistym
Krok 11: Analizuj wyniki i wnioski
Przejrzyj pełną analizę w interfejsie Agent Builder:
🌟 Faza 6: Zaawansowane funkcje i wdrożenie
Krok 12: Eksport i wdrożenie produkcyjne
Agent Builder wspiera różne opcje wdrożenia:
🎓 Podsumowanie Modułu 2 i kolejne kroki
🏆 Osiągnięcie odblokowane: Mistrz Integracji MCP
✅ Opanowane umiejętności:
- Zrozumienie architektury i korzyści MCP
- Nawigowanie w ekosystemie serwerów MCP Microsoft
- Integracja Playwright MCP z Microsoft Foundry Toolkit
- Budowa zaawansowanych agentów automatyzacji przeglądarki
- Zaawansowana inżynieria promptów do automatyzacji webowej
📚 Dodatkowe materiały
- 🔗 Specyfikacja MCP: Oficjalna dokumentacja protokołu
- 🛠️ API Playwright: Pełna referencja metod
- 🏢 Serwery MCP Microsoft: Przewodnik integracji enterprise
- 🌍 Przykłady społeczności: Galeria serwerów MCP
🎉 Gratulacje! Udało Ci się opanować integrację MCP i możesz teraz budować agentów AI gotowych do produkcji z zewnętrznymi narzędziami!
🔜 Kontynuuj do następnego modułu
Gotowy na rozwinięcie umiejętności MCP? Przejdź do Moduł 3: Zaawansowany rozwój MCP z Microsoft Foundry Toolkit, gdzie nauczysz się:
- Tworzyć własne niestandardowe serwery MCP
- Konfigurować i używać najnowszego MCP Python SDK
- Ustawiać MCP Inspector do debugowania
- Opanować zaawansowane workflow rozwoju serwerów MCP
- Budować serwer MCP Weather od podstaw
Zastrzeżenie: Niniejszy dokument został przetłumaczony za pomocą usługi tłumaczenia AI Co-op Translator. Choć dążymy do dokładności, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub niedokładności. Oryginalny dokument w jego języku źródłowym należy uznawać za autorytatywne źródło. W przypadku informacji krytycznych zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia.