Ajanı iş akışlarına bağlayın

Aksiyonlar, ajanın konuşma sırasında dış bir sisteme yapılandırılmış istek göndermesini sağlar. Uygun kullanım örnekleri müsaitlik okumak, sipariş durumu sorgulamak veya kullanıcı onayından sonra bir randevu talebi oluşturmaktır.

Okuma ve yazma ayrımı

Okuma aracı durumu değiştirmez; örneğin uygun saatleri listeler. Yazma aracı kayıt oluşturur veya değiştirir. Yazma işlemleri müşterinin anlayacağı bir özetle onay istemelidir. Kullanıcı onayı, aracın kendi yetkilendirme ve doğrulama kontrollerinin yerine geçmez.

Webhook sözleşmesi

Her araç için ad, açıklama, HTTPS uç noktası, alanlar ve modele açılacak yanıt alanları tanımlanır. İstek her zaman POST ve JSON gövdeyle gider. Şema, modelin serbest metin yerine beklenen parametreleri üretmesini sağlar. Dolphy istek gövdesini belirlenen boyut ve türlerle sınırlar; yanıt da güvenli bir sonuç biçimine indirgenir.

Her istek paylaşılan sırla HMAC-SHA256 ile imzalanır (Standard Webhooks: webhook-id, webhook-timestamp, webhook-signature başlıkları). Karşı sistem imzayı ham gövde üzerinde doğrulamalı, zaman damgasına makul bir tolerans uygulamalı ve eski isteğin yeniden oynatılmasını reddetmelidir.

Ağ güvenliği

Webhook hedefi yalnız URL biçimiyle doğrulanmaz. Yerel ağ, loopback, bağlantı-yerel ve özel IP hedefleri engellenir; DNS çözümleme sonucu yeniden kontrol edilir ve yönlendirmeler izlenmez. Uç nokta, Kurulum'daki izinli alan adlarından birinde olmalıdır. Bu, ajan aracının sunucu tarafı istek sahteciliği için kullanılmasını önlemeye yöneliktir.

Hata davranışı

Zaman aşımı, geçersiz yanıt veya uzak sistem hatası müşteriye başarılı işlem gibi sunulmaz. Ajan kısa bir açıklama yapar ve güvenli bir yeniden deneme ya da insan desteği yolu önerir. Yazma ucu mümkünse idempotency anahtarı kabul etmelidir; ağ yeniden denemesi aynı kaydı iki kez oluşturmamalıdır.