AI Eylemleri

AI Temsilcinizin AI Eylemlerini API üzerinden yönetin.

İsteğe bağlı örnek kontrolleri

JSONPath eşleşmelerini önizleyin. Kök, alan, dizi indeksi ve joker karakter yollarını sağlanan JSON’a göre kontrol edin. Bu araç bir Eylem çalıştırmaz veya konuşma belleğini kaydetmez.
Örnek bir MCP bağlantısını kontrol edin. Yalnızca Cloudflare belgeleri veya Microsoft Learn uç noktasında bağlantıyı başlatın ve araçları listeleyin. Giriş yapılmaz ve araç çalıştırılmaz.

Uyumlu bir tarayıcıda bu kontroller site araçları olarak da kullanılabilir. Bağlantılar standart formları açar.

AI Eylemleri

AI Eylemleri, AI Temsilcinizin yeteneklerini Bilgi Tabanından soru yanıtlamanın ötesine taşır. Tetiklenen davranışlar tanımlamanızı sağlar: AI’ın konuşmada belirli durumları algıladığında yapması gereken işlemler.

AI Eylemleri neler yapar?

HTTP İsteği Eylemleri: Tetiklendiğinde harici API’leri çağırır. Örneğin konuşma sırasında arka uç sisteminizde sipariş durumunu kontrol edebilir, destek bileti oluşturabilir veya hesap bilgilerini sorgulayabilir.
MCP Eylemleri: Gelişmiş araç entegrasyonları için Model Context Protocol sunucularına bağlanır (örneğin Shopify ürün sorguları, özel veritabanı sorguları).

Yaygın kullanım alanları:

Konuşma sırasında arka uç sistemlerinizden gerçek zamanlı bilgi alma (sipariş durumu, hesap ayrıntıları, stok)
Konuşma bağlamına göre harici sistemlerde bilet oluşturma, CRM kayıtlarını güncelleme veya iş akışlarını tetikleme
Ürün kataloğunuzu sorgulayarak kişiselleştirilmiş öneriler sunma

Her eylemin bir name, description (HTTP İsteği Eylemlerinde açıklama AI’a ne zaman tetikleyeceğini söyler) ve türe özel yapılandırması vardır. Eylemler API üzerinden ayrı ayrı açılıp kapatılabilir. Eylemler Quickchat Kontrol Panelinde oluşturulur ve tam olarak yapılandırılır. API; listeleme, güncelleme (açma/kapatma) ve silme işlemlerinin yanında MCP Eylemlerini oluşturmak ve yapılandırmak için özel uç noktalar sunar.

Tüm AI Eylemlerini listeleme

Kapsam: read_all

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

Shell
Python

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

import requests

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

Yanıt 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
  }
]

Alan	Açıklama
`id` tamsayı	AI Eylemi tanımlayıcısı
`name` dize	Görünen ad
`description` dize	Eylemin ne zaman tetikleneceği
`is_active` mantıksal değer	Etkin olup olmadığı
`type` dize	`"http_request"`, `"remote_mcp"`, `"shopify_remote_mcp"` veya `"knowledge_base"`
`icon` dize veya null	Simge tanımlayıcısı
`icon_color` dize veya null	Simge rengi
`is_valid` mantıksal değer	Doğru yapılandırılıp yapılandırılmadığı

AI Eylemini güncelleme

Kapsam: write_all

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

İstek gövdesi

Parametre	Açıklama
`is_active` mantıksal değer	Eylemi etkinleştirir/devre dışı bırakır
`icon` dize	Simge tanımlayıcısı (en fazla 200 karakter)
`icon_color` dize	Simge rengi (en fazla 50 karakter)

Shell
Python

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}'

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

Yanıt 200 OK: güncellenmiş AI Eylemi anlık görüntüsünü döndürür.

AI Eylemini silme

Kapsam: write_all

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

Shell
Python

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

import requests

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

Yanıt 200 OK (boş gövde)

MCP Eylemi oluşturma

Kapsam: write_all

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

Uzak bir MCP sunucusunu AI Temsilcinize MCP Eylemi olarak bağlar. write_all kapsamlı API belirteci gerekir (API belirteçleri için Business planı veya üzeri gereklidir).

İstek gövdesi

Parametre	Açıklama
`remote_mcp_url` dize, zorunlu	MCP sunucusunun URL’si. `https://` kullanmalıdır; özel veya dahili ağ adreslerine çözümlenen URL’ler reddedilir
`headers` dizi, zorunlu	Sunucuya gönderilen bağlantı üstbilgileri, örneğin sabit `Authorization` belirteci. Her öğe `{"id", "name", "value"}` biçimindedir; `id` için benzersiz bir dize seçin. Sunucu üstbilgi gerektirmiyorsa `[]` gönderin
`allowed_tools` dizi, zorunlu	Her biri `{"name", "is_active"}` olan araç bazındaki anahtarlar. Araç kullanılabilirliğini `default_tool_is_active` ayarına bırakmak için `[]` gönderin
`name` dize	Eylemler listesinde gösterilen ad (en fazla 100 karakter). Varsayılan olarak sunucunun ana makine adından türetilen etiket kullanılır
`description` dize	Eylemler listesinde gösterilen açıklama (en fazla 2500 karakter)
`icon` dize	Simge tanımlayıcısı (en fazla 200 karakter)
`icon_color` dize	Simge rengi (en fazla 50 karakter)

name ve description operatöre yönelik etiketlerdir: kontrol panelinde eylemi tanımlarlar ve AI bunları hiçbir zaman okumaz. AI, MCP sunucusunun kendisinin yayınladığı araç açıklamalarını kullanır.

Shell
Python

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"
  }'

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

Yanıt 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": []
}

Alan	Açıklama
`remote_mcp_url` dize	Bağlı MCP sunucusunun URL’si
`default_tool_is_active` mantıksal değer	`allowed_tools` içinde listelenmeyen araçların kullanılıp kullanılamayacağı
`allowed_tools` dizi	Araç bazındaki anahtarlar, `{"name", "is_active"}`
`headers` dizi	Saklanan bağlantı üstbilgileri
`remote_mcp_auth_token` dize veya null	Eski sabit belirteç alanı. Bu API üzerinden ayarlanamaz; kimlik bilgilerini `headers` üzerinden gönderin
`oauth` nesne veya null	OAuth girişiyle bağlanan sunucuların yetkilendirme durumu (diğer durumlarda `null`)
`recommended_tools` dizi	Önceden hazırlanmış profili olan sunucular için Quickchat’in önerdiği araç adları (salt okunur)
`validation_issues` dizi	Başarısız yapılandırma kontrollerinin adları; `is_valid` değeri `true` olduğunda boştur

Diğer alanlar Tüm AI Eylemlerini listeleme ile aynıdır.

Eylem is_active: false ile oluşturulur. Önceden hazırlanmış Quickchat profili olmayan sunucularda ayrıca default_tool_is_active: true ile başlar; dolayısıyla siz sınırlayana kadar yanıt sırasında keşfedilen her araca izin verilir. Eylemi açmak için yukarıdaki AI Eylemini güncelleme uç noktasını kullanın: {"is_active": true} ile PATCH /v1/api/ai_actions/{action_id}.

MCP Eylemi yapılandırmasını alma

Kapsam: read_all

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

Shell
Python

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

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

Yanıt 200 OK: MCP’ye özel yapılandırmayı yukarıdaki oluşturma yanıtıyla aynı biçimde döndürür.

MCP Eylemi yapılandırmasını güncelleme

Kapsam: write_all

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

Tüm alanlar isteğe bağlıdır; yalnızca gönderdiğiniz alanlar değişir.

İstek gövdesi

Parametre	Açıklama
`remote_mcp_url` dize	Yeni sunucu URL’si (oluşturmadaki gibi doğrulanır). OAuth ile bağlı sunucunun URL’sini değiştirmek saklanan yetkilendirmeyi temizler ve eylemi kapatır
`headers` dizi	Bağlantı üstbilgilerini değiştirir
`allowed_tools` dizi	Her biri `{"name", "is_active"}` olan araç bazındaki anahtarları değiştirir
`default_tool_is_active` mantıksal değer	`allowed_tools` içinde listelenmeyen araçların kullanılıp kullanılamayacağı
`name` dize	Görünen ad (en fazla 100 karakter)
`description` dize	Eylemler listesinde gösterilen açıklama (en fazla 2500 karakter)

Shell
Python

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
  }'

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

Yanıt 200 OK: güncellenmiş MCP Eylemini oluşturma yanıtıyla aynı biçimde döndürür.

Bağlantı testi ve araç keşfi, yani kontrol panelindeki Bağlan kontrolü, genel API’de kullanılamaz. Kontrol paneli bir sunucuyu bağladığınızda veya yeniden bağladığınızda kontrolü otomatik çalıştırır. OAuth ile korunan sunucuların yetkilendirmesi kontrol panelinde tamamlanmalıdır; yukarıdaki yanıtlardaki oauth alanı bu durumu bildirir.

AI Eylemleri

İsteğe bağlı örnek kontrolleri

AI Eylemleri

Tüm AI Eylemlerini listeleme

AI Eylemini güncelleme

AI Eylemini silme

MCP Eylemi oluşturma

MCP Eylemi yapılandırmasını alma

MCP Eylemi yapılandırmasını güncelleme

Başlangıç

AI Agent

Eylemler

Konuşmalar

Kanallar

Web siteniz

Yardım masası ve CRM

Mesajlaşma uygulamaları

Hesap ve faturalandırma

Başlangıç

Yapılandırma

Bilgi tabanı

Konuşmalar