API Änderungen – Version 13.1

Added

Keine.

Changed

Keine.

Deprecated

• POST /v1/chat/prompt-http Nutze bitte stattdessen die allgemeinen Agent-Endpunkte. Eine vollständige Dokumentation der Agent-API ist unter /agents/docs verfügbar.

  General Purpose Agent – Nachricht senden

  Der empfohlene Ersatz ist der POST /agents/general-purpose/message:send-Endpunkt (A2A-Protokoll v1.0).

  Endpunkt:

  A2A JSON-RPC: POST https://aissist-backend.bv.burda.com/agents/general-purpose/

  REST: POST https://aissist-backend.bv.burda.com/agents/general-purpose/message:send

  Pflicht-Header:

  • Authorization: Bearer <JWT_TOKEN>
  • A2A-Version: 1.0

  Minimales Request-Body (Pflichtfelder):

  A2A JSON-RPC

  {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "SendMessage",
    "params": {
      "message": {
        "message_id": "message_id",
        "role": "ROLE_USER",
        "parts": [
          {
            "text": "Deine Nachricht an den Agent (Optional)"
          }
        ]
      },
      "metadata": {
        "templateId": "my-template-id"
      }
    }
  }

  REST

  {
    "message": {
      "message_id": "message_id",
      "role": "ROLE_USER",
      "parts": [
        {
          "text": "Deine Nachricht an den Agent (Optional)"
        }
      ]
    },
    "metadata": {
        "templateId": "my-template-id"
    }
  }

  Vollständiges Beispiel mit Template und Inputs:

  A2A JSON-RPC

  {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "SendMessage",
    "params": {
      "message": {
        "message_id": "message_id",
        "role": "ROLE_USER",
        "parts": [
          {
            "text": "Deine Nachricht an den Agent (Optional)"
          }
        ]
      },
      "metadata": {
        "templateId": "my-template-id",
        "inputs": [
          {
            "name": "topic",
            "value": "Kubernetes"
          },
          {
            "name": "languages",
            "value": ["Python", "Go"]
          }
        ]
      }
    }
  }

  REST

  {
    "message": {
      "message_id": "message_id",
      "role": "ROLE_USER",
      "parts": [
        {
          "text": "Deine Nachricht an den Agent (Optional)"
        }
      ]
    },
    "metadata": {
      "templateId": "my-template-id",
      "inputs": [
        {
          "name": "topic",
          "value": "Kubernetes"
        },
        {
          "name": "languages",
          "value": ["Python", "Go"]
        }
      ]
    }
  }

  Hinweis: Wenn templateId gesetzt ist, kann der Text in parts leer sein – der Agent verwendet dann das Prompt-Template als Grundlage.

  Wichtige Felder:

  Feld	Beschreibung	Beispiel
  message.message_id	Eindeutige ID der Nachricht	"msg-uuid-123"
  message.context_id	Optionale Kontext-/Session-ID für mehrstufige Gespräche	"ctx-uuid-456"
  message.role	Rolle des Absenders	"user"
  message.parts	Inhalt der Nachricht – mindestens ein Text-Part	[{"text": "Hallo"}]
  params.metadata.templateId	ID des Prompt-Templates	"my-template-id"
  params.metadata.inputs	Template-Eingaben als name/value-Array (optional)	[{"name": "topic", "value": "AI"}]

  Migration von prompt-http – Feld-Mapping:

  Altes Feld (PromptRequestSchema)	Neues Feld (SendMessageRequest)	Hinweis
  template_id	params.metadata.templateId	Template-ID wird als Metadatum übergeben
  inputs (Array mit name/value)	params.metadata.inputs	Eingaben werden als Array mit name/value-Objekten in den Metadaten übergeben

  Für Streaming steht alternativ POST https://aissist-backend.bv.burda.com/agents/general-purpose/message:stream zur Verfügung (Server-Sent Events).

Removed

Keine.