# Maschinenlesbare Schnittstellen

> Wie Agenten und Entwickler agentifizierung.de auslesen: llms.txt, Markdown je Seite über Accept-Aushandlung, Volltext, Sitemap, Agent Card und ein A2A-Endpunkt mit Beispielaufrufen.

- Quelle: https://www.agentifizierung.de/developers
- Übersicht: https://www.agentifizierung.de/llms.txt
- Volltext: https://www.agentifizierung.de/llms-full.txt

---

## Maschinenlesbare Schnittstellen

Diese Seite richtet sich an Agenten und an Menschen, die welche bauen. Sie beschreibt, wie sich der Inhalt von agentifizierung.de ohne HTML-Parsing lesen lässt und wie eine Anfrage an das Team übergeben wird. Alles hier ist öffentlich, ohne Anmeldung und ohne Schlüssel abrufbar.

### Dateien

- [llms.txt](https://www.agentifizierung.de/llms.txt)

    Kurzfassung der Site: wofür Agentifizierung zuständig ist, wofür nicht, Kernaussagen, Seitenindex und Kontaktwege.

- [llms-full.txt](https://www.agentifizierung.de/llms-full.txt)

    Der Text aller Kernseiten in einer Datei, beim Abruf aus den ausgelieferten Seiten erzeugt. Blogbeiträge stehen als Index am Ende.

- [sitemap.xml](https://www.agentifizierung.de/sitemap.xml)

    Alle indexierbaren URLs inklusive Änderungsdatum.

- [agent-card.json](https://www.agentifizierung.de/.well-known/agent-card.json)

    A2A Agent Card: Skills, Beispielanfragen und die Adresse des Endpunkts unten.

- [openapi.json](https://www.agentifizierung.de/openapi.json)

    OpenAPI 3.0.3 aller öffentlichen Operationen, mit operationId, Antwortschemas und Fehlermodell nach RFC 9457.

- [api-catalog](https://www.agentifizierung.de/.well-known/api-catalog)

    Linkset nach RFC 9727: verweist auf Spezifikation, Dokumentation und Agent Card, für Agenten, die die Domain noch nicht kennen.

### Jede Seite als Markdown

Jede Seite gibt es zusätzlich als Markdown — entweder über Inhaltsaushandlung auf derselben URL oder direkt über `/index.md`. Die Markdown-Fassung wird aus der ausgelieferten Seite erzeugt; sie kann also nicht etwas anderes behaupten als die Seite selbst.

\# Aushandlung über den Accept-Header
curl -H "Accept: text/markdown" https://www.agentifizierung.de/warum-agenten

## oder direkt
curl https://www.agentifizierung.de/warum-agenten/index.md

Markdown wird nur ausgeliefert, wenn `text/markdown` ausdrücklich im Accept-Header steht. Ein Accept mit Wildcard bekommt weiterhin HTML — sonst würden Browser und Suchmaschinen-Crawler die falsche Variante sehen.

### A2A-Endpunkt

Unter `https://www.agentifizierung.de/a2a/v1` liegt ein Agent-to-Agent-Endpunkt nach dem HTTP+JSON-Binding. Er ordnet eine Anfrage ein, benennt die fehlenden Angaben und gibt den Weg zu einem Menschen zurück. Er ist regelbasiert: kein Modellaufruf, keine Speicherung, gleiche Eingabe also immer gleiche Antwort. Umgesetzt wird anschließend von Menschen — der Endpunkt vermittelt, er baut nichts.

\# Service-Index
curl https://www.agentifizierung.de/a2a/v1

## Anfrage senden
curl -X POST https://www.agentifizierung.de/a2a/v1/message:send \\
  -H "Content-Type: application/json" \\
  -d '{"message":{"role":"user","kind":"message","messageId":"m1",
       "parts":\[{"kind":"text","text":"Wir bekommen 4000 Serviceanfragen im Monat in Zendesk und wollen die Erstqualifizierung automatisieren."}\]}}'

JSON-RPC 2.0 mit der Methode `message/send` wird an der Basis-URL ebenfalls angenommen. Fehler kommen als `application/problem+json` nach RFC 9457 zurück — mit Code, Beschreibung und einem Hinweis, wie der Aufruf richtig aussieht. Antworten sind A2A-Messages mit einem Text- und einem Datenteil; der Datenteil enthält Einschätzung, erkannte Angaben, fehlende Angaben und die Kontaktwege.

### Was ein Agent mitschicken sollte

Nichts davon ist Pflicht. Je mehr davon in der Anfrage steht, desto belastbarer ist die Einschätzung, die zurückkommt:

- Der konkrete Prozess, um den es geht — nicht „KI im Unternehmen“, sondern die Aufgabe
- Die Systeme, in denen der Agent arbeiten müsste: CRM, ERP, Ticketsystem, Telefonie, Microsoft 365
- Ungefähres Volumen pro Monat: Anfragen, Tickets, Anrufe, Belege
- Ob es einen Datenzugang gibt — API, Export oder Systemzugang
- Wer intern entscheidet und wie schnell diese Entscheidung realistisch kommt

### Kontakt

Für alles, was ein Endpunkt nicht klären kann: [info@agentifizierung.de](mailto:info@agentifizierung.de) oder [+49 30 754 202 99](tel:+493075420299). Wer lieber strukturiert einsteigt, nutzt den [Agentifizierungs-Check](https://www.agentifizierung.de/agentifizierungs-check).