Przejdź do treści

Drupal AI Agents

Streszczenie Transkrypcji "Wprowadzenie do Agentów AI i Swarm w Drupal AI Module 1.1"

Prezentacja dotyczy nowej struktury i frameworku dla agentów AI w module Drupal AI 1.1. Celem zmian jest ułatwienie użytkownikom tworzenia własnych agentów i ich efektywnej współpracy, a także lepsza integracja z istniejącym ekosystemem Drupal.

Teoria Agentów AI:

  • Agenci vs. Proste Zapytania AI: Agenci AI są bardziej zaawansowani niż proste zapytania (prompty) do modeli językowych. Oprócz instrukcji (system prompt), posiadają narzędzia, które pozwalają im wykonywać czynności wykraczające poza generowanie tekstu. Mogą one działać na stronie Drupal, np. tworzyć pola, wyszukiwać informacje, edytować treści.
  • Swarm (Rój Agentów): Zamiast jednego superinteligentnego agenta, koncepcja swarmu zakłada użycie zespołu mniejszych agentów, z których każdy ma specyficzne umiejętności. Współpracując, mogą osiągać bardziej złożone zadania. Przykłady swarmu to triage, zarządzanie projektami, przekazywanie zadań między agentami.
  • Składniki Agenta:
    • Instrukcje (System Prompt): Określają rolę i zadania agenta.
    • Narzędzia: Umożliwiają agentowi interakcję z Drupalem i zewnętrznymi źródłami danych.
    • Historia/Pamięć: Pozwala agentowi śledzić kontekst rozmowy i zapamiętywać istotne informacje.
  • Typy Narzędzi:
    • Akcje/Manipulacja: Narzędzia do edycji treści, konfiguracji strony, wykonywania akcji w Drupalu.
    • Informacja/Wyszukiwanie: Narzędzia do wyszukiwania informacji w sieci, na stronie Drupal, pobierania konfiguracji.
    • Przekazywanie (Handover): Narzędzie umożliwiające agentowi użycie innego agenta jako podnarzędzia, tworząc łańcuch lub swarm agentów.
  • Ewolucja Agentów w Drupal AI:
    • Drupal AI 1.0 (Orchestrator LLM): Architektura oparta na orkiestratorze LLM, który rozdziela zadania na wiele wywołań LLM, a na końcu syntetyzator (asystent) podsumowuje wyniki. Działa sekwencyjnie.
    • Drupal AI 1.1 (Prawdziwi Agenci): Agenci podejmują decyzje o kolejnych krokach, mogą mieć ewaluatora i iteracyjnie dążyć do rozwiązania zadania.

Nowości w Drupal AI Module 1.1:

  • Interfejs UI do Zarządzania Agentami: Nowy interfejs użytkownika w Drupalu pozwala na tworzenie i konfigurację agentów bez pisania kodu (lub z minimalną ilością kodu).
  • Ujednolicony System Narzędzi: Strukturyzowany system narzędzi oparty na akcjach Drupal Core oraz integracja z modułem ECA (Event, Condition, Action). Dostęp do setek narzędzi.
  • No-Code/Low-Code Tworzenie Agentów: Ułatwienie tworzenia agentów dla użytkowników nietechnicznych, ale także wsparcie dla programistów.
  • Rola UX w Prompt Engineering: Ważność etykiet i opisów agentów w UI, ponieważ są one wykorzystywane przez LLM do zrozumienia i komunikacji między agentami.
  • Role i Uprawnienia Agentów (planowane): Możliwość przypisywania ról Drupal do agentów, co pozwoli na kontrolę ich uprawnień.
  • Ulepszone Logowanie: Logi agentów są teraz podsumowywane przez AI, co ułatwia ich zrozumienie i analizę. UI do przeglądania logów, wyświetlający podsumowanie akcji, historię rozmowy, prompt, użyte narzędzia, logi agentów potomnych.

Przykłady Agentów i ich Wykorzystanie:

  1. Agent Publikujący/Wycofujący z Publikacji:
    • Zadanie: Publikuje lub wycofuje z publikacji treść (node) na podstawie podanego ID.
    • Narzędzia: Narzędzia Drupal Core do publikowania i wycofywania treści.
    • System Prompt (przykład): "Jesteś agentem specjalizującym się w publikowaniu i wycofywaniu treści. Jeśli nie podano ID encji, poinformuj, że nie możesz rozwiązać zadania. Artykuł oznacza typ encji 'node'."
  2. Agent do Obsługi Roszczeń (Claim Processing):
    • Zadanie: Kompleksowa obsługa roszczeń, od analizy, przez zmianę statusu, po wygenerowanie decyzji i e-maila.
    • Narzędzia:
      • Agent Zarządzający Projektem (Swarm Manager): Koordynuje pracę innych agentów.
      • Agent Analizujący Roszczenia: Analizuje dane roszczenia.
      • Agent Podejmujący Decyzje: Na podstawie analizy podejmuje decyzję o akceptacji/odrzuceniu roszczenia.
      • Agent Generujący E-mail: Tworzy i wysyła e-mail z decyzją.
      • Narzędzia Drupal Core do edycji encji, wysyłania e-maili.
    • System Prompt (dla Agenta Zarządzającego Projektem): "Jesteś menedżerem w call center obsługującym roszczenia. Twoim zadaniem jest koordynacja procesu obsługi roszczeń o opóźnienie pociągu. Użyj dostępnych narzędzi (agentów podrzędnych) w odpowiedniej kolejności, aby zrealizować zadanie. W pierwszej odpowiedzi podaj listę narzędzi, których zamierzasz użyć, w kolejności ich użycia."
    • System Prompt (dla Agenta Analizującego Roszczenia): "Jesteś agentem specjalizującym się w analizie roszczeń o opóźnienie pociągu. Aby roszczenie było rozpatrzone, użytkownik musi przesłać bilet, podać miejsce początkowe i docelowe podróży, datę podróży oraz cenę biletu. Sprawdź, czy przesłany bilet wygląda na autentyczny. Określ, czy roszczenie jest zasadne zgodnie z zasadami firmy kolejowej [nazwa firmy]."
  3. Agent do Tworzenia Wariantów Treści (Content Variation):
    • Zadanie: Generowanie różnych wariantów treści na dany temat, dostosowanych do różnych odbiorców.
    • Narzędzia: Narzędzia Drupal Core do tworzenia treści.
    • System Prompt (przykład): "Jesteś kreatywnym agentem specjalizującym się w tworzeniu wariantów treści. Na podstawie podanego tematu i grupy docelowej, wygeneruj treść dostosowaną do tej grupy. Wygeneruj warianty dla: użytkowników WordPressa, dzieci, marketerów."
  4. Agent Asystent Drupal (Drupal Assistant): Chatbot, który może wykorzystywać swarmy agentów do wykonywania zadań w Drupalu, np. edycja treści, tworzenie wariantów treści, zarządzanie konfiguracją.

Ulepszone Logowanie:

  • Podsumowanie Logów przez AI: LLM podsumowuje żądane akcje i działania agenta, co ułatwia szybkie zrozumienie logów.
  • Nowy UI Logów: Czytelny interfejs wyświetlający podsumowanie, prompt, historię rozmowy, użyte agenty, logi agentów potomnych, metadane promptu, surową odpowiedź LLM.
  • Pobieranie Promptów: Możliwość pobrania promptu jako pliku tekstowego.

Jak Wykonać Agentów w Drupalu (UI No-Code/Low-Code):

  1. Przejdź do Konfiguracji Agentów: W panelu administracyjnym Drupal przejdź do sekcji konfiguracji modułu AI Agent (zakładka "Agenci").
  2. Dodaj Nowego Agenta: Kliknij przycisk "Dodaj Agenta".
  3. Konfiguracja Podstawowa:
    • Label (Etykieta): Nazwa agenta, wyświetlana w UI i używana do odwoływania się do niego przez inne agenty. Wybierz etykietę, która jest zrozumiała i opisowa.
    • Description (Opis): Krótki opis agenta, również ważny dla innych agentów i administratorów. Opisz, co agent robi i jakie ma zadanie.
    • Typ Agenta (jeśli dostępny): Wybierz typ agenta (np. prosty agent, agent zarządzający projektami - swarm manager).
    • Max Loops (Maksymalna Liczba Pętli): (Opcjonalne, zaawansowane) Określa maksymalną liczbę iteracji, które agent może wykonać w procesie rozwiązywania zadania.
  4. System Prompt:
    • W polu "System Prompt" wprowadź instrukcje dla agenta. Opisz jego rolę, zadania, ograniczenia, sposób działania.
    • Użyj jasnego i precyzyjnego języka.
    • Określ, jak agent ma reagować w różnych sytuacjach (np. brak danych wejściowych, niepowodzenie zadania).
    • Możesz użyć zmiennych (kontekstowych) z Drupal, aby prompt był dynamiczny.
  5. Narzędzia (Tools):
    • W sekcji "Tools" wybierz narzędzia, które agent ma mieć dostępne.
    • Dostępne narzędzia mogą obejmować:
      • Sub-agent tools (Agenci podrzędni): Pozwala agentowi używać innych agentów jako narzędzi.
      • Modification agents (Agenci modyfikujący): Narzędzia do edycji treści, konfiguracji (np. "Content entity C[reate]E[dit]D[elete]A[ny]").
      • Information agents (Agenci informacyjne): Narzędzia do wyszukiwania informacji (np. "List entities", "Web scraper", "Vision", "Vector search").
      • Drupal Core actions (Akcje Drupal Core): Standardowe akcje Drupal, np. "Publish content", "Unpublish content".
      • ECA Actions (Akcje ECA): Akcje dostępne przez moduł ECA (po integracji).
    • Wybierz odpowiednie narzędzia w zależności od zadań agenta.
    • Konfiguracja narzędzi (jeśli wymagana) może być dostępna po wybraniu narzędzia.
  6. Zapisz Agenta: Kliknij "Zapisz", aby zapisać konfigurację agenta.

Testowanie Agenta:

  • Po zapisaniu agenta, możesz go przetestować poprzez interfejs testowy modułu AI Agent (jeśli dostępny) lub poprzez integrację z Asystentem Drupal (chatbotem) lub innymi modułami Drupal.
  • Monitoruj logi agenta, aby sprawdzić, jak działa i czy poprawnie wykonuje zadania.

Ważne Wskazówki:

  • Etykiety i Opisy: Starannie dobieraj etykiety i opisy agentów, ponieważ są one kluczowe dla komunikacji między agentami i zrozumienia ich funkcji.
  • System Prompt: Inwestuj czas w tworzenie dobrze napisanego i precyzyjnego system promptu. To kluczowy element skutecznego agenta.
  • Narzędzia: Wybieraj tylko te narzędzia, które są niezbędne dla agenta. Zbyt duża liczba narzędzi może wprowadzić zamieszanie.
  • Testowanie i Iteracja: Testuj agenta i iteracyjnie ulepszaj jego konfigurację (system prompt, narzędzia) na podstawie wyników i logów.
  • Dokumentacja: Skorzystaj z dokumentacji modułu Drupal AI Agent i zasobów projektu AI na Drupal.org, aby uzyskać więcej informacji i przykładów.

Pamiętaj, że moduł Drupal AI Agent i jego funkcje są w fazie rozwoju (wersja 1.1). Interfejs i dostępne narzędzia mogą ulec zmianom. Regularnie sprawdzaj aktualizacje i dokumentację projektu.

Tagi