Ana içeriğe geç

LLM Düğümleri

3. LLM Düğümleri

LLM düğümleri, iş akışınızın içinde yapay zeka modellerini çalıştırmanızı sağlar. Metin özetleme, sınıflandırma, çeviri, içerik üretme ve karar verme adımlarında kullanılır. Düğüm kataloğunda LLM sekmesi altında yer alırlar.

LLM düğümleri tek başına kullanılmaz; bir önceki düğümden girdi alır, bu girdiyi seçilen modele gönderir ve üretilen sonucu bir sonraki düğüme aktarır. Temel akış her örnekte aynıdır:

Metin Girişi → LLM düğümü → Metin Çıktısı
  • Metin Girişi, kullanıcının yazdığı veya önceki bir düğümden gelen veriyi taşır.
  • LLM düğümü, bu veriyi seçilen modele ve işleme göre işler.
  • Metin Çıktısı, oluşan yanıtı görüntüler veya sonraki adımlarda kullanılmak üzere aktarır.

Düğüm Grupları​

SkyStudio'daki LLM düğümleri dört grupta toplanır:

GrupDüğümlerBağlantı Gerekir mi?
Yerleşik API düğümleriOpenAI API Çağrısı, Anthropic API Çağrısı, Claude Web SearchHayır — model erişimi SkyStudio tarafından sağlanır
Native (GOAT)GOATHayır
BYOK (Bring Your Own Key)Mistral AI, DeepSeek, Groq, xAI (Grok), Together AI, Perplexity, Cohere, Gemini, OpenRouter, Hugging FaceEvet — kendi sağlayıcı hesabınızın API anahtarı
BYOM (Bring Your Own Model)Custom Model, Azure OpenAI, AWS BedrockEvet — uç nokta / kimlik bilgisi

Bağlantı Kurulumu​

Yerleşik API düğümleri ve GOAT kimlik bağlantısı gerektirmez. Model erişimi SkyStudio tarafından sağlanır; kendi API anahtarınızı girmenize gerek yoktur.

Not: Yerleşik düğümler arasında yalnızca Claude Web Search düğümü, web arama sağlayıcısına erişim için bir bağlantı gerektirebilir. Bu durumda düğümde "Kimlik bağlantısı gerekli" uyarısı çıkar.

BYOK ve BYOM düğümleri ise kendi sağlayıcı hesabınıza veya model altyapınıza bağlanır. Bu düğümlerde önce Uygulama Bağlantıları alanında bir bağlantı oluşturulur, ardından düğümde bu bağlantı seçilir. Adım adım kurulum her sağlayıcının kendi bölümünde anlatılmıştır (bkz. BYOK — Kendi API Anahtarınla Sağlayıcı Kullanımı ve BYOM — Kendi Modelini Bağlama bölümleri).

Yerleşik API Düğümleri​

Yerleşik API düğümleri grubunda 3 düğüm bulunur:

DüğümAçıklama
OpenAI API ÇağrısıOpenAI modellerine istek gönderir
Anthropic API ÇağrısıAnthropic Claude modellerine istek gönderir
Claude Web SearchClaude ile web araması yaparak güncel bilgiyle yanıt üretir

Ortak Panel Yapısı​

Üç düğüm da aynı panel düzenini kullanır:

BölümZorunluAçıklama
Düğüm AdıHayırDüğümün canvas'taki adı
ModelEvetKullanılacak yapay zeka modeli
System Prompt EkleHayırModelin rolünü ve davranış kurallarını tanımlar
AraçlarHayırModelin gerektiğinde çağırabileceği dış araçlar
SorguEvetModele gönderilecek istek metni

OpenAI API Çağrısı​

OpenAI modellerine istek gönderir ve yanıtı akışa aktarır.

Parametreler​

ParametreZorunluAçıklama
Düğüm AdıHayırDüğümün canvas'taki adı
ModelEvetGPT serisi modellerden biri (örn. GPT-5.4 Mini, GPT-5.5)
System PromptHayırModelin rolü ve kuralları
AraçlarHayırModelin kullanabileceği araçlar
SorguEvetİstek metni. / ile önceki düğüm çıktısını ekleyebilirsiniz

Model Seçimi​

Model tipiNe için uygun
Mini / NanoKısa özet, sınıflandırma, basit çeviri — hızlı ve ekonomik
Standart (GPT-5, GPT-5.5)Genel amaçlı üretim, raporlama
o serisiAdım adım akıl yürütme gerektiren işler

Kullanım Örneği​

Toplantı notunu özetlemek için:

  • Model: GPT-5.4 Mini
  • System Prompt: Sen bir toplantı özet asistanısın. Yanıtlarını Türkçe ver, en fazla 5 madde kullan.
  • Sorgu: Alana tıklayıp / ile önceki düğümün metin çıktısını seçin

Örnek Çıktı​

{
"answer": "Toplantıda üç karar alındı: bütçe %15 artırıldı, lansman ertelendi, yeni ekip üyesi işe alınacak.",
"model": "gpt-5.4-mini",
"tokens_used": 412
}

Anthropic API Çağrısı​

Anthropic Claude modellerine istek gönderir. Uzun doküman analizi ve dikkatli akıl yürütme gerektiren işlerde tercih edilir.

Parametreler​

ParametreZorunluAçıklama
Düğüm AdıHayırDüğümün canvas'taki adı
ModelEvetClaude serisi modellerden biri (örn. Claude 5 Sonnet, Claude 4.8 Opus)
System PromptHayırModelin rolü ve kuralları
AraçlarHayırModelin kullanabileceği araçlar
SorguEvetİstek metni

Model Seçimi​

Model tipiNe için uygun
SonnetDengeli — çoğu iş için uygun, iyi hız/kalite dengesi
OpusUzun doküman analizi, karmaşık akıl yürütme

Kullanım Örneği​

Uzun bir sözleşmeyi analiz etmek için:

  • Model: Claude 4.8 Opus
  • System Prompt: Sen bir sözleşme analiz uzmanısın. Riskli maddeleri tespit et ve her biri için gerekçe yaz. Emin olmadığın konularda tahmin yürütme.
  • Sorgu: / ile dosya okuma düğümünün çıktısını seçin

Claude modelini web araması yeteneğiyle birlikte çalıştırır. Güncel bilgi gerektiren sorular için kullanılır.

Parametreler​

ParametreZorunluAçıklama
Düğüm AdıHayırDüğümün canvas'taki adı
ModelEvetKullanılacak Claude modeli
System PromptHayırModelin rolü ve kuralları
SorguEvetAraştırılacak konu veya soru
Maksimum AramaHayırYapılacak en fazla web araması sayısı

Kullanım Örneği​

Sektörel güncel bilgi toplamak için:

  • Sorgu: Türkiye'de yapay zeka regülasyonlarında son durum nedir?
  • System Prompt: Bulguları tarih sırasıyla listele ve her madde için kaynak belirt.

Not: Web araması, normal LLM çağrısından daha uzun sürer. Güncel bilgi gerekmiyorsa Anthropic API Çağrısı düğümünü kullanmak daha hızlıdır.

System Prompt Kullanımı​

+ System Prompt Ekle butonuna tıklayarak modele rol ve kural verebilirsiniz. Sorgu alanı "ne yapılacağını", System Prompt "nasıl yapılacağını" tanımlar.

İyi Bir System Prompt​

Ne yazılırÖrnek
RolSen bir finansal rapor analistisin.
DilYanıtlarını her zaman Türkçe ver.
FormatÖnce 3 maddelik özet, sonra tablo ver.
UzunlukYanıtlarını 200 kelimeyi geçmeyecek şekilde yaz.
SınırlarVeride olmayan bilgi üretme. Emin değilsen "bilgi yok" de.

Örnek System Prompt​

Sen bir müşteri geri bildirimi sınıflandırma asistanısın.
Gelen her metni şu kategorilerden birine ata: Şikayet, Öneri, Övgü, Soru.
Yanıt olarak yalnızca kategori adını döndür. Açıklama yazma.

Not: Sınıflandırma gibi işlerde System Prompt'ta "yalnızca kategori adını döndür" gibi net bir format kuralı yazmak, sonraki düğümlerin çıktıyı işlemesini kolaylaştırır.

Araçlar (Tools) Kullanımı​

Araçlar bölümünü açtığınızda, modelin gerektiğinde otomatik olarak çağırabileceği araçları seçebilirsiniz.

Nasıl Çalışır​

  1. Araçlar başlığına tıklayarak bölümü açın.
  2. Listeden eklemek istediğiniz aracın yanındaki + işaretine tıklayın.
  3. Araç "Bağlantı gerekli" diyorsa ilgili uygulama bağlantısını kurun.

Model, sorgunuzu yanıtlarken bu araca ihtiyaç duyarsa kendisi çağırır ve sonucu yanıtına dahil eder.

Kullanım Örneği​

Sorguya "Ahmet'ten gelen son maili özetle" yazdığınızda, Outlook Mail Search aracı ekliyse model önce maili arar, bulur ve ardından özetler.

Not: Araç eklemek modeli yavaşlatır ve maliyeti artırır. Yalnızca gerçekten gerekli araçları ekleyin.

Sorgu Alanına Veri Aktarma​

Sorgu alanının sağındaki "/ ile parametre ekleyin" yazısı, önceki düğüm çıktılarını ekleyebileceğinizi gösterir.

Yöntemler​

YöntemNasıl yapılır
Menüden seçmeAlana tıklayın, / tuşuna basın, listeden çıktıyı seçin
Elle yazma{{output.data.answer}} biçiminde doğrudan yazın

Sabit metinle birleştirme​

Aşağıdaki toplantı notunu 5 maddede özetle:

{{output.text}}

Ortak Model Parametreleri​

GOAT, BYOK ve BYOM düğümlerinde istek metni Sorgu yerine Message (bazı işlemlerde Prompt, Query veya Input Text(s)) alanına yazılır. Bu alanlarda da / yazarak önceki düğüm çıktısını ekleyebilirsiniz. Aşağıdaki parametreler bu düğümlerin sohbet işlemlerinde tekrar eder:

ParametreAçıklama
Message / PromptModelin yanıtlayacağı ana istek. Sabit metin yazılabilir veya / ile önceki düğümden değer bağlanabilir.
System PromptModelin rolünü, dilini, tonunu ve çıktı kurallarını tanımlayan talimat. Çoğu düğümde zorunlu değildir ancak tutarlı sonuç için önerilir.
TemperatureYanıtların ne kadar değişken/yaratıcı olacağını belirleyen değer (genellikle 0–1 aralığında). Düşük değer daha tutarlı, yüksek değer daha yaratıcı sonuç üretir.
Max TokensÜretilecek yanıtın en yüksek uzunluğu. Boş bırakılırsa sağlayıcının/platformun varsayılan sınırı kullanılır.
JSON OutputYanıtın yapılandırılmış JSON olarak dönmesini sağlar. Yalnızca bu özelliği destekleyen modellerde kullanılabilir; sonraki düğüm JSON beklemiyorsa kapalı bırakılmalıdır.

Not: Temperature ve Max Tokens gibi sayısal alanlar boş bırakıldığında modelin veya sağlayıcının varsayılan değeri kullanılır. Üretim ortamına alınan iş akışlarında bu değerlerin açıkça belirtilmesi, sonuçların tutarlılığı açısından önerilir.

GOAT​

GOAT, SkyStudio içinde doğrudan kullanılabilen yerleşik sohbet modelidir. Harici bir sağlayıcı hesabı veya API anahtarı gerektirmeden temel metin üretimi, soru-cevap, özetleme, taslak oluşturma ve sınıflandırma akışlarında kullanılabilir.

Bağlantı Kurulumu ve Yönetimi​

GOAT düğümü bağlantı gerektirmez. Düğümü canvas’a ekledikten sonra sağ panelde “Uygulama Bağlantıları” alanı görünmez; doğrudan parametreleri doldurabilirsiniz.

Operasyonlar​

GOAT düğümü tek bir operasyon sunar:

OperasyonAçıklama
SohbetVerilen mesajı GOAT modeline gönderir ve metin yanıtı üretir

Sohbet​

Bu operasyon, verilen mesajı GOAT modeline gönderir ve metin yanıtı üretir.

Parametreler​

ParametreZorunluAçıklama
Düğüm AdıHayırWorkflow içinde düğümü tanımayı kolaylaştıran isim (örn. Ürün Açıklaması Oluştur, Destek Yanıtı)
İşlem seçinEvetSohbet seçilir
MessageEvetModelin yanıtlayacağı ana istek. Sabit metin yazılabilir veya Metin Girişi düğümünden gelen değer / ile eklenebilir
System PromptHayırModelin davranışını tanımlar; yanıt biçimini kontrol etmek için kullanılması önerilir
TemperatureHayırYanıtların yaratıcılık düzeyini belirler (aşağıdaki rehbere bakın)
Max TokensHayırYanıtın en yüksek uzunluğu; boş bırakılırsa platformun varsayılan sınırı kullanılır

Message Örneği​

Aşağıdaki müşteri mesajına nazik ve kısa bir yanıt yaz:
/

Buradaki / ile Metin Girişi düğümünün çıktısı seçilir.

System Prompt Örneği​

Sen bir müşteri destek uzmanısın. Türkçe yaz. Kesin olmayan bilgi verme. Yanıtın en fazla üç cümle olsun.

Temperature Rehberi​

AralıkSonuç
0–0,3Daha tutarlı, net ve kontrollü yanıtlar
0,4–0,7Genel kullanım için dengeli sonuçlar
0,8–1Daha yaratıcı ve çeşitli sonuçlar

Özet, sınıflandırma ve destek yanıtlarında 0,2–0,5; fikir üretimi ve pazarlama metinlerinde 0,7 civarı önerilir.

Düğüm Bağlantıları​

Gelen bağlantı olarak Metin Girişi seçilir. Sonraki düğüm olarak Metin Çıktısı seçilir.

Örnek Çıktı​

{
"response": "Merhaba, yaşadığınız sorun için özür dileriz. Talebiniz ekibimize iletildi ve en kısa sürede size dönüş yapılacaktır.",
"model": "goat",
"tokens_used": 42
}

GOAT ile Örnek Workflow​

Metin Girişi → GOAT / Sohbet → Metin Çıktısı
  1. Metin Girişi düğümüne örneğin Yapay zekâ destekli müşteri hizmetleri nedir? yazılır.
  2. GOAT düğümünde Message alanına / ile Metin Girişi değeri eklenir.
  3. System Prompt alanına istenen yanıt biçimi yazılır.
  4. GOAT düğümünün sonraki bağlantısı Metin Çıktısı yapılır.
  5. Workflow kaydedilir ve çalışma ekranındaki çalıştırma eylemi başlatılır.
  6. Sonuç, Metin Çıktısı düğümünde görüntülenir.

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
Boş yanıt dönüyorMessage alanı boş veya yalnızca boşluk karakteri içeriyorMessage alanına geçerli bir metin girildiğinden veya / ile bağlanan değerin boş olmadığından emin olun
Yanıt yarıda kesiliyorMax Tokens değeri çok düşük ayarlanmışMax Tokens değerini artırın veya alanı boş bırakarak varsayılanı kullanın
Yanıt beklenenden farklı üsluptaSystem Prompt tanımlanmamışSystem Prompt alanına rol, dil ve ton talimatı ekleyin
Model zaman aşımına uğruyorİstek çok uzun veya sunucu yoğunluğu varMessage uzunluğunu kısaltın, workflow’u tekrar çalıştırın

Notlar​

  • GOAT, harici bir hesap gerektirmediği için hızlı prototipleme ve test senaryolarında ilk tercih olarak kullanılabilir.
  • Yüksek hacimli veya çok özel alan (domain) bilgisi gerektiren senaryolarda BYOK/BYOM sağlayıcılarından birine geçmeniz önerilir.
  • System Prompt boş bırakıldığında modelin varsayılan, genel amaçlı davranışı geçerli olur.

BYOK — Kendi API Anahtarınla Sağlayıcı Kullanımı​

BYOK (Bring Your Own Key), kendi sağlayıcı hesabınızı ve API anahtarınızı SkyStudio’ya bağlayarak model kullanmanızı sağlar. Anahtar ilgili sağlayıcıdan alınır, SkyStudio’daki Uygulama Bağlantıları alanında güvenli bir bağlantı olarak eklenir ve ardından ilgili LLM düğümünde seçilir. Kullanım ve maliyet, bağlanan hesabın kendi sağlayıcı planına göre faturalandırılır; SkyStudio yalnızca bağlantıyı aracılık eder.

Genel Kurulum Süreci​

Her BYOK düğümünde ortak olarak şu adımlar izlenir:

  1. Sağlayıcıdan bir API anahtarı alınır.
  2. SkyStudio’da ilgili sağlayıcı için bir Uygulama Bağlantısı oluşturulur (Uygulama Bağlantıları → Yeni Bağlantı Ekle → Sağlayıcı seçilir → Bağlantı Adı ve API Key girilir → Kaydedilir).
  3. Bağlantı oluşturulurken Kimler kullanabilir alanından erişim düzeyi belirlenir (Sadece ben / Çalışma alanı / Seçili kullanıcılar / Entegrasyonlar).
  4. Düğümde Uygulama Bağlantıları açılır menüsünden kaydedilen bağlantı seçilir.
  5. Connection alanından kullanılacak bağlantı belirlenir (birden fazla bağlantı varsa).
  6. Model ve işlem (operasyon) alanları doldurulur.
  7. Metin Girişi düğümü LLM düğümüne; LLM düğümü de Metin Çıktısı’na (veya ilgili sonraki düğüme) bağlanır.
  8. Workflow çalıştırılır ve düğüm sonucu kontrol edilir.

Önemli: API anahtarları yalnızca bağlantı alanına girilmelidir. Message, System Prompt, Prompt veya diğer metin alanlarına asla yazılmamalıdır; bu alanlar workflow geçmişinde ve loglarda görünür hâle gelebilir.

Not: Her sağlayıcı bağlantısı, o sağlayıcının kendi API anahtarıyla çalışır. Farklı ortamlar (test/üretim) veya farklı ekipler için aynı sağlayıcıda birden fazla bağlantı tanımlayabilirsiniz.

Mistral AI​

Mistral AI; sohbet, embedding, belge okuma (OCR), kod tamamlama ve içerik denetimi işlemlerinde kullanılabilen çok işlevli bir model sağlayıcısıdır.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. Mistral AI hesabınıza giriş yapın.
  2. İlgili çalışma alanını (workspace) seçin.
  3. Sol menüden API Keys sayfasına gidin.
  4. Create new key butonuna tıklayarak yeni bir anahtar oluşturun.
  5. Oluşturulan anahtarı hemen kopyalayın.

Not: Anahtar yalnızca ilk oluşturulduğu anda tam olarak gösterilebilir; kaydetmeyi unutursanız yeni bir anahtar oluşturmanız gerekir. Resmî yönlendirme: Mistral API keys.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Mistral AI seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Mistral)
API KeyEvetMistral API Keys sayfasından kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Mistral AI düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Mistral AI düğümü 5 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme, soru yanıtlama, özetleme ve içerik yazımı
Embedding ÜretÖne ÇıkanMetni sayısal vektöre dönüştürür
OCR / Belge OkuÖne ÇıkanPDF, görsel veya belge içeriğinden metin çıkarır
Kod Tamamlama (FIM)StandartKod parçasının eksik bölümünü tamamlar
İçerik DenetimiStandartMetni politika ve güvenlik açısından değerlendirir

Sohbet​

Metin üretme, soru yanıtlama, özetleme, içerik yazımı ve bilgi çıkarma için kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Mistral AI bağlantısı
ModelEvetAçılır listeden kullanılacak Mistral sohbet modeli seçilir
MessageEvetModelin yanıtlayacağı kullanıcı isteği. Metin Girişi düğümünden gelen içerik kullanılacaksa / ile ilgili değer seçilir
System PromptHayırModelin rolünü, dilini, tonunu ve çıktı kurallarını tanımlar
TemperatureHayırDengeli sonuç için 0,7; daha kontrollü sonuç için daha düşük değer kullanılır
Max TokensHayırYanıtın en yüksek uzunluğunu belirler
JSON OutputHayırYanıtın yapılandırılmış JSON olarak dönmesi gerekiyorsa etkinleştirilir; sonraki düğüm JSON beklemiyorsa kapalı bırakılmalıdır

Örnek Workflow​

Metin Girişi → Mistral AI / Sohbet → Metin Çıktısı

Metin Girişi’ne müşteri sorusu yazılır. Mistral Sohbet düğümünde Message alanına bu değer bağlanır. Sonraki düğüm Metin Çıktısı seçilir. Workflow çalıştırıldığında yanıt Metin Çıktısı’nda görünür.

Örnek Çıktı​

{
"response": "İade süreciniz 14 gün içinde tamamlanır. Ek bir belge yüklemenize gerek yoktur.",
"model": "mistral-large-latest",
"finish_reason": "stop",
"usage": { "prompt_tokens": 28, "completion_tokens": 19 }
}

Embedding Üret​

Metni sayısal vektöre dönüştürür. Benzerlik arama, doküman eşleştirme, RAG (Retrieval-Augmented Generation) ve anlamsal arama senaryolarında kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Mistral AI bağlantısı
ModelEvetEmbedding destekleyen Mistral modeli seçilir
Input Text(s)EvetVektöre dönüştürülecek metin. Tek metin yazılabilir veya her satıra ayrı bir metin girilebilir. Dinamik metin için / ile önceki düğümden gelen değer seçilir

Örnek Kullanım​

Metin Girişi → Mistral AI / Embedding Üret → Sonraki vektör veya arama düğümü

Bu düğümün çıktısı normal kullanıcı metni yerine embedding verisidir. Bu nedenle doğrudan Metin Çıktısı’na bağlamak yerine, embedding kabul eden bir arama veya veri düğümüne bağlanması daha uygundur.

Örnek Çıktı​

{
"embeddings": [
{ "index": 0, "vector": [0.0123, -0.0456, 0.0789, "..."], "dimensions": 1024 }
],
"model": "mistral-embed"
}

OCR / Belge Oku​

PDF, görsel veya belge içeriğinden metin ve yapılandırılmış bilgi çıkarmak için kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Mistral AI bağlantısı
ModelEvetBelge veya görsel anlama destekleyen model seçilir
Document TypeEvetGönderilen dosyanın türü seçilir (örn. PDF, görsel)
Document / Image URLEvetBelgenin erişilebilir bağlantısı. URL kullanılabilir veya desteklenen durumda data:application/pdf;base64,... biçiminde Base64 veri gönderilebilir
Include ImagesHayırBelgedeki görsellerin de analiz edilip edilmeyeceğini belirler; görsellerdeki tablo, diyagram veya metin önemliyse etkinleştirilir

Örnek Workflow​

Belge URL'si içeren Metin Girişi → Mistral AI / OCR - Belge Oku → Metin Çıktısı

Metin Girişi’nden gelen belge URL’si, / ile Document / Image URL alanına eklenir. Sonuç, belge içeriği olarak Metin Çıktısı’nda görüntülenir.

Örnek Çıktı​

{
"text": "FATURA\nTarih: 01.08.2026\nToplam Tutar: 12.500 TL\n...",
"pages": 1,
"model": "mistral-ocr-latest"
}

Kod Tamamlama (FIM)​

FIM, “fill in the middle” (ortayı doldurma) anlamına gelir. Bir kod parçasının eksik bölümünü tamamlamak için kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Mistral AI bağlantısı
ModelEvetKod tamamlama destekleyen Mistral modeli seçilir
Prompt (Prefix)EvetEksik kısmın öncesindeki kod
SuffixHayırEksik kısmın sonrasında gelen kod; modelin hangi noktaya kadar kod yazacağını daha iyi anlamasını sağlar
Max TokensHayırTamamlanacak kodun uzunluğunu sınırlar

Prompt (Prefix) Örneği​

def hesapla_toplam(urunler):

Örnek Workflow​

Metin Girişi → Mistral AI / Kod Tamamlama (FIM) → Metin Çıktısı

Metin Girişi’nden gelen kod başlangıcı Prefix alanına bağlanır. Model kodu tamamlar; sonuç Metin Çıktısı’nda görüntülenir.

Örnek Çıktı​

{
"completion": "\n toplam = 0\n for urun in urunler:\n toplam += urun['fiyat'] * urun['adet']\n return toplam",
"model": "codestral-latest"
}

İçerik Denetimi​

Metnin politika, güvenlik veya istenmeyen içerik bakımından değerlendirilmesi için kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Mistral AI bağlantısı
ModelEvetİçerik denetimi destekleyen model seçilir
Text to ModerateEvetKontrol edilecek metin. Genellikle Metin Girişi düğümünden / ile alınır

Örnek Workflow​

Metin Girişi → Mistral AI / İçerik Denetimi → Metin Çıktısı

Çıktı, metnin denetim sonucunu içerir. Bu sonuç, sonraki adımda bir If-Else Koşulu ile birlikte koşullu yönlendirme için de kullanılabilir (örn. uygunsuz içerik tespit edilirse mesajı reddet).

Örnek Çıktı​

{
"flagged": false,
"categories": {
"hate": false,
"violence": false,
"self_harm": false,
"sexual": false
}
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersiz veya yanlış girilmişMistral API Keys sayfasından anahtarı kontrol edin, gerekirse yeniden oluşturun
429 Too Many RequestsSağlayıcı hız/istek limiti aşıldıİstekler arasına gecikme ekleyin veya plan limitinizi yükseltin
Model not foundSeçilen model hesabınızda erişime kapalı veya adı değişmişModel listesini güncel Mistral dokümantasyonundan doğrulayın
Context length exceededMessage veya Document içeriği modelin bağlam sınırını aşıyorGirdi metnini kısaltın veya daha yüksek bağlam limitli bir model seçin
Boş embedding sonucuInput Text(s) alanı boş gönderilmişInput Text(s) alanının doldurulduğundan emin olun

Notlar​

  • Mistral AI hesabınızın kullanım kotası ve faturalandırması Mistral platformu üzerinden yönetilir; SkyStudio yalnızca API çağrılarını aracılık eder.
  • OCR / Belge Oku operasyonunda büyük PDF dosyalarında işlem süresi uzayabilir; mümkünse yalnızca ilgili sayfaları içeren dosyalar gönderin.
  • Kod Tamamlama (FIM) operasyonu, kod editörü entegrasyonlarını taklit eden otomasyonlar için uygundur; Suffix alanının doldurulması sonuç kalitesini artırır.

DeepSeek​

DeepSeek; özellikle sohbet ve kod tamamlama senaryolarında kullanılan, maliyet-performans dengesiyle öne çıkan bir model sağlayıcısıdır.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. DeepSeek Platform hesabınıza giriş yapın.
  2. Sol menüden API Keys bölümüne gidin.
  3. Create new API key butonuna tıklayın.
  4. Oluşturulan anahtarı kopyalayıp güvenli bir yerde saklayın.

Not: Resmî API dokümantasyonu: DeepSeek API.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak DeepSeek seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket DeepSeek)
API KeyEvetDeepSeek Platform’dan kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

DeepSeek düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

DeepSeek düğümü 2 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme ve soru yanıtlama
Kod Tamamlama (FIM)StandartKod parçasının eksik bölümünü tamamlar

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak DeepSeek bağlantısı
ModelEvetAçılır listeden kullanılacak DeepSeek modeli seçilir
MessageEvetModelin yanıtlayacağı istek. Kullanıcı girdisi için / ile Metin Girişi bağlanır
System PromptHayırModelin davranışını tanımlar
TemperatureHayırDaha kesin sonuçlar için düşürülür, yaratıcı metinler için artırılır
Max TokensHayırYanıt uzunluğu sınırıdır
JSON OutputHayırYapılandırılmış çıktı gerektiğinde kullanılır

Örnek Workflow​

Metin Girişi → DeepSeek / Sohbet → Metin Çıktısı

Metin Girişi’ndeki soru, DeepSeek Message alanına bağlanır. Çıktı Metin Çıktısı düğümünde görülür.

Örnek Çıktı​

{
"response": "Zaman serisi tahmininde ARIMA ve Prophet en sık kullanılan yöntemlerdir.",
"model": "deepseek-chat",
"usage": { "prompt_tokens": 15, "completion_tokens": 22 }
}

Kod Tamamlama (FIM)​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak DeepSeek bağlantısı
ModelEvetKod tamamlama için uygun DeepSeek modeli seçilir
Prompt (Prefix)EvetEksik kodun öncesi
SuffixHayırEksik kodun sonrası; modelin tamamlamayı doğru yerde bitirmesine yardımcı olur
Max TokensHayırÜretilecek kod uzunluğunu sınırlar

Örnek Workflow​

Metin Girişi → DeepSeek / Kod Tamamlama (FIM) → Metin Çıktısı

Örnek Çıktı​

{
"completion": "\n return sum(u['fiyat'] * u['adet'] for u in urunler)",
"model": "deepseek-coder"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizDeepSeek Platform’dan anahtarı kontrol edin
402 Insufficient BalanceHesap bakiyesi/kredisi yetersizDeepSeek Platform’da bakiye yükleyin
429 Too Many Requestsİstek limiti aşıldıİstekler arasına gecikme ekleyin
Context length exceededGirdi modelin bağlam sınırını aşıyorMessage veya Prompt içeriğini kısaltın

Notlar​

  • DeepSeek modelleri, maliyet açısından hassas yüksek hacimli workflow’lar için uygun bir seçenektir.
  • Kod Tamamlama (FIM) operasyonu, deepseek-coder ailesi modellerle en iyi sonucu verir.

Groq​

Groq, hızlı model çıkarımı (inference) sağlayan bir platformdur. Düşük gecikmeli sohbet, destek botu ve hızlı metin işleme akışlarında tercih edilir.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. Groq Console hesabınıza giriş yapın.
  2. İlgili projeyi seçin.
  3. API Keys alanından Create API Key butonuna tıklayın.
  4. Oluşturulan anahtarı kopyalayın.

Not: Groq anahtarları proje bazlıdır; farklı projeler için ayrı anahtar oluşturmanız gerekir.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Groq seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Groq)
API KeyEvetGroq Console’dan kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Groq düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Groq düğümü tek bir operasyon sunar:

OperasyonAçıklama
SohbetDüşük gecikmeli metin üretimi ve soru yanıtlama

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Groq bağlantısı
ModelEvetKullanılacak Groq modeli seçilir
MessageEvetYanıtlanacak istek. Metin Girişi kullanılıyorsa / ile eklenir
System PromptHayırAsistanın rolünü ve yanıt kurallarını tanımlar
TemperatureHayırYanıt çeşitliliğini belirler
Max TokensHayırEn yüksek yanıt uzunluğunu belirler

Örnek Workflow​

Metin Girişi → Groq / Sohbet → Metin Çıktısı

Örneğin Metin Girişi’ne destek talebi yazılır; Groq modelinden kısa, Türkçe ve profesyonel bir yanıt istenir. Workflow çalıştırıldıktan sonra Metin Çıktısı kontrol edilir.

Örnek Çıktı​

{
"response": "Talebiniz alınmıştır, en geç 24 saat içinde size dönüş yapılacaktır.",
"model": "llama-3.3-70b-versatile",
"latency_ms": 180
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersiz veya proje değişmişGroq Console’dan yeni bir anahtar oluşturun
429 Too Many RequestsDakikalık/günlük istek limiti aşıldıİstek sıklığını azaltın veya plan limitinizi kontrol edin
Model decommissionedSeçilen model artık desteklenmiyorGroq Console’dan güncel model listesini kontrol edin

Notlar​

  • Groq, aynı model ailesinde diğer sağlayıcılara göre belirgin şekilde daha düşük yanıt süresi sunar; gerçek zamanlı sohbet botlarında tercih edilebilir.
  • Bazı modeller belirli bir süre sonra kullanımdan kaldırılabilir (decommission); workflow’larınızı periyodik olarak Groq’un güncel model listesiyle karşılaştırmanız önerilir.

xAI (Grok)​

xAI, Grok modellerini sunar. Sohbet ve görsel üretim işlemleri için kullanılabilir.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. xAI Console hesabınıza giriş yapın.
  2. API Keys bölümüne gidin.
  3. Yeni bir anahtar oluşturun ve kopyalayın.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak xAI (Grok) seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket xAI)
API KeyEvetxAI Console’dan kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

xAI (Grok) düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

xAI (Grok) düğümü 2 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme ve soru yanıtlama
Görsel ÜretStandartMetin açıklamasından görsel üretir

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak xAI bağlantısı
ModelEvetKullanılacak Grok modeli seçilir
MessageEvetKullanıcı isteği girilir veya / ile Metin Girişi bağlanır
System PromptHayırYanıtın rolünü, tonunu ve sınırlarını belirler
TemperatureHayırYaratıcılık düzeyidir
Max TokensHayırYanıt uzunluğu sınırıdır

Örnek Workflow​

Metin Girişi → xAI (Grok) / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Rakip analiz raporunuzda üç ana bulgu öne çıkıyor: fiyat, teslimat süresi ve müşteri desteği.",
"model": "grok-4"
}

Görsel Üret​

Metin açıklamasından görsel üretmek için kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak xAI bağlantısı
ModelEvetGörsel üretim destekleyen model seçilir
PromptEvetOluşturulacak görselin ayrıntılı açıklaması
Number of ImagesHayırKaç görsel üretileceğini belirler; başlangıç için 1 kullanılması önerilir

Prompt Örneği​

Modern bir teknoloji ofisinde çalışan ekip, doğal ışık, kurumsal ve gerçekçi fotoğraf stili

Örnek Workflow​

Metin Girişi → xAI (Grok) / Görsel Üret → Görseli kabul eden çıktı veya sonraki düğüm

Prompt, Metin Girişi’nden alınır. Workflow çalıştırıldıktan sonra görsel üretim sonucunun ilgili çıktı düğümünde veya düğüm sonucunda oluştuğu kontrol edilir.

Örnek Çıktı​

{
"images": [
{ "url": "https://cdn.x.ai/generated/img_8f21ac.png", "index": 0 }
],
"model": "grok-image"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizxAI Console’dan anahtarı yenileyin
429 Too Many Requestsİstek limiti aşıldıİstekler arasına gecikme ekleyin
Görsel üretilmiyorPrompt çok kısa veya belirsizPrompt’u konu, stil, kompozisyon detaylarıyla zenginleştirin
Content policy violationİstenen görsel içerik politikasına aykırıPrompt’u politika ile uyumlu hâle getirin

Notlar​

  • Görsel Üret operasyonunda Prompt ne kadar ayrıntılı olursa (konu, stil, ışık, kompozisyon, istenmeyen unsurlar), üretilen görsel o kadar isteğe uygun olur.
  • Number of Images alanı yüksek tutulduğunda işlem süresi ve maliyet artar; ilk denemelerde 1 ile başlayın.

Together AI​

Together AI, farklı açık kaynak modelleri sohbet, embedding ve görsel üretim için erişilebilir hâle getirir.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. Together AI hesabınıza giriş yapın.
  2. Ayarlar altındaki API Keys bölümüne gidin.
  3. Yeni bir anahtar oluşturun ve kopyalayın.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Together AI seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Together AI)
API KeyEvetTogether AI ayarlarından kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Together AI düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Together AI düğümü 3 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme ve soru yanıtlama
Embedding ÜretStandartMetni sayısal vektöre dönüştürür
Görsel Üret (FLUX)StandartFLUX modeliyle metinden görsel üretir

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Together AI bağlantısı
ModelEvetKullanılacak sohbet modeli seçilir
MessageEvetModelin yanıtlayacağı içerik
System PromptHayırModelin davranışını belirler
TemperatureHayırYaratıcılık düzeyidir
Max TokensHayırYanıt uzunluğu sınırıdır

Örnek Workflow​

Metin Girişi → Together AI / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Açık kaynak modeller, özelleştirme ve maliyet kontrolü açısından esneklik sağlar.",
"model": "meta-llama/Llama-3.3-70B-Instruct-Turbo"
}

Embedding Üret​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Together AI bağlantısı
ModelEvetEmbedding modeli seçilir
Input Text(s)EvetVektöre dönüştürülecek metinler; her satır ayrı metin olabilir

Örnek Workflow​

Metin Girişi → Together AI / Embedding Üret → Vektör arama düğümü

Örnek Çıktı​

{
"embeddings": [
{ "index": 0, "vector": [0.0211, -0.0187, "..."], "dimensions": 768 }
],
"model": "togethercomputer/m2-bert-80M-8k-retrieval"
}

Görsel Üret (FLUX)​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Together AI bağlantısı
ModelEvetFLUX veya kullanılabilir başka bir görsel üretim modeli seçilir
PromptEvetÜretilecek görselin ayrıntılı açıklaması
WidthHayırGörsel genişliği (varsayılan: 1024)
HeightHayırGörsel yüksekliği (varsayılan: 1024)
StepsHayırÜretim adımı sayısı; değer yükseldikçe işlem süresi artabilir (başlangıç değeri: 4)

Örnek Workflow​

Metin Girişi → Together AI / Görsel Üret (FLUX) → Görsel çıktı düğümü

Örnek Çıktı​

{
"images": [
{ "url": "https://together.ai/generated/flux_3a91.png", "width": 1024, "height": 1024 }
],
"model": "black-forest-labs/FLUX.1-schnell"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizTogether AI ayarlarından anahtarı yenileyin
429 Too Many Requestsİstek limiti aşıldıİstekler arasına gecikme ekleyin
Model not availableSeçilen model hesap planınızda desteklenmiyorTogether AI model kataloğundan erişilebilir bir model seçin
Görsel boş/bozuk dönüyorWidth/Height değeri modelin desteklediği aralığın dışındaModelin dokümantasyonundaki önerilen boyutları kullanın

Notlar​

  • Together AI, çok sayıda açık kaynak modeli tek bir bağlantı üzerinden sunar; model seçimini iş ihtiyacına göre (hız, maliyet, kalite) karşılaştırarak yapın.
  • Steps değeri arttıkça görsel kalitesi genellikle artar, ancak işlem süresi ve maliyet de artar; hızlı taslaklar için düşük Steps değeri yeterlidir.

Perplexity​

Perplexity, web araması destekli sohbet senaryolarında kullanılır. Güncel bilgi gerektiren araştırma, kaynak tarama ve özetleme işlerinde tercih edilir.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. Perplexity hesabınıza giriş yapın.
  2. Ayarlar altındaki API bölümüne gidin.
  3. Yeni bir anahtar oluşturun ve kopyalayın.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Perplexity seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Perplexity)
API KeyEvetPerplexity ayarlarından kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Perplexity düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Perplexity düğümü tek bir operasyon sunar:

OperasyonAçıklama
Sohbet (Web Aramalı)Web araması destekli, güncel bilgiye dayalı yanıt üretir

Sohbet (Web Aramalı)​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Perplexity bağlantısı
ModelEvetKullanılacak Perplexity modeli seçilir
MessageEvetAraştırılacak soru veya istek
System PromptHayırYanıtın dili, biçimi ve kaynak kullanımına dair kurallar
TemperatureHayırYanıt çeşitliliğini belirler
Max TokensHayırYanıt uzunluğu sınırıdır

Örnek Workflow​

Metin Girişi → Perplexity / Sohbet (Web Aramalı) → Metin Çıktısı

Metin Girişi’ne güncel araştırma sorusu yazılır. Model çalıştırılır ve yanıt Metin Çıktısı’nda görüntülenir. Güncel bilgi gerektiği için sonuçta kaynakların ayrıca kontrol edilmesi önerilir.

Örnek Çıktı​

{
"response": "2026 itibarıyla sektördeki en büyük üç oyuncu ... (kaynaklara bakınız)",
"citations": [
"https://ornek-kaynak1.com/rapor",
"https://ornek-kaynak2.com/analiz"
],
"model": "sonar-pro"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizPerplexity ayarlarından anahtarı yenileyin
429 Too Many Requestsİstek limiti aşıldıİstekler arasına gecikme ekleyin
Kaynak (citation) dönmüyorSeçilen model web araması desteklemiyorWeb aramasını destekleyen bir Perplexity modeli (örn. sonar ailesi) seçin
Güncel olmayan yanıtSorgu belirsiz veya tarih aralığı belirtilmemişMessage içine zaman aralığı veya bağlam ekleyin

Notlar​

  • Perplexity yanıtları web kaynaklarına dayandığından, kritik kararlarda dönen kaynakların (citations) ayrıca doğrulanması önerilir.
  • Güncel olay, fiyat, mevzuat gibi zamana duyarlı sorular için diğer sağlayıcılara kıyasla daha güvenilir sonuç verir.

Cohere​

Cohere; sohbet, embedding ve belge yeniden sıralama (rerank) işlemleri için kullanılır.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. Cohere Dashboard hesabınıza giriş yapın.
  2. API Keys bölümüne gidin.
  3. Yeni bir anahtar oluşturun ve kopyalayın.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Cohere seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Cohere)
API KeyEvetCohere Dashboard’dan kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Cohere düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Cohere düğümü 3 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme ve soru yanıtlama
Embedding ÜretStandartMetni sayısal vektöre dönüştürür
Belge Yeniden SıralaStandartBir arama sorgusuna en uygun belgeleri sıralar

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Cohere bağlantısı
ModelEvetKullanılacak Cohere sohbet modeli seçilir
MessageEvetModelin yanıtlayacağı istek
System PromptHayırRol, dil ve çıktı kuralları
TemperatureHayırYanıt çeşitliliği
Max TokensHayırYanıt uzunluğu sınırıdır

Örnek Workflow​

Metin Girişi → Cohere / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Rerank ve embedding birlikte kullanıldığında arama ilgisi belirgin şekilde artar.",
"model": "command-r-plus"
}

Embedding Üret​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Cohere bağlantısı
ModelEvetEmbedding modeli seçilir
Input TypeEvetMetnin hangi amaçla işlendiğini belirtir. Arama sorgusu ve doküman içeriği için sağlayıcının önerdiği uygun tür seçilmelidir
Input Text(s)EvetVektöre dönüştürülecek bir veya daha fazla metin; her satır ayrı metin olabilir

Örnek Workflow​

Metin Girişi → Cohere / Embedding Üret → Vektör arama düğümü

Örnek Çıktı​

{
"embeddings": [
{ "index": 0, "vector": [0.0342, -0.0119, "..."], "dimensions": 1024 }
],
"model": "embed-multilingual-v3.0"
}

Belge Yeniden Sırala​

Bir arama sorgusuna en uygun belgeleri seçmek ve sıralamak için kullanılır.

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Cohere bağlantısı
ModelEvetRerank destekleyen Cohere modeli seçilir
QueryEvetKullanıcının arama sorusu
Documents (JSON)EvetSıralanacak belgeler, JSON dizi biçiminde
Top NHayırDöndürülecek en iyi belge sayısı (varsayılan: 5)

Query Örneği​

İade süresi kaç gündür?

Documents (JSON) Örneği​

["İade süresi teslim tarihinden itibaren 14 gündür.", "Kargo teslimatı 2-4 iş günü sürer."]

Örnek Workflow​

Metin Girişi → Cohere / Belge Yeniden Sırala → Metin Çıktısı

Metin Girişi, Query alanına bağlanır. Documents alanına değerlendirilecek doküman listesi girilir. Çalıştırma sonrası en uygun belgeler sonuçta görüntülenir.

Örnek Çıktı​

{
"results": [
{ "index": 0, "document": "İade süresi teslim tarihinden itibaren 14 gündür.", "relevance_score": 0.94 },
{ "index": 1, "document": "Kargo teslimatı 2-4 iş günü sürer.", "relevance_score": 0.11 }
]
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizCohere Dashboard’dan anahtarı yenileyin
429 Too Many Requestsİstek limiti aşıldıİstekler arasına gecikme ekleyin
Invalid input_typeEmbedding Üret’te Input Type alanı yanlış seçilmişArama sorgusu için search_query, doküman içeriği için search_document türünü kullanın
Boş rerank sonucuDocuments (JSON) alanı geçersiz format içeriyorJSON dizisinin doğru biçimlendirildiğini (köşeli parantez, tırnak, virgül) kontrol edin

Notlar​

  • Belge Yeniden Sırala operasyonu, klasik anahtar kelime aramasının önüne bir katman olarak eklendiğinde arama sonuçlarının ilgisini belirgin şekilde artırır.
  • Embedding Üret operasyonunda Input Type’ın doğru seçilmesi (sorgu mu, doküman mı) sonuç kalitesini doğrudan etkiler.

Gemini​

Gemini, Google’ın metin ve görsel üretim modellerini kullanmak için eklenir.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. Google AI Studio üzerinden hesabınıza giriş yapın.
  2. Get API key bölümüne gidin.
  3. Yeni bir anahtar oluşturun ve kopyalayın.

Not: Resmî rehber: Gemini API anahtarı oluşturma.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Gemini seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Gemini)
API KeyEvetGoogle AI Studio’dan kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Gemini düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Gemini düğümü 2 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme ve soru yanıtlama
Görsel ÜretStandartMetin açıklamasından görsel üretir

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Gemini bağlantısı
ModelEvetKullanılacak Gemini modeli seçilir
MessageEvetModelin yanıtlayacağı istek
System PromptHayırModelin rolünü, yanıt dilini ve sınırlarını tanımlar
TemperatureHayırYaratıcılık düzeyidir
Max TokensHayırYanıt uzunluğu sınırıdır

Örnek Workflow​

Metin Girişi → Gemini / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Sunum için önerilen yapı: Giriş, Problem, Çözüm, Kanıt, Kapanış.",
"model": "gemini-2.5-pro"
}

Görsel Üret​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Gemini bağlantısı
ModelEvetGörsel üretimi destekleyen Gemini modeli seçilir
PromptEvetGörselin konusu, stili, ışığı, kompozisyonu ve istenmeyen unsurları açıkça yazılır
Number of ImagesHayırÜretilecek görsel sayısı (başlangıç için 1 kullanılır)
Aspect RatioHayırGörsel oranı; kullanım alanına göre seçilir

Aspect Ratio Rehberi​

Kullanım AlanıÖnerilen Oran
Kare sosyal medya gönderisiKare oran
Hikâye veya dikey içerikDikey oran
Kapak veya bannerYatay oran

Örnek Workflow​

Metin Girişi → Gemini / Görsel Üret → Görsel çıktı düğümü

Örnek Çıktı​

{
"images": [
{ "url": "https://generativelanguage.googleapis.com/generated/img_c391.png", "aspect_ratio": "1:1" }
],
"model": "gemini-2.5-flash-image"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizGoogle AI Studio’dan yeni bir anahtar oluşturun
429 Too Many RequestsÜcretsiz plan kotası aşıldıKota sıfırlanmasını bekleyin veya plan yükseltin
Safety filter engellendiİstenen içerik güvenlik politikasına takıldıPrompt’u politika ile uyumlu hâle getirin
Görsel oranı desteklenmiyorSeçilen Aspect Ratio model tarafından desteklenmiyorDesteklenen oranlardan birini seçin

Notlar​

  • Gemini API anahtarları Google hesabınıza bağlıdır; ekip kullanımı için ayrı bir servis hesabı oluşturmanız önerilir.
  • Aspect Ratio, çıktının kullanılacağı mecraya göre (sosyal medya, banner, sunum) önceden planlanmalıdır; sonradan kırpma görsel kalitesini düşürebilir.

OpenRouter​

OpenRouter, farklı sağlayıcıların modellerini tek bağlantı üzerinden kullanmayı sağlar.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı Alma​

  1. OpenRouter Keys sayfasına gidin.
  2. Yeni bir anahtar oluşturun ve kopyalayın.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak OpenRouter seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket OpenRouter)
API KeyEvetOpenRouter Keys sayfasından kopyaladığınız anahtar
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

OpenRouter düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

OpenRouter düğümü tek bir operasyon sunar:

OperasyonAçıklama
SohbetOpenRouter üzerinden erişilebilen herhangi bir modelle metin üretme

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak OpenRouter bağlantısı
ModelEvetModel adı doğrudan sağlayıcı/model-adı biçiminde girilir
MessageEvetModelin yanıtlayacağı istek
System PromptHayırAsistan davranışını tanımlar
TemperatureHayırYanıt çeşitliliğidir
Max TokensHayırYanıt uzunluğu sınırıdır

Model Örnekleri​

anthropic/claude-sonnet-4

veya

deepseek/deepseek-chat

Not: Model adının OpenRouter’daki güncel biçimiyle (sağlayıcı öneki dahil) yazılması gerekir; aksi hâlde Model not found hatası alınır.

Örnek Workflow​

Metin Girişi → OpenRouter / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Karşılaştırmalı analiz için üç senaryo öneriyorum: ...",
"model": "anthropic/claude-sonnet-4",
"provider": "openrouter"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key geçersizOpenRouter Keys sayfasından anahtarı yenileyin
404 Model not foundModel adı yanlış yazılmış veya sağlayıcı öneki eksikModeli sağlayıcı/model-adı biçiminde, güncel OpenRouter kataloğundan doğrulayarak girin
402 Payment requiredHesap bakiyesi yetersizOpenRouter hesabınıza kredi yükleyin
429 Too Many Requestsİstek limiti aşıldıİstekler arasına gecikme ekleyin

Notlar​

  • OpenRouter, tek bir bağlantı ve API anahtarıyla onlarca farklı sağlayıcının modeline erişim sağladığından, model karşılaştırma ve A/B test senaryolarında pratik bir seçenektir.
  • Bazı modeller OpenRouter üzerinden yalnızca belirli bir ödeme yöntemi veya kota ile kullanılabilir; hata alırsanız önce OpenRouter hesap bakiyenizi kontrol edin.

Hugging Face​

Hugging Face, açık kaynak modellerini kullanmak için tercih edilir.

Bağlantı Kurulumu ve Yönetimi​

API Anahtarı (Access Token) Alma​

  1. Hugging Face Access Tokens sayfasına gidin.
  2. New token butonuna tıklayın.
  3. Token’a bir isim verin, gerekli izin kapsamını (en az okuma/çıkarım) seçin.
  4. Oluşturulan token’ı kopyalayın.

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Hugging Face seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Hugging Face)
Access TokenEvetHugging Face ayarlarından kopyaladığınız token
  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Hugging Face düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Hugging Face düğümü tek bir operasyon sunar:

OperasyonAçıklama
SohbetHugging Face üzerinde barındırılan bir modelle metin üretme

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Hugging Face bağlantısı
ModelEvetModel kimliği (repo yolu) doğrudan yazılır
MessageEvetModelin yanıtlayacağı istek
System PromptHayırRol, dil, ton ve çıktı biçimi için kullanılır
TemperatureHayırYaratıcılık düzeyidir
Max TokensHayırYanıt uzunluğu sınırıdır

Model Örneği​

meta-llama/Llama-3.3-70B-Instruct

Not: Kullanılacak modelin Hugging Face üzerinde erişilebilir ve ilgili bağlantı türüyle (Inference API / Inference Endpoints) uyumlu olması gerekir. Bazı modeller kullanım için ayrıca lisans onayı gerektirebilir.

Örnek Workflow​

Metin Girişi → Hugging Face / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Model karşılaştırmasında doğruluk, gecikme ve maliyet birlikte değerlendirilmelidir.",
"model": "meta-llama/Llama-3.3-70B-Instruct"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAccess Token geçersiz veya izin kapsamı yetersizYeni bir token oluşturun, gerekli izin kapsamını seçin
403 Forbidden / Gated modelModel, lisans onayı gerektiren “gated” bir modelHugging Face üzerinde modelin sayfasından erişim talebini onaylayın
503 Model loadingModel ilk kez çağrılıyor ve yükleniyorBirkaç saniye bekleyip isteği tekrar gönderin
404 Model not foundModel kimliği (repo yolu) hatalı yazılmışHugging Face’teki tam repo yolunu (kullanıcı/model-adı) kopyalayın

Notlar​

  • İlk çağrıda model soğuk başlatma (cold start) nedeniyle normalden yavaş yanıt verebilir; bu durum 503 Model loading hatasıyla da görünebilir.
  • Bazı büyük modeller yalnızca ücretli Inference Endpoints planlarında erişilebilir olabilir; ücretsiz Inference API kapsamını Hugging Face üzerinden kontrol edin.

BYOM — Kendi Modelini Bağlama​

BYOM (Bring Your Own Model), kendi model uç noktanızı veya bulut sağlayıcınızdaki özel model dağıtımınızı SkyStudio workflow’unda kullanmanızı sağlar. Bu bölümdeki bağlantı alanları, modelin bulunduğu altyapıya göre değişir (özel uç nokta, Azure kaynak dağıtımı veya AWS Bedrock bölgesi).

Custom Model​

Custom Model, OpenAI uyumlu veya kurum içinde barındırılan özel model uç noktalarına bağlanmak için kullanılır.

Bağlantı Kurulumu ve Yönetimi​

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Custom Model seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Kurum İçi Model)
Base URL / EndpointEvetÖzel uç nokta adresi (örn. https://model.sirketiniz.com/v1)
API KeyHayırUç nokta kimlik doğrulama gerektiriyorsa girilir

Not: Bu bilgiler, modeli barındıran sistemden (OpenAI uyumlu sunucu, kurum içi model sunucusu vb.) alınır.

  1. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Custom Model düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Custom Model düğümü tek bir operasyon sunar:

OperasyonAçıklama
SohbetÖzel uç noktadaki modele istek gönderir

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Custom Model bağlantısı
ModelEvetUç noktanın sunduğu model adı
MessageEvetModelin yanıtlayacağı istek
System PromptHayırModelin rolünü ve davranışını belirler
TemperatureHayırYanıt çeşitliliğidir
Max TokensHayırYanıt uzunluğu sınırıdır

Model Örneği​

company-assistant-v1

Örnek Workflow​

Metin Girişi → Custom Model / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Talebiniz kurum içi bilgi tabanına göre yanıtlanmıştır.",
"model": "company-assistant-v1"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
Connection timeoutBase URL erişilemiyor veya uç nokta ayakta değilUç noktanın çalıştığını ve SkyStudio’nun erişebildiği bir ağda olduğunu doğrulayın
401 UnauthorizedAPI Key gerekiyor ama girilmemiş veya hatalıBağlantıdaki API Key alanını kontrol edin
Model not foundModel adı uç noktada tanımlı değilUç noktanın desteklediği model adını doğrulayın

Notlar​

  • Custom Model, OpenAI Chat Completions API’siyle uyumlu herhangi bir uç noktayla (kurum içi LLM sunucusu, self-hosted açık kaynak model sunucusu vb.) çalışacak şekilde tasarlanmıştır.
  • Uç noktanın herkese açık olmayan bir ağda (VPN, dahili ağ) barındırılması durumunda SkyStudio’nun bu uç noktaya erişebildiğinden emin olun.

Azure OpenAI​

Azure OpenAI, Azure üzerinde oluşturulmuş model dağıtımlarını kullanmak için eklenir.

Bağlantı Kurulumu ve Yönetimi​

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak Azure OpenAI seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket Azure OpenAI)
Azure Resource EndpointEvetAzure kaynağınızın uç nokta adresi (örn. https://sirketiniz.openai.azure.com)
API KeyEvetAzure Portal’daki kaynağınızın Keys and Endpoint bölümünden alınan anahtar
API VersionHayırKullanılacak Azure OpenAI API sürümü
  1. Kaydet butonuna tıklayın.

Not: Bu bilgiler Azure Portal’da ilgili Azure OpenAI kaynağının Keys and Endpoint sayfasından alınır.

Bağlantıyı Düğüme Atama​

Azure OpenAI düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Azure OpenAI düğümü 2 operasyon sunmaktadır:

OperasyonKategoriAçıklama
SohbetÖne ÇıkanMetin üretme ve soru yanıtlama
Embedding ÜretStandartMetni sayısal vektöre dönüştürür

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Azure OpenAI bağlantısı
Deployment NameEvetAzure portalında oluşturduğunuz model dağıtımının adı (modelin genel adı değil, verdiğiniz deployment adı)
MessageEvetModelin yanıtlayacağı istek
System PromptHayırAsistan davranışını tanımlar
TemperatureHayırYaratıcılık düzeyidir
Max TokensHayırYanıt uzunluğu sınırıdır

Deployment Name Örneği​

production-chat-model

Örnek Workflow​

Metin Girişi → Azure OpenAI / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Kurumsal politika gereği, talep önce ilgili departmana yönlendirilmelidir.",
"deployment": "production-chat-model"
}

Embedding Üret​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak Azure OpenAI bağlantısı
Deployment NameEvetAzure’da oluşturulan embedding dağıtımının adı
Input Text(s)EvetEmbedding’e dönüştürülecek metin; tek metin veya satır başına ayrı metin girilebilir

Örnek Workflow​

Metin Girişi → Azure OpenAI / Embedding Üret → Vektör arama düğümü

Örnek Çıktı​

{
"embeddings": [
{ "index": 0, "vector": [0.0156, -0.0298, "..."], "dimensions": 1536 }
],
"deployment": "text-embedding-ada-002"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
401 UnauthorizedAPI Key hatalı veya kaynak eşleşmiyorAzure Portal’dan Keys and Endpoint bilgilerini yeniden kontrol edin
404 Deployment not foundDeployment Name yanlış yazılmış veya dağıtım silinmişAzure OpenAI Studio’dan aktif dağıtımların adını doğrulayın
429 Too Many RequestsDağıtımın rate limit (TPM/RPM) sınırı aşıldıAzure kaynağınızda kota artışı talep edin veya istek sıklığını azaltın
Invalid API VersionAPI Version alanı desteklenmeyen bir değer içeriyorAzure OpenAI dokümantasyonundaki güncel API sürümünü kullanın

Notlar​

  • Azure OpenAI’de model adı yerine Deployment Name kullanılır; bu, aynı modelin farklı adlarla birden fazla dağıtımını (örn. test/üretim) yönetmenizi sağlar.
  • Kurumsal veri saklama ve bölge (region) gereksinimleri olan projelerde Azure OpenAI, verinin Azure kaynağınızın bulunduğu bölgede kalmasını sağlar.

AWS Bedrock​

AWS Bedrock, AWS üzerinden sunulan model ailelerini (Anthropic, Meta, Amazon ve diğerleri) kullanmak için eklenir.

Bağlantı Kurulumu ve Yönetimi​

SkyStudio’ya Bağlantı Ekleme​

  1. SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
  2. Yeni Bağlantı Ekle butonuna tıklayın.
  3. Sağlayıcı olarak AWS Bedrock seçin.
  4. Aşağıdaki alanları doldurun:
AlanZorunluAçıklama
Bağlantı AdıEvetTanımlayıcı bir isim (örn. Şirket AWS Bedrock)
AWS Access Key IDEvetIAM kullanıcısının erişim anahtarı kimliği
AWS Secret Access KeyEvetIAM kullanıcısının gizli erişim anahtarı
AWS RegionEvetBedrock’un etkin olduğu AWS bölgesi (örn. us-east-1)
  1. Kaydet butonuna tıklayın.

Not: Kullanılan IAM kullanıcısının veya rolünün bedrock:InvokeModel iznine sahip olması gerekir. Bağlantı bilgileri AWS hesabınız, seçtiğiniz bölge ve ilgili erişim yetkilerine bağlıdır.

Bağlantıyı Düğüme Atama​

AWS Bedrock düğümünü canvas’a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

AWS Bedrock düğümü tek bir operasyon sunar:

OperasyonAçıklama
SohbetSeçilen Bedrock modeline istek gönderir

Sohbet​

Parametreler​

ParametreZorunluAçıklama
ConnectionEvetKullanılacak AWS Bedrock bağlantısı
Model IDEvetAWS Bedrock model kimliği
MessageEvetModelin yanıtlayacağı istek
System PromptHayırModelin rolünü ve yanıt kurallarını belirler
TemperatureHayırYanıt çeşitliliğidir
Max TokensHayırYanıt uzunluğu sınırıdır

Model ID Örneği​

anthropic.claude-3-5-sonnet-20241022-v2:0

Not: Model ID, seçilen AWS bölgesinde erişime açık olmalıdır; her model her bölgede sunulmayabilir.

Örnek Workflow​

Metin Girişi → AWS Bedrock / Sohbet → Metin Çıktısı

Örnek Çıktı​

{
"response": "Maliyet optimizasyonu için önerilen üç adım: kullanım izleme, otomatik ölçekleme ve rezerve kapasite.",
"model_id": "anthropic.claude-3-5-sonnet-20241022-v2:0"
}

Sık Karşılaşılan Hatalar​

HataOlası NedenÇözüm
AccessDeniedExceptionIAM kullanıcısının/rolünün bedrock:InvokeModel izni yokAWS IAM üzerinden gerekli politikayı ekleyin
ValidationException: model not foundModel ID seçilen bölgede etkin değilAWS Bedrock konsolunda modelin bölgeye göre erişilebilirliğini kontrol edin
ThrottlingExceptionBölgesel istek/throughput limiti aşıldıİstek sıklığını azaltın veya sağlanmış (provisioned) throughput talep edin
UnrecognizedClientExceptionAccess Key ID / Secret Access Key hatalıAWS kimlik bilgilerini yeniden kontrol edin

Notlar​

  • AWS Bedrock’ta bazı modeller kullanılmadan önce AWS konsolunda model erişimi (model access) talebiyle etkinleştirilmelidir; aksi hâlde model bulunsa dahi çağrı reddedilir.
  • Yüksek hacimli, öngörülebilir yük gerektiren üretim workflow’larında sağlanmış throughput (provisioned throughput) kullanmak, ThrottlingException riskini azaltır.

Hızlı Başlangıç Örnekleri​

Örnek 1: Toplantı Notu Özetleme​

Metin Girişi → OpenAI API Çağrısı → Metin Çıktısı

OpenAI API Çağrısı ayarları:

  • Model: GPT-5.4 Mini
  • System Prompt: Toplantı notlarını özetle. Kararları ve aksiyon maddelerini ayrı başlıklarda ver.
  • Sorgu: / ile Metin Girişi çıktısı

Örnek 2: Destek Talebi Sınıflandırma ve Yönlendirme​

Webhook → Anthropic API Çağrısı → If-Else Koşulu ─┬─ Issue Oluştur (Jira)
└─ Mail Gönder (Outlook)

Anthropic API Çağrısı ayarları:

  • System Prompt: Gelen talebi "teknik" veya "genel" olarak sınıflandır. Yalnızca bu kelimelerden birini döndür.
  • Sorgu: / ile webhook gövdesi

Örnek 3: Güncel Bilgiyle Rapor​

Metin Girişi → Claude Web Search → Artifact → Mail Gönder (Outlook)

Örnek 4: Çok Adımlı Analiz​

Uzun bir dokümanı önce özetleyip sonra yorumlayan akış:

Dosya Girişi → Excel Oku → Anthropic API Çağrısı (özetle) → OpenAI API Çağrısı (öneri üret) → Metin Çıktısı

Sağlayıcı Seçim Rehberi​

Hangi ihtiyaç için hangi düğümün daha uygun olabileceğine dair genel bir özet:

İhtiyaçÖnerilen Düğüm(ler)
Genel amaçlı üretim, özet, sınıflandırma (bağlantısız)OpenAI API Çağrısı, Anthropic API Çağrısı, GOAT
Uzun doküman analizi, dikkatli akıl yürütmeAnthropic API Çağrısı (Opus)
Hızlı prototipleme, harici hesap istemeyen basit sohbetGOAT
Güncel, web tabanlı araştırma ve kaynaklı yanıtClaude Web Search, Perplexity
Belge/PDF'den metin çıkarma (OCR)Mistral AI
Anlamsal arama, RAG, benzerlik eşleştirmeMistral AI, Together AI, Cohere, Azure OpenAI (Embedding Üret)
Arama sonuçlarını yeniden sıralama (rerank)Cohere
Düşük gecikmeli, gerçek zamanlı sohbetGroq
Kod tamamlama / IDE benzeri otomasyonMistral AI (Codestral), DeepSeek (deepseek-coder)
Maliyet-performans dengeli yüksek hacimli sohbetDeepSeek, Together AI
Görsel üretimixAI (Grok), Gemini, Together AI (FLUX)
İçerik denetimi / güvenlik kontrolüMistral AI
Tek bağlantıdan birden fazla sağlayıcıyı test etmeOpenRouter
Açık kaynak modellerle özelleştirilmiş kullanımHugging Face, Together AI
Kurumsal veri saklama / bölge gereksinimi olan projelerAzure OpenAI, AWS Bedrock
Kurum içi / self-hosted modelCustom Model

Workflow’u Çalıştırma ve Sonucu Kullanma​

Her sağlayıcı örneği için çalışma mantığı aynıdır:

  1. Metin Girişi düğümüne test edilecek metni yazın.
  2. LLM düğümünde doğru Uygulama Bağlantısı, Connection ve model bilgisinin seçildiğini kontrol edin.
  3. Message, Prompt, Input Text(s) veya ilgili işlem alanına Metin Girişi değerini / ile bağlayın.
  4. Gelen bağlantının Metin Girişi; sonraki bağlantının Metin Çıktısı (veya ilgili sonraki düğüm) olduğundan emin olun.
  5. Workflow’u kaydedin.
  6. Workflow çalışma ekranındaki çalıştırma eylemini başlatın.
  7. Önce LLM düğümünün sonucunu, ardından Metin Çıktısı’ndaki son yanıtı kontrol edin.
  8. Hata oluşursa önce bağlantıdaki API anahtarını, seçilen modeli, model erişim iznini ve zorunlu alanları kontrol edin.

Sohbet düğümlerinin çıktısı doğrudan kullanıcıya gösterilebilir. Embedding, rerank, moderasyon ve görsel üretim düğümlerinin çıktısı ise kullanım amacına uygun sonraki düğümlere bağlanmalıdır (örn. embedding çıktısı bir vektör arama düğümüne, rerank çıktısı sıralı bir liste düğümüne).

Sık Karşılaşılan Hatalar​

Aşağıdaki hatalar tüm LLM düğümlerinde görülebilir. Sağlayıcıya özel hatalar her sağlayıcının kendi bölümünde listelenmiştir.

HataOlası NedenÇözüm
Yanıt İngilizce geliyorSystem Prompt'ta dil belirtilmemişSystem Prompt'a "Yanıtlarını Türkçe ver" ekleyin
Yanıt çok uzunUzunluk sınırı verilmemişSystem Prompt'a kelime veya madde sınırı yazın; varsa Max Tokens değerini düşürün
Yanıt yarıda kesiliyorMax Tokens değeri çok düşükMax Tokens değerini artırın veya alanı boş bırakarak varsayılanı kullanın
Yanıt formatı tutarsızFormat kuralı belirsizSystem Prompt'ta çıktı formatını net tanımlayın
Yanıt tutarsız/rastgeleTemperature değeri çok yüksekTemperature değerini düşürün (örn. 0,2–0,3)
Sonraki düğüm çıktıyı işleyemiyorModel açıklama metni de döndürüyorSystem Prompt'a "yalnızca sonucu döndür, açıklama yazma" ekleyin
Sorgu / Message alanı boş hatasıZorunlu alan doldurulmamış veya / ile bağlanan değer boşAlana metin girin veya / ile boş olmayan bir çıktı seçin
Yanıt çok yüzeyselKüçük model seçiliDaha güçlü bir model seçin (Opus, GPT-5.5)
İşlem çok yavaşWeb arama veya araç kullanımı açıkGerekmiyorsa Claude Web Search yerine normal LLM düğümü kullanın
Araç çağrılmıyorAraç bağlantısı kurulmamışAraçlar bölümünde "Bağlantı gerekli" uyarısını giderin
401 / 403 hatası (BYOK/BYOM)API anahtarı geçersiz, süresi dolmuş veya yanlış bağlantı seçilmişSağlayıcının panelinden anahtarı doğrulayın; Connection alanının doğru bağlantıya işaret ettiğini kontrol edin
429 / rate limit hatası (BYOK/BYOM)Sağlayıcının dakikalık/günlük istek limiti aşıldıİstekler arasına gecikme ekleyin veya sağlayıcı planınızı yükseltin
İş akışı çalışıyor ama Metin Çıktısı boşDüğüm bağlantıları (Gelen/Sonraki) yanlış kurulmuşLLM düğümünün girişinin Metin Girişi'ne, çıkışının Metin Çıktısı'na bağlı olduğunu doğrulayın

Notlar​

  • Yerleşik API düğümleri ve GOAT kimlik bağlantısı gerektirmez; BYOK ve BYOM düğümleri kendi hesabınıza/altyapınıza bağlanır ve kullanım o hesabın planına göre faturalandırılır.
  • Sorgu (veya Message) alanı ne yapılacağını, System Prompt nasıl yapılacağını tanımlar. İkisini birlikte kullanmak en iyi sonucu verir.
  • Sınıflandırma ve karar verme adımlarında System Prompt'a net format kuralı yazın; böylece sonraki If-Else düğümü çıktıyı doğru okuyabilir.
  • Küçük modeller (Mini, Nano) basit işlerde hem daha hızlı hem daha ekonomiktir; her iş için en büyük modeli seçmeyin.
  • Araçlar özelliği modeli yavaşlatır ve maliyeti artırır; yalnızca gerekli araçları ekleyin.
  • Claude Web Search yalnızca güncel bilgi gerektiğinde kullanılmalıdır; aksi halde normal LLM düğümü daha hızlıdır.
  • API anahtarlarını yalnızca bağlantı alanına girin; Message, System Prompt veya Sorgu alanlarına asla yazmayın.
  • BYOK ve BYOM düğümlerinde oluşan hataların büyük bölümü bağlantı bilgilerinden (API Key, Endpoint, Deployment Name) kaynaklanır; sorun giderirken önce bağlantıyı, sonra model/parametre alanlarını kontrol edin.
  • Üretime alınan iş akışlarında Temperature ve Max Tokens değerlerini açıkça belirlemek, farklı çalıştırmalar arasında tutarlılığı artırır.
  • Bir akışta birden fazla LLM düğümü zincirleyebilirsiniz — örneğin önce özetleyip sonra yorumlatmak için.
  • Kritik süreçlerde tek bir sağlayıcıya bağımlı kalmamak için aynı iş akışını alternatif bir düğümle (örn. GOAT veya OpenRouter üzerinden farklı bir model) yedekli çalışacak şekilde tasarlayın.
  • Düğümlere anlamlı isim verin ("Özetle", "Sınıflandır" gibi); / menüsünde doğru çıktıyı bulmayı kolaylaştırır.