Agenten & Personas — AiHummer Dokumente

An Agent ist die Einheit, die AiHummer vor ein Gespräch stellt. Jeder Agent hat eine Persona, ein eigenes Modell, einen strukturierten Prompt und einen Satz von Fähigkeiten, und jede Änderung daran wird versioniert. Agenten werden über die Web-Admin-Oberfläche und über die Admin-API unter verwaltet /v1/admin/agents/*.

Diese Seite behandelt, woraus ein Agent besteht, wie der strukturierte “G3”-Prompt zusammengestellt wird und wie ein Agent sein eigenes Profil sicher bearbeiten kann.

Das Agentenregister

Das Register ist ein vollständiger CRUD-Katalog von Agenten. Für jeden Agenten definieren Sie eine Identität, eine Persona, das Modell, auf dem er läuft, und die Fähigkeiten, die er nutzen kann. Da das Gateway mandantenfähig ist, leben Agenten innerhalb eines Arbeitsbereichs und sind wie alle anderen Mandantendaten isoliert.

Persona — die Stimme und das Verhalten des Agenten, in einen Stall umgesetzt, Cache-freundliche Schicht des System-Prompts.
Pro-Agent-Modell — jeder Agent kann sein eigenes Modell und seinen eigenen Anbieter festlegen, sodass ein Ein billiger Agent und ein Flaggschiff-Agent können im selben Arbeitsbereich koexistieren.
Fähigkeiten — pro Agent und gemeinsame Fähigkeiten rendern einen “Fähigkeiten”-Block in die Aufforderung; sie beschreiben Fähigkeiten, nicht Gewichte.

[!NOTE] Ein Pro-Agent-Modell ist unabhängig vom Routing. Modell-Ebenen-Routing (einfach / standard / komplex) wählt eine Modellklasse für einen Zug, während der pro-Agent Modell ist das eigene Standardmodell des Agenten. Siehe Routing.

Versionen, Rücksetzung und Klonen

Jede bedeutende Änderung an einem Agenten wird als eine erfasst Version. Dies macht die Agenten-Konfiguration prüfbar und umkehrbar: Sie können überprüfen, was sich geändert hat, zurückrollen zu einer früheren Version, oder Klon ein Agent, der es als Ausgangspunkt für einen neuen verwendet. Versions- und Profilressourcen befinden sich unter /v1/admin/agents/* (Profil, Abschnitte, Fähigkeiten, Versionen).

[!TIP] Klonen Sie einen funktionierenden Agenten, bevor ein großes Persona- oder Prompt-Update durchgeführt wird. Wenn der neue Wenn die Richtung nicht aufgeht, ist das Original immer noch einen Rückschritt entfernt.

Die strukturierte „G3“-Eingabeaufforderung

Anstatt eines einzelnen Freitext-Systembefehls verwendet AiHummer ein strukturiertes Agentenprofil (intern intern „G3“). Die Identität ist in Felder zerlegt statt in Prosa vergraben zu sein, und der Rest der Aufforderung wird aus benannten Elementen aufgebaut Abschnitte plus ein Einarbeitung block. Der Orchestrator rendert diese in das geschichtete System-Prompt, wobei die stabilen Teile (Identität, Persona, Abschnitte) in einem zwischenspeicherbaren Präfix behalten und die volatilen Daten zuletzt angehängt werden.

Die Struktur macht es einfach, ein Profil feldweise zu bearbeiten, einfach, Unterschiede zwischen Versionen zu erkennen, und vorhersehbar zu rendern — es gibt keine versteckte Prompt-Suppe.

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

Selbstbearbeitung hinter einem Genehmigungstor

Ein Agent kann erlaubt werden zu sein eigenes Profil bearbeiten Verwendung von Selbstbearbeitungstools — zum Beispiel, um einen Abschnitt zu verfeinern oder dessen Einarbeitung zu aktualisieren. Dies ist bewusst geschützt:

Selbstbearbeitungen durchlaufen die Genehmigungstor: eine vorgeschlagene Änderung wird aufgezeichnet und muss von einem Menschen genehmigt werden, bevor es in Kraft tritt. Eine abgelehnte Änderung wird niemals angewendet.
Die Änderung wird als neu erfasst Version, sodass eine Selbstbearbeitung ebenso überprüfbar ist und so umkehrbar wie jede manuelle Bearbeitung.

[!WARNING] Selbstbearbeitung ist mächtig. Halte sie hinter dem Genehmigungstor zurück, damit ein Agent es nicht kann. schreibt stillschweigend seine eigene Identität neu. Überprüfen Sie vorgeschlagene Selbständerungen auf die gleiche Weise wie Sie jede privilegierte Änderung überprüfen.

E-Mail-Passwörter gehen in den Tresor

Wenn die Konfiguration eines Agenten E-Mail-Zugangsdaten enthält (für die mail Werkzeug), das Passwort wird in die verschlüsselter Anmeldeinformationen-Safe, werden nicht im Profil gespeichert oder in die Eingabeaufforderung eingefügt. Geheimnisse gelangen niemals in den Modellkontext.

Admin-API

Agenten und ihre strukturierten Profile werden über die Admin-API verwaltet, die OIDC-gesichert und überprüft ist:

Ressource	Zweck
`/v1/admin/agents`	Agenten auflisten, erstellen, aktualisieren, löschen (CRUD)
`/v1/admin/agents/.../profile`	Das strukturierte G3-Profil (Identitätsfelder)
`/v1/admin/agents/.../sections`	Benannte Aufforderungsabschnitte
`/v1/admin/agents/.../skills`	Pro-Agent-Fähigkeiten
`/v1/admin/agents/.../versions`	Versionsverlauf, Rücksetzen und Klonen

Wohin als Nächstes

Verstehen, wie Agenten eine Runde ausführen und Helfer erzeugen Orchestrierung & Unteragenten.
Sehen Sie, wie eine eingehende Nachricht einen bestimmten Agenten erreicht in Routing.
Geben Sie Ihren Agenten ein langfristiges Gedächtnis mit Gedächtnis (Einstein).