Agenci i persony

G3 profile
├── identity fields   (decomposed: name, role, ...)
├── sections          (named, ordered prompt blocks)
└── onboarding        (first-run guidance)

Jeden **agent** to jednostka, którą AiHummer umieszcza na początku rozmowy. Każdy agent ma swoją osobowość, własny model, ustrukturyzowany prompt i zestaw umiejętności, a każda zmiana w nim jest wersjonowana. Agenci są zarządzani z poziomu interfejsu administracyjnego w sieci oraz poprzez API administracyjne pod `/v1/admin/agents/*`. Ta strona obejmuje to, z czego składa się agent, jak zbudowany jest ustrukturyzowany prompt "G3" oraz jak agent może bezpiecznie edytować swój własny profil. ## Rejestr agentów Rejestr jest pełnym katalogiem CRUD agentów. Dla każdego agenta definiujesz tożsamość, personę, model, na którym działa, oraz umiejętności, które może wykorzystać. Ponieważ brama jest wielodostępna, agenci znajdują się wewnątrz przestrzeni roboczej i są izolowani jak dane każdego innego najemcy. - **Persona** — głos i zachowanie agenta, przeniesione do stajni, warstwa przyjazna pamięci podręcznej w systemowym poleceniu. - **Model per-agenta** — każdy agent może przypiąć swój własny model i dostawcę, więc a Tani agent i agent flagowy mogą współistnieć w tej samej przestrzeni roboczej. - **Umiejętności** — umiejętności przypisane do agenta i wspólne przekształcają blok „Umiejętności” w podpowiedź; opisują możliwości, a nie wagi. > [!NOTE] > Model per-agenta jest niezależny od routingu. Routing na poziomie modelu (prosty / > standardowy / złożony) wybiera klasę modelu dla tury, podczas gdy dla każdego agenta > model jest domyślny dla agenta. Zobacz > [Trasowanie](/pl/v1.0/concepts/routing). ## Wersje, cofanie i klonowanie Każda znacząca zmiana agenta jest rejestrowana jako **wersja**. To sprawia, że konfiguracja agenta jest możliwa do audytu i odwracalna: możesz przejrzeć, co się zmieniło, **cofnąć** do wcześniejszej wersji, lub **klon** agent do użycia go jako punktu wyjścia dla nowego. Zasoby wersji i profilu znajdują się pod `/v1/admin/agents/*` (profil, sekcje, umiejętności, wersje). > [!TIP] > Sklonuj działającego agenta przed dużą zmianą osobowości lub wskazówki. Jeśli nowy > jeśli kierunek się nie sprawdzi, oryginał wciąż jest jeden rollback od nas. ## Strukturalny prompt „G3” Zamiast pojedynczego polecenia systemowego w formie wolnego tekstu, AiHummer używa **ustrukturyzowany profil agenta** (wewnętrznie „G3”). Tożsamość to **rozkład na pola** zamiast ukrywać w prozie, a reszta podpowiedzi jest zbudowana z nazwanych **sekcje** plus jeden **wdrażanie** blok. Orkiestrator renderuje je w warstwowy systemowy prompt, utrzymując stabilne części (tożsamość, persona, sekcje) w buforowanym prefiksie i dołączając zmienne dane na końcu. Struktura sprawia, że profil jest łatwy do edytowania pole po polu, łatwy do porównania między wersjami i przewidywalny w renderowaniu — nie ma ukrytej zupy z podpowiedziami. ```text G3 profile ├── identity fields (decomposed: name, role, ...) ├── sections (named, ordered prompt blocks) └── onboarding (first-run guidance) ``` ## Samodzielna edycja za bramką zatwierdzającą Agent może mieć pozwolenie na **edytować swój własny profil** korzystanie z narzędzi do samodzielnej edycji — na przykład w celu ulepszenia sekcji lub zaktualizowania jej wprowadzania. Jest to celowo chronione: - Samo-edytowanie przechodzi przez **brama zatwierdzenia**: proponowana zmiana jest rejestrowana i musi być zatwierdzony przez człowieka, zanim wejdzie w życie. Odrzucona zmiana nigdy nie zastosowany. - Zmiana jest zarejestrowana jako nowa **wersja**, więc samoedycja jest tak samo możliwa do audytu i odwracalny jak każda ręczna edycja. > [!WARNING] > Samodzielna edycja jest potężna. Trzymaj ją za bramką zatwierdzeń, aby agent nie mógł > cicho przepisuje swoją własną tożsamość. Przejrzyj proponowane samodzielne poprawki w ten sam sposób, jak ty > przejrzyj każdą uprzywilejowaną zmianę. ### Hasła do poczty trafiają do sejfu Jeśli konfiguracja agenta zawiera dane uwierzytelniające do poczty (dla `mail` narzędzie), hasło jest zapisane w **zaszyfrowany sejf na dane uwierzytelniające**, nie są przechowywane w profilu ani wprowadzane do promptu. Sekrety nigdy nie trafiają do kontekstu modelu. ## API administratora Agenci i ich uporządkowane profile są zarządzani za pomocą API administratora, które jest zabezpieczone OIDC i audytowane: | Zasób | Cel | |---|---| | `/v1/admin/agents` | Wyświetl, utwórz, zaktualizuj, usuń agentów (CRUD) | | `/v1/admin/agents/.../profile` | Strukturalny profil G3 (pola tożsamości) | | `/v1/admin/agents/.../sections` | Nazwane sekcje promptu | | `/v1/admin/agents/.../skills` | Umiejętności poszczególnych agentów | | `/v1/admin/agents/.../versions` | Historia wersji, przywracanie i klonowanie | ## Dokąd dalej - Zrozum, jak agenci wykonują turę i generują pomocników w [Orkiestracja i podagentów](/pl/v1.0/concepts/orchestration-subagents). - Zobacz, jak nadchodząca wiadomość dociera do konkretnego agenta w [Trasowanie](/pl/v1.0/concepts/routing). - Daj swoim agentom pamięć długoterminową z [Pamięć (Einstein)](/pl/v1.0/concepts/memory-einstein).