Jak wdrożyć agenta stworzonego w Copilot Studio na stronie internetowej i w Teams
Dowiedz się, jak krok po kroku wdrożyć agenta AI z Copilot Studio na stronie www i w Microsoft Teams, testować go i optymalizować. 🚀
Artykuł przeznaczony dla osób wdrażających agentów AI w organizacji, w tym twórców botów, administratorów Microsoft 365 oraz specjalistów IT i web developerów integrujących rozwiązanie ze stroną WWW lub Microsoft Teams.
Z tego artykułu dowiesz się
- Jak opublikować agenta AI w Copilot Studio i czym różni się wersja robocza od opublikowanej?
- Jak zintegrować opublikowanego agenta ze stroną internetową (iframe lub JavaScript SDK) oraz z Microsoft Teams (manifest aplikacji)?
- Jak testować, utrzymywać i rozwiązywać typowe problemy z agentem po wdrożeniu?
Wprowadzenie do Copilot Studio i możliwości agenta AI
Copilot Studio to platforma stworzona przez Microsoft, umożliwiająca projektowanie, trenowanie i wdrażanie konwersacyjnych agentów sztucznej inteligencji (AI), którzy automatyzują komunikację i wspierają użytkowników w różnorodnych kontekstach — od obsługi klienta, przez wsparcie pracowników, po integracje z procesami biznesowymi. Dzięki intuicyjnemu interfejsowi i integracji z ekosystemem Microsoft, Copilot Studio pozwala zarówno programistom, jak i osobom nietechnicznym na tworzenie zaawansowanych rozwiązań bez konieczności pisania skomplikowanego kodu.
Agent AI w Copilot Studio działa w oparciu o technologię przetwarzania języka naturalnego (NLP), co pozwala mu rozumieć intencje użytkownika i dostarczać trafne odpowiedzi lub podejmować odpowiednie akcje. Można go łatwo rozbudowywać o niestandardowe przepływy konwersacyjne, integracje z zewnętrznymi usługami oraz logikę biznesową, co czyni go elastycznym narzędziem do automatyzacji interakcji.
W praktyce agent AI może być wdrażany w różnych kanałach komunikacji, takich jak strony internetowe, aplikacje mobilne, Microsoft Teams czy inne platformy obsługujące Bot Framework. Dzięki temu możliwe jest dostarczanie spójnych doświadczeń użytkownikom niezależnie od środowiska, w którym się z nim komunikują.
Tworzenie agenta w Copilot Studio przebiega w kilku etapach: projektowania dialogów, definiowania tematów (topics), konfiguracji źródeł wiedzy, a następnie publikacji i integracji z wybranymi kanałami. Choć podstawowa konfiguracja nie wymaga umiejętności programowania, zaawansowani użytkownicy mogą korzystać z rozszerzeń i skryptów, aby dostosować agenta do bardziej złożonych potrzeb.
Copilot Studio to narzędzie, które demokratyzuje dostęp do technologii AI, umożliwiając organizacjom szybką i efektywną implementację inteligentnych agentów wspierających komunikację i automatyzację procesów.
Wymagania techniczne i przygotowanie środowiska
Przed rozpoczęciem procesu publikacji agenta AI stworzonego w Copilot Studio, warto upewnić się, że środowisko techniczne jest odpowiednio przygotowane. Niezależnie od miejsca docelowego wdrożenia – czy to strona internetowa, czy Microsoft Teams – spełnienie kilku podstawowych wymagań pozwoli na płynne przeprowadzenie całego procesu.
Wymagania dotyczące Copilot Studio:
- Aktywna subskrypcja Microsoft 365 z dostępem do Copilot Studio.
- Uprawnienia administratora lub twórcy agenta w organizacji, umożliwiające tworzenie, edycję i publikację botów.
- Dostęp do przeglądarki internetowej kompatybilnej z Copilot Studio (najlepiej Microsoft Edge lub Google Chrome).
Warunki integracji ze stroną internetową:
- Możliwość edycji kodu źródłowego strony (HTML/JavaScript), aby osadzić komponent agenta.
- Upewnienie się, że domena, na której znajdzie się agent, jest dodana do zaufanych w ustawieniach Copilot Studio.
- Środowisko testowe, na którym można przetestować wdrożenie przed publikacją na stronie produkcyjnej.
Warunki integracji z Microsoft Teams:
- Dostęp do Microsoft Teams w ramach tej samej organizacji co Copilot Studio.
- Uprawnienia do dodawania aplikacji niestandardowych w Teams (opcjonalnie poprzez App Studio lub centrum administracyjne Teams).
- Skonfigurowany i działający katalog aplikacji Teams dla organizacji.
Choć podstawowe wymagania techniczne są stosunkowo niskie, warto zadbać o ich spełnienie już na początku, aby uniknąć opóźnień podczas integracji. Dobrze przygotowane środowisko pozwala również sprawniej zarządzać agentem po jego wdrożeniu oraz szybciej reagować na ewentualne problemy.
Publikacja agenta AI w Copilot Studio
Po zakończeniu konfiguracji i przetestowaniu scenariuszy konwersacyjnych, kolejnym krokiem jest opublikowanie agenta AI w Copilot Studio. Publikacja umożliwia udostępnienie agenta innym użytkownikom oraz integrację z różnymi kanałami komunikacji – takimi jak strona internetowa czy Microsoft Teams.
Publikacja agenta w Copilot Studio jest procesem prostym, ale wymaga spełnienia kilku warunków, takich jak poprawna konfiguracja tematów (topics), dostępność przepływów (flows) oraz zatwierdzenie polityk prywatności i danych. Po spełnieniu tych wymagań, agent może zostać opublikowany jednym kliknięciem w interfejsie użytkownika.
Etapy publikacji agenta:
- Weryfikacja kompletności agenta – upewnij się, że wszystkie tematy są aktywne i przetestowane.
- Przejście do zakładki Publikuj w Copilot Studio.
- Rozpoczęcie procesu publikacji – agent zostaje opublikowany w wersji produkcyjnej.
Po pomyślnej publikacji, agent AI staje się dostępny do integracji z wybranymi kanałami. Należy jednak pamiętać, że:
- Publikacja nie oznacza automatycznej integracji – agent nadal wymaga osobnej konfiguracji, by działać na stronie internetowej lub w aplikacji Teams.
- Zmiany wprowadzone po publikacji wymagają ponownego opublikowania, aby były widoczne dla użytkowników końcowych.
Poniższa tabela przedstawia porównanie trybów agenta:
| Tryb | Opis | Zastosowanie |
|---|---|---|
| Roboczy (Draft) | Wersja robocza agenta, widoczna tylko dla twórców | Testowanie i rozwój |
| Opublikowany (Live) | Wersja dostępna dla użytkowników końcowych | Wdrożenie produkcyjne |
Przykładowy fragment kodu do identyfikacji agenta po publikacji:
{
"botId": "agent-12345-abcde",
"environment": "Production",
"status": "Published"
}
Publikacja jest kluczowym krokiem, który otwiera drogę do dalszej integracji agenta z praktycznymi kanałami kontaktu z użytkownikami końcowymi. Jeśli chcesz pogłębić swoją wiedzę i zdobyć praktyczne umiejętności, zapoznaj się z Kursem Tworzenie Agentów AI – automatyzacja procesów biznesowych dla AI Agent Developer.
Konfiguracja integracji ze stroną internetową
Po opublikowaniu agenta AI w Copilot Studio kolejnym krokiem jest jego integracja ze stroną internetową. Proces ten polega na osadzeniu wygenerowanego kodu agenta w wybranym miejscu witryny, tak aby użytkownicy mogli z niego korzystać bezpośrednio w przeglądarce. Dzięki temu agent AI może pełnić rolę interaktywnego asystenta, np. wspierając klientów w nawigacji po stronie, odpowiadając na pytania lub automatyzując procesy obsługi.
Istnieją dwie główne metody integracji agenta ze stroną internetową:
- Osadzenie za pomocą iframe: najprostsze rozwiązanie, wymagające jedynie wklejenia fragmentu kodu HTML wygenerowanego w Copilot Studio.
- Integracja z użyciem JavaScript SDK: bardziej zaawansowana metoda dająca większą kontrolę nad wyglądem, zachowaniem i funkcjonalnością agenta.
Poniższa tabela przedstawia podstawowe różnice między tymi podejściami:
| Metoda | Poziom trudności | Możliwości personalizacji | Rekomendowane zastosowanie |
|---|---|---|---|
| iframe | Niski | Ograniczone | Proste strony, szybkie wdrożenia |
| JavaScript SDK | Średni–wysoki | Zaawansowane | Portale firmowe, aplikacje webowe |
Przykład kodu iframe wygenerowanego w Copilot Studio może wyglądać następująco:
<iframe
src="https://copilotstudio.microsoft.com/embed/your-agent-id"
width="400"
height="600"
style="border:none;"
allow="microphone; camera"
></iframe>
W przypadku bardziej zaawansowanych zastosowań można połączyć funkcjonalność agenta z istniejącymi komponentami strony, np. dynamicznie wyświetlać bota po kliknięciu ikony czatu.
Integracja agenta AI ze stroną internetową stanowi istotny krok w kierunku zwiększenia interaktywności i dostępności usług. Wybór odpowiedniej metody zależy od potrzeb biznesowych, technologii użytej na stronie oraz poziomu kontroli nad interfejsem użytkownika.
Integracja agenta AI z Microsoft Teams
Microsoft Teams to jedno z kluczowych środowisk, w których agent stworzony w Copilot Studio może wspierać użytkowników w czasie rzeczywistym. Dzięki integracji z Teams, agent AI może odpowiadać na pytania, przekazywać informacje oraz automatyzować rutynowe zadania bezpośrednio w ramach konwersacji zespołowych.
Proces integracji agenta z Microsoft Teams opiera się na opublikowaniu go jako aplikacji Teams (manifest aplikacji), a następnie przypisaniu do odpowiednich kanałów, zespołów lub użytkowników. Dzięki temu agent może być dostępny zarówno w czatach prywatnych, jak i grupowych. Jeśli chcesz dowiedzieć się więcej o tworzeniu i wdrażaniu agentów AI w praktyce, sprawdź nasz Kurs Copilot – wykorzystanie sztucznej inteligencji do automatyzacji i optymalizacji procesów.
Główne zastosowania agenta w Teams
- Wsparcie pracowników: Odpowiedzi na typowe pytania HR, IT lub administracyjne.
- Automatyzacja procesów: Wykonywanie prostych zadań, jak zgłaszanie incydentów czy rezerwacja zasobów.
- Dostęp do danych: Szybkie dostarczanie informacji z systemów wewnętrznych firmy, np. CRM lub ERP.
Porównanie: Strona WWW vs Microsoft Teams
| Zastosowanie | Strona internetowa | Microsoft Teams |
|---|---|---|
| Dostępność | Dla odwiedzających stronę | Dla użytkowników Teams w organizacji |
| Typ interakcji | Obsługa klienta, FAQ | Wsparcie wewnętrzne, workflow |
| Integracja z innymi narzędziami | Formularze, CMS | Planner, SharePoint, Power Automate |
Przykład integracji
Po opublikowaniu agenta w Copilot Studio, można go dodać do Teams za pomocą manifestu aplikacji Teams. Poniżej uproszczony przykład fragmentu pliku manifest.json:
{
"manifestVersion": "1.12",
"version": "1.0.0",
"id": "{AGENT-ID}",
"packageName": "com.example.agent",
"name": {
"short": "Agent Copilot",
"full": "Agent Copilot AI dla Teams"
},
"description": {
"short": "Twój agent AI w Teams",
"full": "Agent stworzony w Copilot Studio, gotowy do działania w Microsoft Teams."
},
"bots": [
{
"botId": "{BOT-ID}",
"scopes": ["personal", "team"]
}
]
}
Integracja z Microsoft Teams otwiera nowe możliwości interakcji z agentem AI, szczególnie w środowiskach korporacyjnych, gdzie szybkość dostępu do informacji oraz automatyzacja mają kluczowe znaczenie. Aby jeszcze lepiej zrozumieć potencjał takich rozwiązań, warto rozważyć udział w naszym Kursie Copilot – wykorzystanie sztucznej inteligencji do automatyzacji i optymalizacji procesów.
Testowanie i weryfikacja działania agenta
Po skonfigurowaniu i opublikowaniu agenta w Copilot Studio, jednym z kluczowych kroków przed jego udostępnieniem użytkownikom końcowym jest dokładne przetestowanie jego działania. Testowanie ma na celu sprawdzenie, czy agent odpowiada zgodnie z intencją, poprawnie rozpoznaje zapytania użytkownika oraz działa stabilnie w różnych środowiskach — zarówno w przeglądarce internetowej, jak i w Microsoft Teams.
Rodzaje testów
- Testy funkcjonalne: sprawdzają, czy agent odpowiada poprawnie na zaprogramowane scenariusze konwersacji.
- Testy integracyjne: weryfikują, czy agent poprawnie działa w osadzonym środowisku (np. na stronie internetowej lub w Teams).
- Testy wydajnościowe: pozwalają ocenić, jak agent radzi sobie z większą liczbą zapytań jednocześnie.
Środowisko testowe
Copilot Studio udostępnia wbudowany panel testowy, który pozwala na szybkie sprawdzenie działania agenta bez konieczności jego publikacji. Dodatkowo, po wdrożeniu do kanału (np. strony www lub Teams), możliwe jest testowanie jego działania w rzeczywistym kontekście końcowego użytkownika.
Przykład testowania scenariusza konwersacji
// Przykład testu w JavaScript (dla strony www)
const userInput = "Jak mogę zresetować hasło?";
const expectedResponse = "Aby zresetować hasło, kliknij w link...";
chatbot.sendMessage(userInput).then(response => {
if (response.text.includes(expectedResponse)) {
console.log("Test zaliczony");
} else {
console.error("Odpowiedź niezgodna z oczekiwaniami");
}
});
Porównanie testowania na stronie i w Teams
| Aspekt | Strona internetowa | Microsoft Teams |
|---|---|---|
| UI konwersacji | Dostosowywany przez osadzony skrypt | Wbudowany interfejs Teams |
| Śledzenie błędów | Możliwe przez konsolę przeglądarki | Wymaga użycia narzędzi diagnostycznych Teams |
| Reakcje użytkowników | Testy z wybraną grupą na stronie testowej | Możliwość testowania w wybranych zespołach |
Regularne testowanie agenta w obu kanałach komunikacji pozwala na szybsze wychwycenie błędów, lepsze dopasowanie języka oraz identyfikację potencjalnych braków w scenariuszach konwersacji. Dzięki temu finalna wersja agenta będzie bardziej dopracowana i użyteczna dla końcowych użytkowników.
Najlepsze praktyki wdrażania i utrzymania agenta
Skuteczne wdrożenie agenta AI w Copilot Studio to nie tylko kwestia jego uruchomienia, ale również ciągłego monitorowania, dostosowywania i optymalizacji. Oto kluczowe praktyki, które pomogą zapewnić wysoką jakość działania agenta oraz jego przydatność dla użytkowników.
- Regularne aktualizacje treści i danych: Agent powinien być na bieżąco z najnowszymi informacjami dotyczącymi organizacji, produktów czy usług. Zapewnienie aktualnych źródeł wiedzy pozwala zwiększyć trafność odpowiedzi.
- Monitorowanie interakcji użytkowników: Analiza transkryptów rozmów i metryk takich jak liczba zakończonych konwersacji, pytania bez odpowiedzi czy poziom satysfakcji użytkowników pozwala wykryć obszary do poprawy.
- Dostosowanie języka i tonu wypowiedzi: Styl komunikacji agenta powinien odpowiadać kulturze organizacyjnej i oczekiwaniom grupy docelowej – może być formalny lub bardziej swobodny, w zależności od kontekstu.
- Definiowanie jasnych celów agenta: Użytkownicy powinni rozumieć, w czym agent może im pomóc. Należy unikać wprowadzania w błąd co do jego możliwości.
- Implementacja mechanizmu przekierowania: W sytuacjach, gdy agent nie potrafi odpowiedzieć na pytanie, powinien przekazać użytkownika do konsultanta lub wskazać inne źródła pomocy.
- Bezpieczeństwo i prywatność danych: Należy zadbać, aby agent nie przechowywał poufnych informacji oraz by komunikacja była zgodna z zasadami RODO i standardami bezpieczeństwa.
- Szkolenie zespołu odpowiedzialnego za agenta: Osoby zarządzające agentem powinny znać jego architekturę, możliwości, a także potrafić reagować na zgłaszane problemy i potrzeby rozwoju.
Wdrożenie agenta to proces iteracyjny – wymaga testowania, uczenia się na podstawie danych oraz stałego doskonalenia. Trzymając się powyższych praktyk, można zapewnić, że agent będzie skutecznie wspierał użytkowników zarówno na stronie internetowej, jak i w środowisku Microsoft Teams.
Rozwiązywanie typowych problemów i wsparcie techniczne
Podczas wdrażania i korzystania z agenta stworzonego w Copilot Studio, mogą wystąpić różne problemy techniczne lub użytkowe. Poniżej przedstawiamy najczęstsze z nich oraz sposoby ich identyfikacji i rozwiązania.
- Agent nie wyświetla się na stronie internetowej – Upewnij się, że kod osadzenia został poprawnie dodany do kodu HTML strony. Sprawdź, czy domena strony została autoryzowana w ustawieniach agenta w Copilot Studio.
- Agent nie działa w Microsoft Teams – Sprawdź, czy użytkownik ma uprawnienia do interakcji z aplikacjami firmowymi oraz czy agent został poprawnie opublikowany i udostępniony w katalogu aplikacji Teams.
- Puste odpowiedzi lub błędy w konwersacji – Możliwe, że wystąpił problem z połączeniem do źródła wiedzy lub bota nie rozpoznaje intencji użytkownika. Warto przetestować scenariusze dialogowe w Copilot Studio i przeanalizować logi konwersacji.
- Zbyt wolne działanie agenta – Może to wynikać z przeciążenia usług lub błędnej konfiguracji po stronie klienta. Sprawdź połączenie sieciowe, a także czy inne aplikacje korzystają z zasobów przeglądarki.
- Problemy z publikacją agenta – Jeśli publikacja kończy się błędem, sprawdź, czy wszystkie wymagane komponenty (np. tematy konwersacyjne) są aktywne i poprawne. Warto również przejrzeć ustawienia uprawnień użytkowników w Copilot Studio.
W razie trudności, które nie zostały opisane powyżej, warto skorzystać z zasobów Microsoft Learn, oficjalnej dokumentacji Copilot Studio lub skontaktować się z pomocą techniczną Microsoft poprzez portal Admin Center.