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:
| Grup | Düğümler | Bağlantı Gerekir mi? |
|---|---|---|
| Yerleşik API düğümleri | OpenAI API Çağrısı, Anthropic API Çağrısı, Claude Web Search | Hayır — model erişimi SkyStudio tarafından sağlanır |
| Native (GOAT) | GOAT | Hayır |
| BYOK (Bring Your Own Key) | Mistral AI, DeepSeek, Groq, xAI (Grok), Together AI, Perplexity, Cohere, Gemini, OpenRouter, Hugging Face | Evet — kendi sağlayıcı hesabınızın API anahtarı |
| BYOM (Bring Your Own Model) | Custom Model, Azure OpenAI, AWS Bedrock | Evet — 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üğüm | Açıklama |
|---|---|
| OpenAI API Çağrısı | OpenAI modellerine istek gönderir |
| Anthropic API Çağrısı | Anthropic Claude modellerine istek gönderir |
| Claude Web Search | Claude 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üm | Zorunlu | Açıklama |
|---|---|---|
| Düğüm Adı | Hayır | Düğümün canvas'taki adı |
| Model | Evet | Kullanılacak yapay zeka modeli |
| System Prompt Ekle | Hayır | Modelin rolünü ve davranış kurallarını tanımlar |
| Araçlar | Hayır | Modelin gerektiğinde çağırabileceği dış araçlar |
| Sorgu | Evet | Modele gönderilecek istek metni |
OpenAI API Çağrısı
OpenAI modellerine istek gönderir ve yanıtı akışa aktarır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Düğüm Adı | Hayır | Düğümün canvas'taki adı |
| Model | Evet | GPT serisi modellerden biri (örn. GPT-5.4 Mini, GPT-5.5) |
| System Prompt | Hayır | Modelin rolü ve kuralları |
| Araçlar | Hayır | Modelin kullanabileceği araçlar |
| Sorgu | Evet | İstek metni. / ile önceki düğüm çıktısını ekleyebilirsiniz |
Model Seçimi
| Model tipi | Ne için uygun |
|---|---|
| Mini / Nano | Kısa özet, sınıflandırma, basit çeviri — hızlı ve ekonomik |
| Standart (GPT-5, GPT-5.5) | Genel amaçlı üretim, raporlama |
| o serisi | Adı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Düğüm Adı | Hayır | Düğümün canvas'taki adı |
| Model | Evet | Claude serisi modellerden biri (örn. Claude 5 Sonnet, Claude 4.8 Opus) |
| System Prompt | Hayır | Modelin rolü ve kuralları |
| Araçlar | Hayır | Modelin kullanabileceği araçlar |
| Sorgu | Evet | İstek metni |
Model Seçimi
| Model tipi | Ne için uygun |
|---|---|
| Sonnet | Dengeli — çoğu iş için uygun, iyi hız/kalite dengesi |
| Opus | Uzun 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 Web Search
Claude modelini web araması yeteneğiyle birlikte çalıştırır. Güncel bilgi gerektiren sorular için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Düğüm Adı | Hayır | Düğümün canvas'taki adı |
| Model | Evet | Kullanılacak Claude modeli |
| System Prompt | Hayır | Modelin rolü ve kuralları |
| Sorgu | Evet | Araştırılacak konu veya soru |
| Maksimum Arama | Hayır | Yapı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 |
|---|---|
| Rol | Sen bir finansal rapor analistisin. |
| Dil | Yanıtlarını her zaman Türkçe ver. |
| Format | Önce 3 maddelik özet, sonra tablo ver. |
| Uzunluk | Yanıtlarını 200 kelimeyi geçmeyecek şekilde yaz. |
| Sınırlar | Veride 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
- Araçlar başlığına tıklayarak bölümü açın.
- Listeden eklemek istediğiniz aracın yanındaki + işaretine tıklayın.
- 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öntem | Nasıl yapılır |
|---|---|
| Menüden seçme | Alana 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:
| Parametre | Açıklama |
|---|---|
| Message / Prompt | Modelin yanıtlayacağı ana istek. Sabit metin yazılabilir veya / ile önceki düğümden değer bağlanabilir. |
| System Prompt | Modelin rolünü, dilini, tonunu ve çıktı kurallarını tanımlayan talimat. Çoğu düğümde zorunlu değildir ancak tutarlı sonuç için önerilir. |
| Temperature | Yanı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 Output | Yanı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:
| Operasyon | Açıklama |
|---|---|
| Sohbet | Verilen 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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Düğüm Adı | Hayır | Workflow içinde düğümü tanımayı kolaylaştıran isim (örn. Ürün Açıklaması Oluştur, Destek Yanıtı) |
| İşlem seçin | Evet | Sohbet seçilir |
| Message | Evet | Modelin yanıtlayacağı ana istek. Sabit metin yazılabilir veya Metin Girişi düğümünden gelen değer / ile eklenebilir |
| System Prompt | Hayır | Modelin davranışını tanımlar; yanıt biçimini kontrol etmek için kullanılması önerilir |
| Temperature | Hayır | Yanıtların yaratıcılık düzeyini belirler (aşağıdaki rehbere bakın) |
| Max Tokens | Hayır | Yanı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ık | Sonuç |
|---|---|
| 0–0,3 | Daha tutarlı, net ve kontrollü yanıtlar |
| 0,4–0,7 | Genel kullanım için dengeli sonuçlar |
| 0,8–1 | Daha 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ı
- Metin Girişi düğümüne örneğin
Yapay zekâ destekli müşteri hizmetleri nedir?yazılır. - GOAT düğümünde Message alanına
/ile Metin Girişi değeri eklenir. - System Prompt alanına istenen yanıt biçimi yazılır.
- GOAT düğümünün sonraki bağlantısı Metin Çıktısı yapılır.
- Workflow kaydedilir ve çalışma ekranındaki çalıştırma eylemi başlatılır.
- Sonuç, Metin Çıktısı düğümünde görüntülenir.
Sık Karşılaşılan Hatalar
| Hata | Olası Neden | Çözüm |
|---|---|---|
| Boş yanıt dönüyor | Message alanı boş veya yalnızca boşluk karakteri içeriyor | Message alanına geçerli bir metin girildiğinden veya / ile bağlanan değerin boş olmadığından emin olun |
| Yanıt yarıda kesiliyor | Max 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ı üslupta | System 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 var | Message 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:
- Sağlayıcıdan bir API anahtarı alınır.
- 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).
- Bağlantı oluşturulurken Kimler kullanabilir alanından erişim düzeyi belirlenir (Sadece ben / Çalışma alanı / Seçili kullanıcılar / Entegrasyonlar).
- Düğümde Uygulama Bağlantıları açılır menüsünden kaydedilen bağlantı seçilir.
- Connection alanından kullanılacak bağlantı belirlenir (birden fazla bağlantı varsa).
- Model ve işlem (operasyon) alanları doldurulur.
- 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.
- 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
- Mistral AI hesabınıza giriş yapın.
- İlgili çalışma alanını (workspace) seçin.
- Sol menüden API Keys sayfasına gidin.
- Create new key butonuna tıklayarak yeni bir anahtar oluşturun.
- 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
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Mistral AI seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Mistral) |
| API Key | Evet | Mistral API Keys sayfasından kopyaladığınız anahtar |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme, soru yanıtlama, özetleme ve içerik yazımı |
| Embedding Üret | Öne Çıkan | Metni sayısal vektöre dönüştürür |
| OCR / Belge Oku | Öne Çıkan | PDF, görsel veya belge içeriğinden metin çıkarır |
| Kod Tamamlama (FIM) | Standart | Kod parçasının eksik bölümünü tamamlar |
| İçerik Denetimi | Standart | Metni 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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Mistral AI bağlantısı |
| Model | Evet | Açılır listeden kullanılacak Mistral sohbet modeli seçilir |
| Message | Evet | Modelin yanıtlayacağı kullanıcı isteği. Metin Girişi düğümünden gelen içerik kullanılacaksa / ile ilgili değer seçilir |
| System Prompt | Hayır | Modelin rolünü, dilini, tonunu ve çıktı kurallarını tanımlar |
| Temperature | Hayır | Dengeli sonuç için 0,7; daha kontrollü sonuç için daha düşük değer kullanılır |
| Max Tokens | Hayır | Yanıtın en yüksek uzunluğunu belirler |
| JSON Output | Hayır | Yanı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Mistral AI bağlantısı |
| Model | Evet | Embedding destekleyen Mistral modeli seçilir |
| Input Text(s) | Evet | Vektö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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Mistral AI bağlantısı |
| Model | Evet | Belge veya görsel anlama destekleyen model seçilir |
| Document Type | Evet | Gönderilen dosyanın türü seçilir (örn. PDF, görsel) |
| Document / Image URL | Evet | Belgenin erişilebilir bağlantısı. URL kullanılabilir veya desteklenen durumda data:application/pdf;base64,... biçiminde Base64 veri gönderilebilir |
| Include Images | Hayır | Belgedeki 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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Mistral AI bağlantısı |
| Model | Evet | Kod tamamlama destekleyen Mistral modeli seçilir |
| Prompt (Prefix) | Evet | Eksik kısmın öncesindeki kod |
| Suffix | Hayır | Eksik kısmın sonrasında gelen kod; modelin hangi noktaya kadar kod yazacağını daha iyi anlamasını sağlar |
| Max Tokens | Hayır | Tamamlanacak 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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Mistral AI bağlantısı |
| Model | Evet | İçerik denetimi destekleyen model seçilir |
| Text to Moderate | Evet | Kontrol 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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz veya yanlış girilmiş | Mistral API Keys sayfasından anahtarı kontrol edin, gerekirse yeniden oluşturun |
| 429 Too Many Requests | Sağlayıcı hız/istek limiti aşıldı | İstekler arasına gecikme ekleyin veya plan limitinizi yükseltin |
| Model not found | Seç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 exceeded | Message veya Document içeriği modelin bağlam sınırını aşıyor | Girdi metnini kısaltın veya daha yüksek bağlam limitli bir model seçin |
| Boş embedding sonucu | Input 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
- DeepSeek Platform hesabınıza giriş yapın.
- Sol menüden API Keys bölümüne gidin.
- Create new API key butonuna tıklayın.
- Oluşturulan anahtarı kopyalayıp güvenli bir yerde saklayın.
Not: Resmî API dokümantasyonu: DeepSeek API.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak DeepSeek seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket DeepSeek) |
| API Key | Evet | DeepSeek Platform’dan kopyaladığınız anahtar |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme ve soru yanıtlama |
| Kod Tamamlama (FIM) | Standart | Kod parçasının eksik bölümünü tamamlar |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak DeepSeek bağlantısı |
| Model | Evet | Açılır listeden kullanılacak DeepSeek modeli seçilir |
| Message | Evet | Modelin yanıtlayacağı istek. Kullanıcı girdisi için / ile Metin Girişi bağlanır |
| System Prompt | Hayır | Modelin davranışını tanımlar |
| Temperature | Hayır | Daha kesin sonuçlar için düşürülür, yaratıcı metinler için artırılır |
| Max Tokens | Hayır | Yanıt uzunluğu sınırıdır |
| JSON Output | Hayır | Yapı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak DeepSeek bağlantısı |
| Model | Evet | Kod tamamlama için uygun DeepSeek modeli seçilir |
| Prompt (Prefix) | Evet | Eksik kodun öncesi |
| Suffix | Hayır | Eksik kodun sonrası; modelin tamamlamayı doğru yerde bitirmesine yardımcı olur |
| Max Tokens | Hayı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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | DeepSeek Platform’dan anahtarı kontrol edin |
| 402 Insufficient Balance | Hesap bakiyesi/kredisi yetersiz | DeepSeek Platform’da bakiye yükleyin |
| 429 Too Many Requests | İstek limiti aşıldı | İstekler arasına gecikme ekleyin |
| Context length exceeded | Girdi modelin bağlam sınırını aşıyor | Message 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-coderailesi 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
- Groq Console hesabınıza giriş yapın.
- İlgili projeyi seçin.
- API Keys alanından Create API Key butonuna tıklayın.
- 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
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Groq seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Groq) |
| API Key | Evet | Groq Console’dan kopyaladığınız anahtar |
- 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:
| Operasyon | Açıklama |
|---|---|
| Sohbet | Düşük gecikmeli metin üretimi ve soru yanıtlama |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Groq bağlantısı |
| Model | Evet | Kullanılacak Groq modeli seçilir |
| Message | Evet | Yanıtlanacak istek. Metin Girişi kullanılıyorsa / ile eklenir |
| System Prompt | Hayır | Asistanın rolünü ve yanıt kurallarını tanımlar |
| Temperature | Hayır | Yanıt çeşitliliğini belirler |
| Max Tokens | Hayır | En 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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz veya proje değişmiş | Groq Console’dan yeni bir anahtar oluşturun |
| 429 Too Many Requests | Dakikalık/günlük istek limiti aşıldı | İstek sıklığını azaltın veya plan limitinizi kontrol edin |
| Model decommissioned | Seçilen model artık desteklenmiyor | Groq 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
- xAI Console hesabınıza giriş yapın.
- API Keys bölümüne gidin.
- Yeni bir anahtar oluşturun ve kopyalayın.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak xAI (Grok) seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket xAI) |
| API Key | Evet | xAI Console’dan kopyaladığınız anahtar |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme ve soru yanıtlama |
| Görsel Üret | Standart | Metin açıklamasından görsel üretir |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak xAI bağlantısı |
| Model | Evet | Kullanılacak Grok modeli seçilir |
| Message | Evet | Kullanıcı isteği girilir veya / ile Metin Girişi bağlanır |
| System Prompt | Hayır | Yanıtın rolünü, tonunu ve sınırlarını belirler |
| Temperature | Hayır | Yaratıcılık düzeyidir |
| Max Tokens | Hayır | Yanı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak xAI bağlantısı |
| Model | Evet | Görsel üretim destekleyen model seçilir |
| Prompt | Evet | Oluşturulacak görselin ayrıntılı açıklaması |
| Number of Images | Hayır | Kaç 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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | xAI Console’dan anahtarı yenileyin |
| 429 Too Many Requests | İstek limiti aşıldı | İstekler arasına gecikme ekleyin |
| Görsel üretilmiyor | Prompt çok kısa veya belirsiz | Prompt’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
1ile 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
- Together AI hesabınıza giriş yapın.
- Ayarlar altındaki API Keys bölümüne gidin.
- Yeni bir anahtar oluşturun ve kopyalayın.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Together AI seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Together AI) |
| API Key | Evet | Together AI ayarlarından kopyaladığınız anahtar |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme ve soru yanıtlama |
| Embedding Üret | Standart | Metni sayısal vektöre dönüştürür |
| Görsel Üret (FLUX) | Standart | FLUX modeliyle metinden görsel üretir |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Together AI bağlantısı |
| Model | Evet | Kullanılacak sohbet modeli seçilir |
| Message | Evet | Modelin yanıtlayacağı içerik |
| System Prompt | Hayır | Modelin davranışını belirler |
| Temperature | Hayır | Yaratıcılık düzeyidir |
| Max Tokens | Hayır | Yanı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Together AI bağlantısı |
| Model | Evet | Embedding modeli seçilir |
| Input Text(s) | Evet | Vektö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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Together AI bağlantısı |
| Model | Evet | FLUX veya kullanılabilir başka bir görsel üretim modeli seçilir |
| Prompt | Evet | Üretilecek görselin ayrıntılı açıklaması |
| Width | Hayır | Görsel genişliği (varsayılan: 1024) |
| Height | Hayır | Görsel yüksekliği (varsayılan: 1024) |
| Steps | Hayı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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | Together AI ayarlarından anahtarı yenileyin |
| 429 Too Many Requests | İstek limiti aşıldı | İstekler arasına gecikme ekleyin |
| Model not available | Seçilen model hesap planınızda desteklenmiyor | Together AI model kataloğundan erişilebilir bir model seçin |
| Görsel boş/bozuk dönüyor | Width/Height değeri modelin desteklediği aralığın dışında | Modelin 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
- Perplexity hesabınıza giriş yapın.
- Ayarlar altındaki API bölümüne gidin.
- Yeni bir anahtar oluşturun ve kopyalayın.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Perplexity seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Perplexity) |
| API Key | Evet | Perplexity ayarlarından kopyaladığınız anahtar |
- 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:
| Operasyon | Açıklama |
|---|---|
| Sohbet (Web Aramalı) | Web araması destekli, güncel bilgiye dayalı yanıt üretir |
Sohbet (Web Aramalı)
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Perplexity bağlantısı |
| Model | Evet | Kullanılacak Perplexity modeli seçilir |
| Message | Evet | Araştırılacak soru veya istek |
| System Prompt | Hayır | Yanıtın dili, biçimi ve kaynak kullanımına dair kurallar |
| Temperature | Hayır | Yanıt çeşitliliğini belirler |
| Max Tokens | Hayır | Yanı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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | Perplexity ayarlarından anahtarı yenileyin |
| 429 Too Many Requests | İstek limiti aşıldı | İstekler arasına gecikme ekleyin |
| Kaynak (citation) dönmüyor | Seçilen model web araması desteklemiyor | Web aramasını destekleyen bir Perplexity modeli (örn. sonar ailesi) seçin |
| Güncel olmayan yanıt | Sorgu 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
- Cohere Dashboard hesabınıza giriş yapın.
- API Keys bölümüne gidin.
- Yeni bir anahtar oluşturun ve kopyalayın.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Cohere seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Cohere) |
| API Key | Evet | Cohere Dashboard’dan kopyaladığınız anahtar |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme ve soru yanıtlama |
| Embedding Üret | Standart | Metni sayısal vektöre dönüştürür |
| Belge Yeniden Sırala | Standart | Bir arama sorgusuna en uygun belgeleri sıralar |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cohere bağlantısı |
| Model | Evet | Kullanılacak Cohere sohbet modeli seçilir |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Rol, dil ve çıktı kuralları |
| Temperature | Hayır | Yanıt çeşitliliği |
| Max Tokens | Hayır | Yanı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cohere bağlantısı |
| Model | Evet | Embedding modeli seçilir |
| Input Type | Evet | Metnin 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) | Evet | Vektö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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Cohere bağlantısı |
| Model | Evet | Rerank destekleyen Cohere modeli seçilir |
| Query | Evet | Kullanıcının arama sorusu |
| Documents (JSON) | Evet | Sıralanacak belgeler, JSON dizi biçiminde |
| Top N | Hayır | Dö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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | Cohere Dashboard’dan anahtarı yenileyin |
| 429 Too Many Requests | İstek limiti aşıldı | İstekler arasına gecikme ekleyin |
| Invalid input_type | Embedding Ü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 sonucu | Documents (JSON) alanı geçersiz format içeriyor | JSON 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
- Google AI Studio üzerinden hesabınıza giriş yapın.
- Get API key bölümüne gidin.
- Yeni bir anahtar oluşturun ve kopyalayın.
Not: Resmî rehber: Gemini API anahtarı oluşturma.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Gemini seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Gemini) |
| API Key | Evet | Google AI Studio’dan kopyaladığınız anahtar |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme ve soru yanıtlama |
| Görsel Üret | Standart | Metin açıklamasından görsel üretir |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Gemini bağlantısı |
| Model | Evet | Kullanılacak Gemini modeli seçilir |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Modelin rolünü, yanıt dilini ve sınırlarını tanımlar |
| Temperature | Hayır | Yaratıcılık düzeyidir |
| Max Tokens | Hayır | Yanı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Gemini bağlantısı |
| Model | Evet | Görsel üretimi destekleyen Gemini modeli seçilir |
| Prompt | Evet | Görselin konusu, stili, ışığı, kompozisyonu ve istenmeyen unsurları açıkça yazılır |
| Number of Images | Hayır | Üretilecek görsel sayısı (başlangıç için 1 kullanılır) |
| Aspect Ratio | Hayır | Görsel oranı; kullanım alanına göre seçilir |
Aspect Ratio Rehberi
| Kullanım Alanı | Önerilen Oran |
|---|---|
| Kare sosyal medya gönderisi | Kare oran |
| Hikâye veya dikey içerik | Dikey oran |
| Kapak veya banner | Yatay 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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | Google 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ı desteklenmiyor | Seçilen Aspect Ratio model tarafından desteklenmiyor | Desteklenen 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
- OpenRouter Keys sayfasına gidin.
- Yeni bir anahtar oluşturun ve kopyalayın.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak OpenRouter seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket OpenRouter) |
| API Key | Evet | OpenRouter Keys sayfasından kopyaladığınız anahtar |
- 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:
| Operasyon | Açıklama |
|---|---|
| Sohbet | OpenRouter üzerinden erişilebilen herhangi bir modelle metin üretme |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak OpenRouter bağlantısı |
| Model | Evet | Model adı doğrudan sağlayıcı/model-adı biçiminde girilir |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Asistan davranışını tanımlar |
| Temperature | Hayır | Yanıt çeşitliliğidir |
| Max Tokens | Hayır | Yanı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 foundhatası 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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key geçersiz | OpenRouter Keys sayfasından anahtarı yenileyin |
| 404 Model not found | Model adı yanlış yazılmış veya sağlayıcı öneki eksik | Modeli sağlayıcı/model-adı biçiminde, güncel OpenRouter kataloğundan doğrulayarak girin |
| 402 Payment required | Hesap bakiyesi yetersiz | OpenRouter 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
- Hugging Face Access Tokens sayfasına gidin.
- New token butonuna tıklayın.
- Token’a bir isim verin, gerekli izin kapsamını (en az okuma/çıkarım) seçin.
- Oluşturulan token’ı kopyalayın.
SkyStudio’ya Bağlantı Ekleme
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Hugging Face seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Hugging Face) |
| Access Token | Evet | Hugging Face ayarlarından kopyaladığınız token |
- 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:
| Operasyon | Açıklama |
|---|---|
| Sohbet | Hugging Face üzerinde barındırılan bir modelle metin üretme |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Hugging Face bağlantısı |
| Model | Evet | Model kimliği (repo yolu) doğrudan yazılır |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Rol, dil, ton ve çıktı biçimi için kullanılır |
| Temperature | Hayır | Yaratıcılık düzeyidir |
| Max Tokens | Hayır | Yanı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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | Access Token geçersiz veya izin kapsamı yetersiz | Yeni bir token oluşturun, gerekli izin kapsamını seçin |
| 403 Forbidden / Gated model | Model, lisans onayı gerektiren “gated” bir model | Hugging Face üzerinde modelin sayfasından erişim talebini onaylayın |
| 503 Model loading | Model ilk kez çağrılıyor ve yükleniyor | Birkaç saniye bekleyip isteği tekrar gönderin |
| 404 Model not found | Model 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 loadinghatası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
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Custom Model seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Kurum İçi Model) |
| Base URL / Endpoint | Evet | Özel uç nokta adresi (örn. https://model.sirketiniz.com/v1) |
| API Key | Hayır | Uç 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.
- 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:
| Operasyon | Açıklama |
|---|---|
| Sohbet | Özel uç noktadaki modele istek gönderir |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Custom Model bağlantısı |
| Model | Evet | Uç noktanın sunduğu model adı |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Modelin rolünü ve davranışını belirler |
| Temperature | Hayır | Yanıt çeşitliliğidir |
| Max Tokens | Hayır | Yanı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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| Connection timeout | Base URL erişilemiyor veya uç nokta ayakta değil | Uç noktanın çalıştığını ve SkyStudio’nun erişebildiği bir ağda olduğunu doğrulayın |
| 401 Unauthorized | API Key gerekiyor ama girilmemiş veya hatalı | Bağlantıdaki API Key alanını kontrol edin |
| Model not found | Model adı uç noktada tanımlı değil | Uç 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
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Azure OpenAI seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket Azure OpenAI) |
| Azure Resource Endpoint | Evet | Azure kaynağınızın uç nokta adresi (örn. https://sirketiniz.openai.azure.com) |
| API Key | Evet | Azure Portal’daki kaynağınızın Keys and Endpoint bölümünden alınan anahtar |
| API Version | Hayır | Kullanılacak Azure OpenAI API sürümü |
- 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:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Sohbet | Öne Çıkan | Metin üretme ve soru yanıtlama |
| Embedding Üret | Standart | Metni sayısal vektöre dönüştürür |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Azure OpenAI bağlantısı |
| Deployment Name | Evet | Azure portalında oluşturduğunuz model dağıtımının adı (modelin genel adı değil, verdiğiniz deployment adı) |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Asistan davranışını tanımlar |
| Temperature | Hayır | Yaratıcılık düzeyidir |
| Max Tokens | Hayır | Yanı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
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Azure OpenAI bağlantısı |
| Deployment Name | Evet | Azure’da oluşturulan embedding dağıtımının adı |
| Input Text(s) | Evet | Embedding’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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| 401 Unauthorized | API Key hatalı veya kaynak eşleşmiyor | Azure Portal’dan Keys and Endpoint bilgilerini yeniden kontrol edin |
| 404 Deployment not found | Deployment 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 Requests | Dağı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 Version | API Version alanı desteklenmeyen bir değer içeriyor | Azure 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
- SkyStudio’nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak AWS Bedrock seçin.
- Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| Bağlantı Adı | Evet | Tanımlayıcı bir isim (örn. Şirket AWS Bedrock) |
| AWS Access Key ID | Evet | IAM kullanıcısının erişim anahtarı kimliği |
| AWS Secret Access Key | Evet | IAM kullanıcısının gizli erişim anahtarı |
| AWS Region | Evet | Bedrock’un etkin olduğu AWS bölgesi (örn. us-east-1) |
- Kaydet butonuna tıklayın.
Not: Kullanılan IAM kullanıcısının veya rolünün
bedrock:InvokeModeliznine 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:
| Operasyon | Açıklama |
|---|---|
| Sohbet | Seçilen Bedrock modeline istek gönderir |
Sohbet
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak AWS Bedrock bağlantısı |
| Model ID | Evet | AWS Bedrock model kimliği |
| Message | Evet | Modelin yanıtlayacağı istek |
| System Prompt | Hayır | Modelin rolünü ve yanıt kurallarını belirler |
| Temperature | Hayır | Yanıt çeşitliliğidir |
| Max Tokens | Hayır | Yanı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
| Hata | Olası Neden | Çözüm |
|---|---|---|
| AccessDeniedException | IAM kullanıcısının/rolünün bedrock:InvokeModel izni yok | AWS IAM üzerinden gerekli politikayı ekleyin |
| ValidationException: model not found | Model ID seçilen bölgede etkin değil | AWS Bedrock konsolunda modelin bölgeye göre erişilebilirliğini kontrol edin |
| ThrottlingException | Bölgesel istek/throughput limiti aşıldı | İstek sıklığını azaltın veya sağlanmış (provisioned) throughput talep edin |
| UnrecognizedClientException | Access 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ütme | Anthropic API Çağrısı (Opus) |
| Hızlı prototipleme, harici hesap istemeyen basit sohbet | GOAT |
| Güncel, web tabanlı araştırma ve kaynaklı yanıt | Claude Web Search, Perplexity |
| Belge/PDF'den metin çıkarma (OCR) | Mistral AI |
| Anlamsal arama, RAG, benzerlik eşleştirme | Mistral AI, Together AI, Cohere, Azure OpenAI (Embedding Üret) |
| Arama sonuçlarını yeniden sıralama (rerank) | Cohere |
| Düşük gecikmeli, gerçek zamanlı sohbet | Groq |
| Kod tamamlama / IDE benzeri otomasyon | Mistral AI (Codestral), DeepSeek (deepseek-coder) |
| Maliyet-performans dengeli yüksek hacimli sohbet | DeepSeek, Together AI |
| Görsel üretimi | xAI (Grok), Gemini, Together AI (FLUX) |
| İçerik denetimi / güvenlik kontrolü | Mistral AI |
| Tek bağlantıdan birden fazla sağlayıcıyı test etme | OpenRouter |
| Açık kaynak modellerle özelleştirilmiş kullanım | Hugging Face, Together AI |
| Kurumsal veri saklama / bölge gereksinimi olan projeler | Azure OpenAI, AWS Bedrock |
| Kurum içi / self-hosted model | Custom Model |
Workflow’u Çalıştırma ve Sonucu Kullanma
Her sağlayıcı örneği için çalışma mantığı aynıdır:
- Metin Girişi düğümüne test edilecek metni yazın.
- LLM düğümünde doğru Uygulama Bağlantısı, Connection ve model bilgisinin seçildiğini kontrol edin.
- Message, Prompt, Input Text(s) veya ilgili işlem alanına Metin Girişi değerini
/ile bağlayın. - 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.
- Workflow’u kaydedin.
- Workflow çalışma ekranındaki çalıştırma eylemini başlatın.
- Önce LLM düğümünün sonucunu, ardından Metin Çıktısı’ndaki son yanıtı kontrol edin.
- 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.
| Hata | Olası Neden | Çözüm |
|---|---|---|
| Yanıt İngilizce geliyor | System Prompt'ta dil belirtilmemiş | System Prompt'a "Yanıtlarını Türkçe ver" ekleyin |
| Yanıt çok uzun | Uzunluk 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 kesiliyor | Max Tokens değeri çok düşük | Max Tokens değerini artırın veya alanı boş bırakarak varsayılanı kullanın |
| Yanıt formatı tutarsız | Format kuralı belirsiz | System Prompt'ta çıktı formatını net tanımlayın |
| Yanıt tutarsız/rastgele | Temperature değeri çok yüksek | Temperature değerini düşürün (örn. 0,2–0,3) |
| Sonraki düğüm çıktıyı işleyemiyor | Model açıklama metni de döndürüyor | System 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üzeysel | Küçük model seçili | Daha güçlü bir model seçin (Opus, GPT-5.5) |
| İşlem çok yavaş | Web arama veya araç kullanımı açık | Gerekmiyorsa Claude Web Search yerine normal LLM düğümü kullanın |
| Araç çağrılmıyor | Araç 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.
