Ottili AI API — Tool-Calls

Ottili AI kann Plattform-Tools aufrufen — zum Beispiel einen Kunden nachschlagen, ein Angebot entwerfen oder einen Flow auslösen. Jeder Tool-Call ist approval-first: der Assistent schlägt eine Aktion vor, und die Ausführung erfolgt erst nach Ihrer Freigabe.

Antwortform

Will das Modell ein Tool aufrufen, enthält die Antwort tool_calls:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_01J...",
            "type": "function",
            "function": {
              "name": "business_hub.create_quote",
              "arguments": "{\"customer_id\":\"c_123\",\"items\":[{\"sku\":\"SKU1\",\"qty\":2}]}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ]
}

Approval-first Ausführung

Tool-Calls, die die Außenwelt berühren, werden von der API nicht direkt ausgeführt. Sie werden:

1. als vorgeschlagene Aktion an Ihre Integration zurückgegeben.

2. bei Bedarf über die Approval-Queue geleitet, gemäß Ihren Einstellungen → AI Regeln.

3. erst nach expliziter Freigabe ausgeführt; jede Ausführung wird für Audit protokolliert.

Das ist dasselbe Sicherheitsmodell wie im im Produkt integrierten Assistenten. Die AI-API verändert externe Systeme niemals stillschweigend.

Tool-Ergebnisse zurückgeben

Nachdem die vorgeschlagene Aktion freigegeben und von Ihrer Seite ausgeführt wurde, setzen Sie das Gespräch fort, indem Sie das Tool-Ergebnis zurückgeben:

{
  "messages": [
    { "role": "user", "content": "Erstelle ein Angebot für c_123." },
    { "role": "assistant", "content": null, "tool_calls": [ { "id": "call_01J...", "type": "function", "function": { "name": "business_hub.create_quote", "arguments": "{\"customer_id\":\"c_123\"}" } } ] },
    { "role": "tool", "tool_call_id": "call_01J...", "content": "{\"quote_id\":\"q_987\",\"status\":\"draft\"}" }
  ]
}

Ist ein angefordertes Tool nicht verfügbar oder nicht berechtigt für Ihr Unternehmen, gibt die API einen klaren Fehler zurück, anstatt ein Ergebnis zu erfinden.