Udostępnij przez

Szybki start: konfigurowanie i uruchamianie przykładowego agenta platformy Python Agent

W tym przewodniku Szybki start przedstawiono konfigurowanie działającego agenta platformy agenta języka Python przy użyciu agenta 365 na potrzeby narzędzi, powiadomień, możliwości obserwowania i testowania agenta przy użyciu narzędzi i aplikacji Teams agentów.

Wymagania wstępne

  • Jeśli planujesz używać programu Visual Studio Code, musisz mieć zainstalowaną platformę .NET. Zalecany jest protokół TLS 1.2.

  • Zainstalowano środowisko Python 3.11 lub nowsze

  • Zainstalowany menedżer pakietów UV. Zainstaluj to w terminalu przy użyciu polecenia pip install uv.

  • Microsoft Agents Toolkit /Agent Framework dependencies

    Przykład używany w przewodniku opiera się na bibliotekach platformy Agent Framework udostępnianych za pośrednictwem zestawu narzędzi Microsoft 365 Agents Toolkit lub ATK. Te elementy zostaną automatycznie zainstalowane podczas tworzenia szkieletu przykładu za pomocą rozszerzenia Agents Toolkit w programie VS Code lub ręcznego zainstalowania pakietu przy użyciu tego polecenia:

    uv pip install -e . --find-links ../dist --pre

  • Dostęp do usługi GitHub

  • Istniejący projekt agenta sztucznej inteligencji. W tym przewodniku Szybki start używany jest przykładowy agent agenta 365 z zestawu narzędzi agenta platformy Microsoft 365 nazywanym również kluczem ATK w programie VS Code.

  • Interfejs wiersza polecenia usługi A365

  • Uwierzytelnianie tożsamości agenta

Konfigurowanie przykładu Platformy agentów i języka Python z zestawu narzędzi Microsoft 365 Agents Toolkit

Aby przygotować wszystko, zainstalujesz zestaw narzędzi Microsoft 365 Agents Toolkit w programie VS Code, otwórz przykładową galerię i utwórz szkielet przykładowej platformy agentów i języka Python lokalnie, aby można było skonfigurować i uruchomić go później. Na poniższych zrzutach ekranu pokazano, czego można oczekiwać, gdy przejdziesz dalej.

  1. Otwórz program Visual Studio Code, a następnie otwórz panel Rozszerzenia Ctrl+Shift+X.

  2. Na pasku wyszukiwania wpisz "Agents Toolkit".
    Wynik powinien zostać wyświetlony na zrzucie ekranu tutaj:

    Zrzut ekranu przedstawiający wyszukiwanie w witrynie Marketplace rozszerzeń dla zestawu narzędzi agentów.

  3. Zestaw narzędzi Microsoft 365 Agents Toolkit

  4. Wybierz Zainstaluj.

    Program VS Code wyświetla widok szczegółów rozszerzenia podobny do:

    Zrzut ekranu przedstawiający stronę Szczegóły rozszerzenia z przyciskami Zainstaluj i Włącz.

  5. Po zainstalowaniu ikona zestawu narzędzi M365 Agents Toolkit zostanie wyświetlona na lewym pasku nawigacyjnym.

  6. Wybierz go, aby otworzyć środowisko powitalne.

    Powinny być teraz widoczne opcje, takie jak Tworzenie agenta deklaratywnego, Tworzenie nowego agenta/aplikacji i Wyświetlanie przykładów, jak pokazano poniżej:

    Zrzut ekranu przedstawiający widok powitalny zestawu narzędzi z opcją tworzenia agenta deklaratywnego, tworzenia nowego agenta lub aplikacji oraz opcji Wyświetl przykłady.

  7. Wybierz pozycję Wyświetl przykłady.

  8. Na liście przykładów przewiń stronę, aby znaleźć przykładową strukturę agenta i agenta języka Python .

  9. Wybierz je.

    Zobaczysz dwie opcje: Utwórz (szkielet lokalnie) lub Wyświetl w witrynie GitHub.

  10. Wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający agenta platformy Agent z zestawem A365 SDK korzystającym z przykładu języka Python.

  11. Po wyświetleniu monitu wybierz folder na komputerze, na którym ma zostać wygenerowany przykład. Na przykład: C:\A365-python-sample.

    Zestaw narzędzi tworzy szkielet struktury agenta i języka Python w podfolderze (takim jak sample_agent), a następnie otwiera go automatycznie w programie VS Code.

    Po zakończeniu tworzenia szkieletu masz teraz w pełni funkcjonalną strukturę agentów i projekt agenta języka Python na maszynie

  12. Instalowanie wymaganych pakietów agenta 365

    Przed uruchomieniem przykładu otwórz plik package.json w projekcie i upewnij się, że są wyświetlane wszystkie wymagane zależności platformy Agent 365 i Agent. Przykład wygenerowany przez zestaw narzędzi Microsoft 365 Agents Toolkit zawiera już te wpisy.

    Po przejrzeniu package.json zainstaluj wszystko, uruchamiając następujące polecenie:

    uv pip install -e

    Spowoduje to ściągnięcie wszystkich bibliotek zestawu SDK agenta 365, zależności platformy agentów, składników hostingu i wszystkich innych zależności zdefiniowanych w przykładzie.

  13. Po zakończeniu instalacji zweryfikuj kompilowanie i uruchamianie projektu, uruchamiając serwer deweloperski przy użyciu następującego polecenia:

    uv run python start_with_generic_host.py

Dodawanie narzędzi platformy Microsoft 365 (serwery MCP)

Serwery MCP można eksplorować i zarządzać nimi przy użyciu poleceń programowania a365 w interfejsie wiersza polecenia.

Podczas pracy z serwerami MCP można wykonywać następujące czynności:

  • Odkryj, które serwery MCP są dostępne do użycia
  • Dodawanie co najmniej jednego serwera MCP do konfiguracji agenta
  • Przejrzyj aktualnie skonfigurowane serwery MCP
  • Usuwanie serwerów MCP, których już nie potrzebujesz

Po dodaniu serwerów MCP manifest narzędzi agenta rozszerza się w celu uwzględnienia wpisów podobnych do następujących:

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

Dowiedz się, jak dodawać narzędzia i zarządzać nimi

Subskrypcja powiadomień i obsługa

Przykładowy agent subskrybuje wszystkie powiadomienia zestawu SDK agenta 365 przy użyciu polecenia onAgentNotification("*") i kieruje je do pojedynczej procedury obsługi. Ta procedura obsługi umożliwia agentowi reagowanie na zdarzenia w tle lub systemie, a nie tylko bezpośrednie komunikaty użytkowników.

Dowiedz się, jak powiadamiać agentów

Poniższy kod przedstawia sposób konfigurowania agent.py powiadomień w pliku.

if notification_type == NotificationTypes.EMAIL_NOTIFICATION: 
if not hasattr(notification_activity, "email") or not notification_activity.email: return "I could not find the email notification details."
email = notification_activity.email
email_body = getattr(email, "html_body", "") or getattr(email, "body", "")

message = (
    "You have received the following email. "
    "Please follow any instructions in it. "
    f"{email_body}"
)

result = await self.agent.run(message)
return self._extract_result(result) or "Email notification processed."

Wgląd

Ten fragment kodu przedstawia minimalne zmiany wymagane do umożliwienia obserwowania w przykładzie. Inicjuje zestaw SDK obserwacji agenta 365 i opakowuje każde wywołanie agenta w InferenceScope taki sposób, aby dane wejściowe, wyjściowe i metadane mogły być przechwytywane automatycznie.

Poniższy kod przedstawia usprawniony przykład obserwacji w agent.py pliku.

def _enable_agentframework_instrumentation(self): 
"""Enable Agent Framework instrumentation.""" 
try: 
AgentFrameworkInstrumentor().instrument() 
logger.info("✅ Instrumentation enabled")
 except Exception as e: 
logger.warning(f"⚠️ Instrumentation failed: {e}")

Ten kod jest pełną konfiguracją obserwacji wymaganą dla przykładu platformy Python + Agent. Dowiedz się więcej o możliwościach obserwacji

Przetestuj swojego agenta

Ustaw wymagane zmienne środowiskowe, wybierz tryb uwierzytelniania i uruchom agenta lokalnie. Możesz przetestować wszystko, co kompleksowe z narzędziem Agents Playground bez konieczności posiadania dzierżawy platformy Microsoft 365, chyba że chcesz opublikować agenta i używać go w aplikacjach, takich jak Teams lub Outlook.

Omówienie kroków testowania

  • Dodaj klucze interfejsu .env API i ustawienia modelu do pliku, aby przykład mógł komunikować się z usługą LLM.
  • Wybierz tryb uwierzytelniania. W przypadku programowania lokalnego przykład obsługuje uwierzytelnianie agentów przy użyciu wartości utworzonych na podstawie strategii agenta.
  • Uruchom agenta lokalnie, co uwidacznia go narzędziom, takich jak Plac zabaw agentów.
  • Używanie narzędzia Agents Playground do testowania komunikatów, narzędzi i powiadomień bez konfigurowania dzierżawy lub wdrażania niczego.
  • Gdy wszystko będzie gotowe do rzeczywistego zachowania, opublikuj dzierżawę platformy Microsoft 365 i przetestuj agenta w aplikacji Teams, Outlook lub innych powierzchniach platformy Microsoft 365.

Dowiedz się więcej o testowaniu

Opublikuj agenta

Gdy agent jest gotowy do rzeczywistych środowisk platformy Microsoft 365, takich jak czaty usługi Teams, wiadomości programu Outlook, Word @mentions, publikujesz go w dzierżawie platformy Microsoft 365. Polecenie interfejsu wiersza polecenia publish agenta 365 obsługuje pakowanie: aktualizuje manifest, pakuje wszystko i przekazuje agenta do Centrum administracyjnego firmy Microsoft.

Podczas publikowania przejrzyj i dostosuj nazwę, opis, ikony i wersję agenta przed ukończeniem przekazywania. Po opublikowaniu agent staje się wykrywalny i instalowany w dzierżawie.

Opublikowanych agentów można wyświetlić tutaj: https://admin.cloud.microsoft/#/agents/all

Dowiedz się więcej na temat pełnego przepływu pracy i instrukcji krok po kroku

  • Last updated on