HTTP Requests Araçları

HTTP Requests araçları, ajanınızın herhangi bir harici API'yi çağırmasını sağlar — veri getirme, bir kayıt oluşturma, bir şeyi güncelleme veya silme. HTTP metoduna göre birer tane olmak üzere dört araç vardır:

• Requests Get — veri okur
• Requests Post — veri oluşturur
• Requests Put — veri günceller
• Requests Delete — veri kaldırır

Hepsi aynı şekilde çalışır; fark HTTP fiilidir (ve gövde gönderip göndermedikleri). API'nin beklediğine uyanı seçin.

Araç ve HTTP node karşılaştırması

Bu araçlar, bir ajanın akıl yürütmesi sırasında bir API'yi ne zaman ve nasıl çağıracağına karar vermesini sağlar. Bunun yerine grafiğin bir adımı olarak sabit, belirleyici bir API çağrısı istiyorsanız, HTTP node'unu kullanın.

Bir akışa ekleme

Araç node'un araç seçicisinde Requests Get / Post / Put / Delete'i seçin, ardından URL'yi ve (isteğe bağlı olarak) ajana hangi parametreleri kullanabileceğini söyleyen bir şema ayarlayın.

Girdiler

Dört aracın tümü şu alanları paylaşır:

Parametre	Açıklama	Zorunlu
URL	Çağrılacak uç nokta. Değişkenleri destekler (örn. {{$flow.state.customerId}}).	Evet
Name	Ajanın gördüğü araç adı. Varsayılan olarak requests_get, requests_post vb.	Hayır
Description	Ajana bu aracı ne zaman kullanacağını söyler.	Hayır
Headers	İstek başlıklarının JSON'ı, örn. bir Authorization bearer token'ı.	Hayır
Max Output Length	Uzun yanıtları kırpar (varsayılan 2000). Tam yanıtı döndürmek için kaldırın.	Hayır

Get ve Delete ek olarak şunlara sahiptir:

Parametre	Açıklama	Zorunlu
Query Params Schema	Ajanın hangisini göndereceğini anlayabilmesi için kullanılabilir sorgu/yol parametrelerini açıklar.	Hayır

Post ve Put ek olarak şunlara sahiptir:

Parametre	Açıklama	Zorunlu
Body	Sabit bir JSON gövdesi. Ayarlanırsa, ajanın oluşturacağı gövdenin yerine geçer.	Hayır
Body Schema	Ajanın geçerli bir istek oluşturabilmesi için kullanılabilir gövde alanlarını açıklar.	Hayır

Şemalar ajana rehberlik eder

Query Params Schema ve Body Schema, URL'yi kısıtlamaz — ajanın doğru değerleri doldurabilmesi için her parametrenin ne anlama geldiğini ona öğretirler. Örnek şema girdisi:

{
  "limit": {
    "type": "string",
    "in": "query",
    "description": "Limit the number of items to return. ?limit=10"
  }
}

Çıktılar

Her araç, API'nin yanıtını döndürür (Max Output Length'e kırpılmış). Tek çıktılı bir araçtır — akış bir sonraki node'a devam eder. Yanıtı flow state'te saklayın veya JSON Path Extractor ile içinden bir değer çekin.

Örnek

Kimliğe göre bir sipariş arama

1. Requests Get ile bir Araç node ekleyin.
2. URL'yi https://api.example.com/orders/{id} olarak ayarlayın ve id'yi açıklayan bir Query Params Schema ekleyin.
3. API token'ınızla bir Authorization başlığı ekleyin.

Ajan sipariş ayrıntılarına ihtiyaç duyduğunda, aracı doğru id ile çağırır ve JSON yanıtı bir sonraki adım için geri gelir.

İpuçları

• Gizli bilgileri URL'de değil, başlıklarda tutun. API anahtarlarını Headers alanına koyun.
• URL'de değişkenler kullanın doğru kaydı hedeflemek için, örn. {{$flow.state.customerId}}.
• Post/Put'ta yalnızca sabit bir yük istediğinizde bir Body ayarlayın — aksi takdirde ajanın gövdeyi Body Schema'dan oluşturmasına izin verin.
• Max Output Length'i yükseltin (veya kaldırın) API tam olarak ihtiyaç duyduğunuz büyük yükler döndürüyorsa.

İlgili

• HTTP node — belirleyici bir adım olarak sabit bir API çağrısı
• JSON Path Extractor — bir API yanıtından bir değer çekin
• Custom Araç — karmaşık API mantığını kendi aracınıza sarın
• Değişkenler · Flow state