Agenten

An Agent ist ein KI-System, das Sie ausführen - ein Support-Bot, ein Programmierassistent, ein autonomer Workflow. Task Guard, Govern und Secure akzeptieren eine Agentenidentität, sodass Aufgaben, Entscheidungen und Vorfälle dem richtigen Agenten zugeschrieben werden können.

Gut zu wissen Registrierende Agenten sind optional. Sie können jeden Endpunkt mit nur einem freien Text anrufen agent_name. Die Registrierung eines Agenten gibt Ihnen einen Stall agent_id und ein reichhaltigeres Reporting - aber es ist niemals eine Voraussetzung für die Verwendung der API.

Registriert vs. nicht registriert#

Die Task Guard-Aufgabe beginnt und jeder Govern- und Secure-Aufruf akzeptiert zwei optionale Identitätsfelder:

Sie können entweder beide oder keines von beiden senden. Passieren agent_id Verknüpfung der Aktivität mit dem registrierten Agenten; agent_name Es ist ein menschenlesbares Label. Beginnen Sie mit agent_name, und wechseln zu agent_id Sobald Sie sich registriert haben.

Wie Govern den politischen Anwendungsbereich auflöst#

für die normale Bewertung der Aktivpolitik, agent_id ist optional. Govern bewertet die Aktion immer noch, wenn eine REST- oder MCP-Anfrage nur gesendet wird agent_name.

Passierpass agent_id Wenn Sie können; verwenden agent_name wenn ein Agent noch nicht registriert ist oder wenn ein MCP-Client keine registrierte ID hat. Wenn Sie gehen policy_ids oder policy_group_ids An einem Checkpoint bewertet Maetra die Richtlinien, die Sie explizit ausgewählt haben.

Wann sich registrieren lässt

• Sie möchten Per-Agent-Dashboards, Ergebnisse und Audit-Trails.
• Sie möchten Regeln oder Richtlinien auf bestimmte Agenten ausdehnen.
• Sie bringen einen Agenten in die formale Governance.

Wenn du es nicht brauchst

• Sie integrieren schnell oder Prototyping.
• Der Caller ist ein einmaliges Skript oder eine Produktoberfläche, kein Tracked Agent.

Registrierung eines Agenten#

Registrieren Sie Agenten im Dashboard unter Discover → Agentenregister → Registeragenten. Nur a Name Alles andere (Eigentümer, Umgebung, Framework, Autonomieebene, Werkzeuge) ist optionaler Kontext. Bei Save weist Maetra die agent_id Sie gehen zur API über.

Listenagenten#

GET /v1/agents Gibt die Agenten in Ihrem Arbeitsbereich zurück, neueste zuerst, mit einer minimalen öffentlichen Projektion. Erfordert die discover:agents:read Anwendungsbereich.

Abfrageparameter

curl "https://api.maetra.io/v1/agents?limit=20" \
  -H "Authorization: Bearer $MAETRA_API_KEY"

Antwort

{
  "agents": [
    {
      "id": "agt_5Ab2",
      "name": "billing-bot",
      "description": "Handles customer refunds.",
      "status": "registered",
      "autonomy_level": "L3",
      "risk_level": "medium",
      "environment": "production",
      "created_at": "2026-07-01T09:12:00.000Z",
      "updated_at": "2026-07-06T22:04:00.000Z"
    }
  ]
}