AI Actions

AI Actions

AI Actions erweitern die Fähigkeiten Ihres KI-Agenten über das Beantworten von Fragen aus der Wissensdatenbank hinaus. Mit ihnen definieren Sie ausgelöste Verhaltensweisen — Dinge, die die KI tun soll, wenn sie bestimmte Situationen in einer Konversation erkennt.

Was AI Actions tun:

• HTTP Request Actions — Externe APIs aufrufen, wenn ausgelöst. Zum Beispiel den Bestellstatus in Ihrem Backend prüfen, ein Support-Ticket erstellen oder Kontoinformationen nachschlagen — alles während der Konversation.
• MCP-Aktionen: Verbindung zu Model-Context-Protocol-Servern für fortgeschrittene Tool-Integrationen herstellen (z. B. Shopify-Produktsuchen, eigene Datenbankabfragen).

Typische Anwendungsfälle:

• Echtzeitinformationen (Bestellstatus, Kontodetails, Lagerbestand) aus Ihren Backend-Systemen während Konversationen nachschlagen
• Tickets erstellen, CRM-Datensätze aktualisieren oder Workflows in externen Systemen basierend auf dem Konversationskontext auslösen
• Personalisierte Empfehlungen geben, indem Ihr Produktkatalog abgefragt wird

Jede Aktion hat einen name, eine description (bei HTTP Request Actions teilt die Beschreibung der KI mit, wann sie ausgelöst werden soll) und eine typspezifische Konfiguration. Aktionen können einzeln über die API aktiviert/deaktiviert werden. Aktionen werden im Quickchat Dashboard erstellt und vollständig konfiguriert — die API bietet List-, Update- (Aktivieren/Deaktivieren) und Delete-Operationen sowie eigene Endpunkte zum Erstellen und Konfigurieren von MCP-Aktionen.

Alle AI Actions auflisten

Scope: read_all

GET https://app.quickchat.ai/v1/api/ai_actions

Shell

curl https://app.quickchat.ai/v1/api/ai_actions \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/ai_actions",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Antwort 200 OK

[
  {
    "id": 1,
    "name": "Check Order Status",
    "description": "Look up order status when customer asks about their order.",
    "is_active": true,
    "type": "http_request",
    "icon": null,
    "icon_color": null,
    "is_valid": true
  }
]

Field	Description
id integer	Identifier der AI Action
name string	Anzeigename
description string	Wann die Aktion ausgelöst wird
is_active boolean	Ob aktiviert
type string	"http_request", "remote_mcp", "shopify_remote_mcp" oder "knowledge_base"
icon string or null	Icon-Identifier
icon_color string or null	Icon-Farbe
is_valid boolean	Ob ordnungsgemäß konfiguriert

AI Action aktualisieren

Scope: write_all

PATCH https://app.quickchat.ai/v1/api/ai_actions/{action_id}

Request-Body

Parameter	Description
is_active boolean	Die Aktion aktivieren/deaktivieren
icon string	Icon-Identifier (max. 200 Zeichen)
icon_color string	Icon-Farbe (max. 50 Zeichen)

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/ai_actions/1 \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"is_active": false}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/ai_actions/1",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"is_active": False},
)
data = response.json()

Antwort 200 OK — Gibt den aktualisierten Snapshot der AI Action zurück.

AI Action löschen

Scope: write_all

DELETE https://app.quickchat.ai/v1/api/ai_actions/{action_id}

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/ai_actions/1 \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/ai_actions/1",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)

Antwort 200 OK (leerer Body)

MCP-Aktion erstellen

Scope: write_all

POST https://app.quickchat.ai/v1/api/ai_actions/remote_mcp

Verbindet einen Remote-MCP-Server als MCP-Aktion mit Ihrem KI-Agenten. Erfordert ein API-Token mit dem Scope write_all (API-Tokens erfordern den Business-Plan oder höher).

Request-Body

Parameter	Description
remote_mcp_url string, required	Die URL des MCP-Servers. Muss https:// verwenden; URLs, die auf private oder interne Netzwerkadressen auflösen, werden abgelehnt
headers array, required	Verbindungs-Header, die an den Server gesendet werden, z. B. ein statisches Authorization-Token. Jeder Eintrag ist {"id", "name", "value"} — wählen Sie einen beliebigen eindeutigen String als id. Senden Sie [], wenn der Server keine benötigt
allowed_tools array, required	Schalter pro Tool, jeweils {"name", "is_active"}. Senden Sie [], um die Tool-Verfügbarkeit default_tool_is_active zu überlassen
name string	Anzeigename in der Aktionsliste (max. 100 Zeichen). Standard ist eine vom Host des Servers abgeleitete Bezeichnung
description string	Beschreibung in der Aktionsliste (max. 2500 Zeichen)
icon string	Icon-Identifier (max. 200 Zeichen)
icon_color string	Icon-Farbe (max. 50 Zeichen)

name und description sind Beschriftungen für Operatoren: Sie kennzeichnen die Aktion im Dashboard, die KI liest sie nie. Die KI arbeitet mit den Tool-Beschreibungen, die der MCP-Server selbst veröffentlicht.

Shell

curl -X POST https://app.quickchat.ai/v1/api/ai_actions/remote_mcp \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "remote_mcp_url": "https://mcp.example.com/mcp",
    "headers": [
      {"id": "h-1", "name": "Authorization", "value": "Bearer <SERVER_TOKEN>"}
    ],
    "allowed_tools": [],
    "name": "Example MCP"
  }'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/ai_actions/remote_mcp",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "remote_mcp_url": "https://mcp.example.com/mcp",
        "headers": [
            {"id": "h-1", "name": "Authorization", "value": "Bearer <SERVER_TOKEN>"}
        ],
        "allowed_tools": [],
        "name": "Example MCP",
    },
)
data = response.json()

Antwort 201 Created

{
  "id": 2,
  "name": "Example MCP",
  "description": "Connected MCP server",
  "is_active": false,
  "type": "remote_mcp",
  "icon": "FaMixcloud",
  "icon_color": "#EF4444",
  "is_valid": true,
  "validation_issues": [],
  "remote_mcp_url": "https://mcp.example.com/mcp",
  "remote_mcp_auth_token": "",
  "default_tool_is_active": true,
  "allowed_tools": [],
  "headers": [
    {"id": 10, "name": "Authorization", "value": "Bearer <SERVER_TOKEN>"}
  ],
  "oauth": null,
  "recommended_tools": []
}

Field	Description
remote_mcp_url string	Die URL des verbundenen MCP-Servers
default_tool_is_active boolean	Ob Tools verwendet werden dürfen, die nicht in allowed_tools aufgeführt sind
allowed_tools array	Schalter pro Tool, {"name", "is_active"}
headers array	Gespeicherte Verbindungs-Header
remote_mcp_auth_token string or null	Legacy-Feld für ein statisches Token. Es kann über diese API nicht gesetzt werden — übergeben Sie Zugangsdaten stattdessen über headers
oauth object or null	Autorisierungsstatus für Server, die per OAuth-Anmeldung verbunden sind (sonst null)
recommended_tools array	Tool-Namen, die Quickchat für Server mit einem von Quickchat abgestimmten Profil empfiehlt (schreibgeschützt)
validation_issues array	Namen der fehlgeschlagenen Konfigurationsprüfungen; leer, wenn is_valid true ist

Die übrigen Felder entsprechen Alle AI Actions auflisten.

Die Aktion wird mit is_active: false erstellt. Für Server ohne ein von Quickchat abgestimmtes Profil startet sie außerdem mit default_tool_is_active: true, sodass jedes zur Antwortzeit entdeckte Tool erlaubt ist, bis Sie es einschränken. Zum Einschalten der Aktion verwenden Sie den Endpunkt AI Action aktualisieren oben: PATCH /v1/api/ai_actions/{action_id} mit {"is_active": true}.

MCP-Konfiguration abrufen

Scope: read_all

GET https://app.quickchat.ai/v1/api/ai_actions/{action_id}/remote_mcp

Shell

curl https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Antwort 200 OK — Gibt die MCP-spezifische Konfiguration zurück, im selben Format wie die Antwort beim Erstellen oben.

MCP-Konfiguration aktualisieren

Scope: write_all

PATCH https://app.quickchat.ai/v1/api/ai_actions/{action_id}/remote_mcp

Alle Felder sind optional; nur die gesendeten Felder werden geändert.

Request-Body

Parameter	Description
remote_mcp_url string	Neue Server-URL (validiert wie beim Erstellen). Das Ändern der URL eines per OAuth verbundenen Servers löscht die gespeicherte Autorisierung und schaltet die Aktion aus
headers array	Ersetzt die Verbindungs-Header
allowed_tools array	Ersetzt die Schalter pro Tool, jeweils {"name", "is_active"}
default_tool_is_active boolean	Ob Tools verwendet werden dürfen, die nicht in allowed_tools aufgeführt sind
name string	Anzeigename (max. 100 Zeichen)
description string	Beschreibung in der Aktionsliste (max. 2500 Zeichen)

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_tools": [
      {"name": "search_docs", "is_active": true},
      {"name": "delete_page", "is_active": false}
    ],
    "default_tool_is_active": false
  }'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/ai_actions/2/remote_mcp",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "allowed_tools": [
            {"name": "search_docs", "is_active": True},
            {"name": "delete_page", "is_active": False},
        ],
        "default_tool_is_active": False,
    },
)
data = response.json()

Antwort 200 OK — Gibt die aktualisierte MCP-Aktion zurück, im selben Format wie die Antwort beim Erstellen.

Hinweis

Verbindungstest und Tool-Discovery — die Connect-Prüfung des Dashboards — sind über die öffentliche API nicht verfügbar. Das Dashboard führt die Prüfung automatisch aus, wenn Sie einen Server verbinden oder neu verbinden, und Server mit OAuth-Schutz müssen ihre Autorisierung im Dashboard abschließen; das Feld oauth in den obigen Antworten zeigt diesen Status an.

---