API und Agentenabläufe.

curl -s https://<Wiss-KI-Pur-host>/v1/models

Die konkrete Modellkennung wird aus der Antwort übernommen und anschließend im Chat-Request verwendet.

Bei aktiviertem Zugriffsschutz muss der Client die dafür vorgesehenen Zugangsdaten mitsenden. Die erreichbare Basisadresse hängt von der jeweiligen Installation ab.

curl -N https://<Wiss-KI-Pur-host>/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "<modellkennung>",
    "messages": [{"role": "user", "content": "Erkläre den Ablauf."}],
    "stream": true
  }'

Der Endpunkt bleibt derselbe. Der Client verarbeitet die Antwort stückweise, anstatt auf die vollständige Fertigstellung zu warten.

Der Client empfängt Streaming-Ereignisse schrittweise (Server-Sent Events). Für lokale Tests kann statt HTTPS die freigegebene LAN-Adresse mit dem dafür vorgesehenen Port genutzt werden.

{
  "model": "<modellkennung>",
  "messages": [{"role":"user","content":"Wo befindet sich Auftrag A-000123?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_order",
      "description": "Liest einen Auftrag.",
      "parameters": {
        "type": "object",
        "properties": {"order_id":{"type":"string"}},
        "required": ["order_id"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}

Bei einer Werkzeugentscheidung enthält die Modellantwort einen strukturierten tool_calls -Eintrag. Nach der lokalen Ausführung wird das Ergebnis mit passender tool_call_id als Nachricht mit role: "tool" zurückgesendet.

{
  "model": "<modellkennung>",
  "messages": [
    {"role":"user","content":"Wo befindet sich Auftrag A-000123?"},
    {"role":"assistant","tool_calls":[{"id":"<call-id>","type":"function","function":{"name":"get_order","arguments":"{\"order_id\":\"A-000123\"}"}}]},
    {"role":"tool","tool_call_id":"<call-id>","content":"{\"shipment_id\":\"SHIP-000123\"}"}
  ],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_order",
      "description": "Liest einen Auftrag.",
      "parameters": {
        "type": "object",
        "properties": {"order_id":{"type":"string"}},
        "required": ["order_id"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}