AI Actions

AI Actions

AI Actions utökar din AI Agents förmågor utöver att besvara frågor från Knowledge Base. De låter dig definiera utlösta beteenden — saker som AI:n ska göra när den upptäcker specifika situationer i en konversation.

Vad AI Actions gör:

• HTTP Request Actions — Anropa externa API:er när de utlöses. Till exempel kontrollera orderstatus i din backend, skapa ett supportärende eller slå upp kontoinformation — allt under konversationens gång.
• MCP‑åtgärder: Anslut till Model Context Protocol-servrar för avancerade verktygsintegrationer (t.ex. Shopify-produktuppslagningar, anpassade databasfrågor).

Typiska användningsfall:

• Slå upp information i realtid (orderstatus, kontouppgifter, lagersaldo) från dina backend-system under konversationer
• Skapa ärenden, uppdatera CRM-poster eller utlösa workflows i externa system baserat på konversationskontext
• Ge personliga rekommendationer genom att fråga din produktkatalog

Varje action har ett name, en description (för HTTP Request Actions talar beskrivningen om för AI:n när den ska utlösas) och en typspecifik konfiguration. Actions kan aktiveras/inaktiveras individuellt via API:et. Actions skapas och konfigureras fullständigt i Quickchat Dashboard — API:et tillhandahåller list-, uppdaterings- (aktivera/inaktivera) och borttagningsoperationer, samt dedikerade endpoints för att skapa och konfigurera MCP‑åtgärder.

List All AI Actions

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()

Response 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	AI Action-identifierare
name string	Visningsnamn
description string	När aktionen utlöses
is_active boolean	Om den är aktiverad
type string	"http_request", "remote_mcp", "shopify_remote_mcp" eller "knowledge_base"
icon string or null	Ikonidentifierare
icon_color string or null	Ikonfärg
is_valid boolean	Om den är korrekt konfigurerad

Update AI Action

Scope: write_all

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

Request Body

Parameter	Description
is_active boolean	Aktivera/inaktivera aktionen
icon string	Ikonidentifierare (max 200 tecken)
icon_color string	Ikonfärg (max 50 tecken)

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()

Response 200 OK — Returnerar den uppdaterade AI Action-ögonblicksbilden.

Delete AI Action

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>"},
)

Response 200 OK (tom body)

Create MCP Action

Scope: write_all

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

Ansluter en fjärr-MCP-server till din AI Agent som en MCP‑åtgärd. Kräver ett API-token med scope write_all (API-tokens kräver Business-planen eller högre).

Request Body

Parameter	Description
remote_mcp_url string, required	MCP-serverns URL. Måste använda https://; URL:er som pekar på privata eller interna nätverksadresser avvisas
headers array, required	Anslutningsheaders som skickas till servern, t.ex. ett statiskt Authorization-token. Varje post är {"id", "name", "value"} — välj valfri unik sträng som id. Skicka [] om servern inte behöver några
allowed_tools array, required	Brytare per verktyg, var och en {"name", "is_active"}. Skicka [] för att låta default_tool_is_active styra verktygens tillgänglighet
name string	Visningsnamn i åtgärdslistan (max 100 tecken). Standard är en etikett härledd från serverns värdnamn
description string	Beskrivning som visas i åtgärdslistan (max 2500 tecken)
icon string	Ikonidentifierare (max 200 tecken)
icon_color string	Ikonfärg (max 50 tecken)

name och description är etiketter för operatörer: de identifierar åtgärden i dashboarden, och AI:n läser dem aldrig. AI:n arbetar utifrån verktygsbeskrivningarna som MCP-servern själv publicerar.

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()

Response 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	Den anslutna MCP-serverns URL
default_tool_is_active boolean	Om verktyg som inte listas i allowed_tools får användas
allowed_tools array	Brytare per verktyg, {"name", "is_active"}
headers array	Lagrade anslutningsheaders
remote_mcp_auth_token string or null	Äldre fält för ett statiskt token. Det kan inte sättas via detta API — skicka autentiseringsuppgifter via headers i stället
oauth object or null	Auktoriseringsstatus för servrar anslutna med OAuth-inloggning (annars null)
recommended_tools array	Verktygsnamn som Quickchat rekommenderar för servrar med en av Quickchat justerad profil (skrivskyddat)
validation_issues array	Namnen på de konfigurationskontroller som misslyckats; tomt när is_valid är true

Övriga fält motsvarar List All AI Actions.

Åtgärden skapas med is_active: false. För servrar utan en av Quickchat justerad profil startar den dessutom med default_tool_is_active: true, så varje verktyg som upptäcks vid svarstillfället är tillåtet tills du begränsar det. För att slå på åtgärden använder du endpointen Update AI Action ovan: PATCH /v1/api/ai_actions/{action_id} med {"is_active": true}.

Get MCP Action Configuration

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()

Response 200 OK — Returnerar den MCP-specifika konfigurationen, i samma form som skapandesvaret ovan.

Update MCP Action Configuration

Scope: write_all

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

Alla fält är valfria; endast fälten du skickar ändras.

Request Body

Parameter	Description
remote_mcp_url string	Ny server-URL (valideras som vid skapandet). Att ändra URL:en för en server ansluten med OAuth rensar den lagrade auktoriseringen och stänger av åtgärden
headers array	Ersätter anslutningsheaders
allowed_tools array	Ersätter brytarna per verktyg, var och en {"name", "is_active"}
default_tool_is_active boolean	Om verktyg som inte listas i allowed_tools får användas
name string	Visningsnamn (max 100 tecken)
description string	Beskrivning som visas i åtgärdslistan (max 2500 tecken)

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()

Response 200 OK — Returnerar den uppdaterade MCP‑åtgärden, i samma form som skapandesvaret.

Note

Anslutningstest och verktygsupptäckt — dashboardens Connect-kontroll — är inte tillgängliga i det publika API:et. Dashboarden kör kontrollen automatiskt när du ansluter eller återansluter en server, och servrar skyddade av OAuth måste slutföra sin auktorisering i dashboarden; fältet oauth i svaren ovan rapporterar den statusen.

---