Agenty AI i narzędzia

Rozszerzaj asystenta AI IronFlock o specyficzne dla domeny agenty, które mają dostęp do danych i logiki twojej aplikacji. Zdefiniuj agenty w .ironflock/ai-template.yml.

Jak to działa

Gdy użytkownik rozmawia z AI IronFlock w kontekście projektu z zainstalowaną twoją aplikacją, AI może delegować do twoich agentów. Twoje agenty mogą:

• Odpytywać dane projektu
• Wywoływać zdalne procedury na urządzeniach
• Obsługiwać złożone, wieloetapowe przepływy pracy

Definiowanie agenta

Utwórz plik .ironflock/ai-template.yml:

factory_agent:
    main: true
    tool_description: |
        Deleguj do tego agenta dla zadań automatyzacji fabryki,
        w tym monitorowania produkcji i konfiguracji maszyn.
 
    system_prompt: |
        Jesteś asystentem automatyzacji fabryki. Możesz monitorować
        linie produkcyjne i konfigurować maszyny.
 
    tools:
        get_production_stats:
            description: Pobierz aktualne statystyki produkcji.
            topic: factory.stats
            parameters:
                line_id:
                    type: string
                    required: true

Najlepsze praktyki projektowania narzędzi

• Zwracaj czytelne dane — Agent AI będzie interpretować wartości zwracane przez narzędzie. Zwracaj ustrukturyzowany tekst lub JSON.
• Dołącz komunikaty błędów — Gdy narzędzie zawiedzie, zwróć opisowy komunikat błędu.
• Utrzymuj proste parametry — Używaj typów prymitywnych (string, number, boolean) gdy to możliwe.
• Oznaczaj wymagane parametry — Zawsze ustawiaj required: true dla obowiązkowych danych wejściowych.

Testowanie agentów

1. Dodaj urządzenie testowe do swojej aplikacji.
2. Otwórz czat AI IronFlock.
3. Zadawaj pytania, które powinny wyzwolić twojego agenta.
4. Sprawdź, czy AI prawidłowo deleguje i twoje narzędzia zwracają oczekiwane dane.
5. Testuj przypadki błędów — co się dzieje gdy urządzenie jest offline lub narzędzie zwraca błąd?