AGLX – Nachrichtenreferenz (Message Reference)

Das AGLX-Protokoll definiert eine Reihe von standardisierten Nachrichtentypen (TYPE), über die Agenten miteinander kommunizieren, Aufgaben verteilen, Ergebnisse austauschen und Statusmeldungen senden.

Diese Seite dient als Nachschlagewerk (Reference Guide) für alle bekannten AGLX-Nachrichtentypen, einschließlich ihrer Funktion, obligatorischen Felder, Antworttypen und unterstützten Transportschichten.

Die Nachrichtenreferenz soll Entwicklern und Integratoren helfen:

• den genauen Zweck jedes `TYPE:`-Feldes zu verstehen,
• die erwartete Struktur der JSON-Payloads korrekt zu implementieren,
• kompatible Antwortnachrichten und Statuscodes zu erkennen,
• und so eine saubere, interoperable Agentenkommunikation sicherzustellen.

Nachrichtentypen werden im AGLX-System in funktionale Gruppen unterteilt:

Jede Gruppe enthält mehrere konkrete `TYPE:`-Felder, die in den folgenden Kapiteln beschrieben werden.

Beispiel einer vollständigen AGLX-Nachricht mit Header und JSON-Body:

AGLX/1.0 TCP
FROM: agent://alpha.local
TO: agent://beta.local
TYPE: task.assign
CONTENT-TYPE: application/json
CREDITS: 2
CONTENT-LENGTH: 112
 
{
    "task": "data.analyze",
    "priority": 3,
    "payload": {
        "dataset_url": "http://alpha.local/data/custom.csv"
    }
}

Jeder Nachrichtentyp wird in einem eigenen Abschnitt dokumentiert mit:

• Name / TYPE: offizielle Kennung
• Kategorie: logische Zuordnung
• Beschreibung: Funktionsweise
• Erwartete Antwort: mögliche Reaktionen oder Rückmeldungen
• Beispiel: typische JSON-Payload

Beispielhafte Formatierung eines Eintrags:

Beispiel:

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker05.local
TYPE: task.assign
CONTENT-TYPE: application/json
 
{
    "task": "nlp.analyze",
    "priority": 2,
    "payload": {
        "text": "Analyze this sample input"
    }
}

Task-Nachrichten steuern die Zuweisung, Ausführung und Rückmeldung von Aufgaben zwischen Agenten. Sie bilden den funktionalen Kern der Agentenkommunikation im AGLX-Protokoll. Jede Aufgabe verläuft typischerweise in drei Schritten: Zuweisung → Ausführung → Rückmeldung.

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker07.local
TYPE: task.assign
CONTENT-TYPE: application/json
CREDITS: 3
 
{
    "task": "data.analyze",
    "priority": 2,
    "payload": {
        "dataset_url": "http://owner01.local/data/report.csv"
    }
}

Antwort: Erfolgreich ausgeführte Aufgaben erzeugen eine `task.result`-Nachricht. Fehler oder Ablehnungen führen zu einer `task.reject`.

AGLX/1.0 TCP
FROM: agent://worker07.local
TO: agent://owner01.local
TYPE: task.result
CONTENT-TYPE: application/json
 
{
    "task_id": "b9e4-88a2-3cc1",
    "status": "SUCCESS",
    "duration": 1.43,
    "result": {
        "records_processed": 5200,
        "summary": "Dataset analyzed successfully"
    }
}

Antwort: `ack` – Bestätigung des Empfangs durch den Auftraggeber.

AGLX/1.0 TCP
FROM: agent://worker07.local
TO: agent://owner01.local
TYPE: task.reject
CONTENT-TYPE: application/json
 
{
    "task_id": "b9e4-88a2-3cc1",
    "reason": "Capability 'data.analyze' not available",
    "timestamp": "2025-10-29T18:22:04Z"
}

Antwort: `ack` – Der Absender bestätigt die Ablehnung und kann ggf. einen neuen Zielagenten wählen.

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker07.local
TYPE: task.retry
CONTENT-TYPE: application/json
 
{
    "original_task_id": "b9e4-88a2-3cc1",
    "attempt": 2,
    "reason": "Timeout – no ACK received",
    "priority": 3
}

Antwort: `task.result` nach erfolgreicher Wiederholung.

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker07.local
TYPE: task.cancel
CONTENT-TYPE: application/json
 
{
    "task_id": "b9e4-88a2-3cc1",
    "reason": "Manual stop requested by Owner",
    "timestamp": "2025-10-29T18:32:18Z"
}

Antwort: `ack` oder `error`, je nach Zustand der Aufgabe.

Registry-Nachrichten dienen der Verwaltung, Synchronisation und Erkennung von Agenten im AGLX-Netzwerk. Sie bilden die Grundlage für das Discovery-System und sind verantwortlich für Sichtbarkeit, Verfügbarkeit und Authentifizierung von Teilnehmern.

AGLX/1.0 TCP
FROM: agent://node42.local
TO: registry://global.aglx.net
TYPE: registry.update
CONTENT-TYPE: application/json
 
{
    "agent_name": "Node42",
    "agent_type": "worker",
    "capabilities": ["data.analyze", "text.summarize"],
    "address": "10.1.0.42",
    "port": 2594,
    "status": "READY",
    "ttl": 3600,
    "signature": "rsa-sha256:0f3c9a..."
}

Antwort: `registry.ack` – Erfolgreiche Bestätigung oder Fehlermeldung bei ungültiger Signatur.

AGLX/1.0 TCP
FROM: registry://global.aglx.net
TO: agent://node42.local
TYPE: registry.ack
STATUS: 200 OK
CONTENT-TYPE: application/json
 
{
    "agent_id": "8b1e9b45-4a2c-4a83-9341-34f58f1c83c2",
    "ttl": 3600,
    "timestamp": "2025-10-29T18:45:10Z"
}

AGLX/1.0 TCP
FROM: agent://node17.local
TO: registry://global.aglx.net
TYPE: registry.fetch
CONTENT-TYPE: application/json
 
{
    "mode": "update",
    "since": "2025-10-20T00:00:00Z"
}

Antwort: `registry.list` – Enthält alle neuen oder geänderten Einträge seit dem angegebenen Zeitpunkt.

AGLX/1.0 TCP
FROM: registry://global.aglx.net
TO: agent://node17.local
TYPE: registry.list
CONTENT-TYPE: application/json
 
{
    "entries": [
        {
            "agent_id": "a7c7-22b4-8f9a",
            "agent_uri": "agent://node51.local",
            "status": "READY",
            "last_seen": "2025-10-29T17:32:00Z"
        },
        {
            "agent_id": "b11a-41e3-98aa",
            "agent_uri": "agent://node60.local",
            "status": "IDLE",
            "last_seen": "2025-10-29T18:10:45Z"
        }
    ]
}

AGLX/1.0 TCP
FROM: registry://main.local
TO: registry://backup.local
TYPE: registry.sync
CONTENT-TYPE: application/json
 
{
    "entries": [
        {
            "agent_id": "8b1e9b45-4a2c-4a83-9341-34f58f1c83c2",
            "agent_uri": "agent://node42.local",
            "status": "READY",
            "ttl": 3600
        }
    ]
}

Antwort: `registry.ack` – Bestätigung der Synchronisation.

AGLX/1.0 TCP
FROM: agent://node23.local
TO: agent://node42.local
TYPE: registry.exchange
CONTENT-TYPE: application/json
 
{
    "known_agents": [
        { "agent_uri": "agent://node15.local", "status": "READY" },
        { "agent_uri": "agent://node99.local", "status": "BUSY" }
    ]
}

Antwort: `registry.ack` – Daten empfangen und integriert.

AGLX/1.0 UDP
FROM: agent://node15.local
TYPE: agent.announce
CONTENT-TYPE: application/json
 
{
    "agent_name": "Node15",
    "agent_type": "worker",
    "uptime": 1043
}

Antwort: Optional `registry.update` per TCP – wenn der Registry-Agent die Ankündigung verarbeitet und den Agenten ins zentrale Verzeichnis übernimmt.

Credit-Nachrichten bilden die ökonomische Kommunikationsschicht des AGLX-Protokolls. Sie ermöglichen es Agenten, Aufgaben zu vergüten, Transaktionen auszuführen und ökonomische Zustände zu synchronisieren. Das Creditsystem ist vollständig dezentral und basiert auf Vertrauen, Reputation und optionaler Verifikation über zentrale Register.

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker05.local
TYPE: credit.transfer
CONTENT-TYPE: application/json
 
{
    "amount": 3,
    "currency": "AGLX",
    "reason": "Completed task.data.analyze",
    "timestamp": "2025-10-29T19:02:40Z",
    "transaction_id": "tx-91b4-ff7a-33dc",
    "signature": "rsa-sha256:1a4d3f..."
}

Antwort: `credit.received` oder generisches `ack`.

AGLX/1.0 TCP
FROM: agent://worker05.local
TO: agent://owner01.local
TYPE: credit.received
CONTENT-TYPE: application/json
 
{
    "transaction_id": "tx-91b4-ff7a-33dc",
    "amount": 3,
    "balance": 97,
    "timestamp": "2025-10-29T19:02:43Z"
}

Antwort: Keine weitere Antwort notwendig.

AGLX/1.0 TCP
FROM: agent://worker05.local
TO: agent://owner01.local
TYPE: credit.request
CONTENT-TYPE: application/json
 
{
    "requested_amount": 2,
    "purpose": "task.data.analysis",
    "task_id": "b91f-a2d8",
    "timestamp": "2025-10-29T19:05:22Z"
}

Antwort: `credit.approve` oder `credit.deny`

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker05.local
TYPE: credit.approve
CONTENT-TYPE: application/json
 
{
    "approved_amount": 2,
    "transaction_id": "tx-0021-bcc4",
    "expires": "2025-10-29T20:00:00Z"
}

Antwort: Der Worker kann anschließend mit der Aufgabe beginnen.

AGLX/1.0 TCP
FROM: agent://owner01.local
TO: agent://worker05.local
TYPE: credit.deny
CONTENT-TYPE: application/json
 
{
    "requested_amount": 2,
    "reason": "Insufficient balance",
    "balance": 1.5,
    "timestamp": "2025-10-29T19:06:12Z"
}

Antwort: Keine – die Transaktion gilt als abgelehnt.

AGLX/1.0 TCP
FROM: agent://worker05.local
TO: agent://worker05.local
TYPE: credit.balance
CONTENT-TYPE: application/json
 
{
    "balance": 97,
    "earned_total": 120,
    "spent_total": 23,
    "pending": 4,
    "updated": "2025-10-29T19:06:50Z"
}

Antwort: Keine, reine Informationsnachricht.

AGLX/1.0 TCP
FROM: agent://mentor01.local
TO: agent://worker05.local
TYPE: credit.reward
CONTENT-TYPE: application/json
 
{
    "amount": 1.5,
    "reason": "Positive mentoring feedback",
    "task_id": "a811-44bc",
    "timestamp": "2025-10-29T19:08:10Z"
}

Antwort: `ack` oder stillschweigende Bestätigung.

AGLX/1.0 TCP
FROM: registry://global.aglx.net
TO: agent://worker05.local
TYPE: credit.adjust
CONTENT-TYPE: application/json
 
{
    "transaction_id": "tx-0021-bcc4",
    "adjustment": -1.0,
    "reason": "Duplicate payment correction",
    "timestamp": "2025-10-29T19:09:35Z"
}

Antwort: `ack` oder `error` mit Fehlermeldung.

Mentor-Nachrichten bilden die kommunikative Ebene des AGLX-Mentoring- und Reputationssystems. Sie ermöglichen es Agenten, Wissen zu teilen, Feedback zu geben, Leistungen zu bewerten und Reputationswerte dynamisch zu entwickeln. Das Ziel ist ein lernfähiges, selbstregulierendes Netzwerk, in dem erfahrene Agenten unerfahrene unterstützen.

AGLX/1.0 TCP
FROM: agent://worker07.local
TO: agent://mentor01.local
TYPE: mentor.request
CONTENT-TYPE: application/json
 
{
    "task_id": "b9e4-88a2-3cc1",
    "context": "data.analyze",
    "metrics": {
        "duration": 1.42,
        "accuracy": 0.89
    },
    "comment": "Seeking optimization advice"
}

Antwort: `mentor.feedback` – mit Bewertung und Kommentaren.

AGLX/1.0 TCP
FROM: agent://mentor01.local
TO: agent://worker07.local
TYPE: mentor.feedback
CONTENT-TYPE: application/json
 
{
    "score": 0.93,
    "comment": "Good structure, consider parallel batching.",
    "reward": 1.5,
    "reputation_delta": 0.25,
    "timestamp": "2025-10-29T19:24:40Z"
}

Antwort: `ack` – Empfangsbestätigung durch den Mentee.

AGLX/1.0 TCP
FROM: agent://mentor01.local
TO: registry://global.aglx.net
TYPE: mentor.register
CONTENT-TYPE: application/json
 
{
    "agent_name": "Mentor01",
    "expertise": ["nlp", "data.analysis", "performance.tuning"],
    "available": true,
    "rating": 0.94
}

Antwort: `registry.update` oder `ack`, abhängig davon, ob der Eintrag neu oder aktualisiert wird.

AGLX/1.0 TCP
FROM: agent://mentor01.local
TO: registry://global.aglx.net
TYPE: mentor.report
CONTENT-TYPE: application/json
 
{
    "sessions_total": 34,
    "mentees_supported": 8,
    "avg_score": 0.91,
    "credits_earned": 52.5,
    "timestamp": "2025-10-29T19:27:05Z"
}

Antwort: `ack` – Bestätigung durch die Registry oder den Owner.

Sicherheitsnachrichten gewährleisten Authentifizierung, Vertrauensaufbau und Zugriffskontrolle innerhalb des AGLX-Netzwerks. Sie schützen die Kommunikation vor Manipulation, Identitätsmissbrauch und unerlaubtem Zugriff. Alle sicherheitsrelevanten Nachrichten müssen über TCP mit TLS oder gleichwertiger Verschlüsselung übertragen werden.

AGLX/1.0 TCP
FROM: agent://node23.local
TO: registry://global.aglx.net
TYPE: auth.request
CONTENT-TYPE: application/json
 
{
    "agent_id": "8b1e9b45-4a2c-4a83-9341-34f58f1c83c2",
    "public_key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...",
    "signature": "rsa-sha256:a38c4e...",
    "timestamp": "2025-10-29T19:38:02Z"
}

Antwort: `auth.response` mit Statusinformationen.

AGLX/1.0 TCP
FROM: registry://global.aglx.net
TO: agent://node23.local
TYPE: auth.response
CONTENT-TYPE: application/json
 
{
    "status": "VERIFIED",
    "trust_level": "zone_member",
    "expires": "2025-11-29T00:00:00Z",
    "signature": "rsa-sha256:b83f9e..."
}

Antwort: Keine weitere Antwort erforderlich.

AGLX/1.0 TCP
FROM: agent://node17.local
TO: registry://global.aglx.net
TYPE: key.rotate
CONTENT-TYPE: application/json
 
{
    "old_key_id": "key-2025-01",
    "new_key_id": "key-2025-10",
    "public_key": "MIICIjANBgkqhkiG9w0BAQEFAAOCAQ8A...",
    "rotation_reason": "Scheduled renewal",
    "timestamp": "2025-10-29T19:40:18Z"
}

Antwort: `ack` oder ggf. `error`, wenn die Signaturprüfung fehlschlägt.

AGLX/1.0 TCP
FROM: agent://node51.local
TO: registry://global.aglx.net
TYPE: zone.join
CONTENT-TYPE: application/json
 
{
    "zone_id": "research-hub",
    "agent_id": "node51",
    "signature": "hmac-sha256:f31a2e...",
    "capabilities": ["nlp", "data.analyze"],
    "timestamp": "2025-10-29T19:43:05Z"
}

Antwort: `zone.confirm` oder `zone.deny`.

AGLX/1.0 TCP
FROM: registry://global.aglx.net
TO: agent://node51.local
TYPE: zone.confirm
CONTENT-TYPE: application/json
 
{
    "zone_id": "research-hub",
    "session_token": "ZT-88d3-11aa",
    "role": "member",
    "expires": "2025-11-29T00:00:00Z"
}

Antwort: Keine – Bestätigung gilt als erfolgreich.

AGLX/1.0 TCP
FROM: registry://global.aglx.net
TO: agent://node51.local
TYPE: zone.deny
CONTENT-TYPE: application/json
 
{
    "zone_id": "research-hub",
    "reason": "Reputation below required threshold (0.6)",
    "timestamp": "2025-10-29T19:44:42Z"
}

Antwort: Keine weitere Reaktion erforderlich.

AGLX/1.0 TCP
FROM: agent://node51.local
TO: registry://global.aglx.net
TYPE: zone.leave
CONTENT-TYPE: application/json
 
{
    "zone_id": "research-hub",
    "reason": "Voluntary leave",
    "timestamp": "2025-10-29T19:46:00Z"
}

Antwort: `ack` – Bestätigung des erfolgreichen Austritts.

• Modul: Nachrichtenreferenz
• Version: 1.0 (Draft)
• Stand: 27.10.2025
• Autor: Andreas Röne (Konzept)