GPT İstemi

Akış içinde önceden yapılandırılmış bir GPT/LLM sorgusunu çalıştıran nesnedir. Akış bu adıma ulaştığında, kimliği ya da adıyla seçtiğiniz sorguyu verdiğiniz parametrelerle çağırır ve dil modelinin sonucunu akışa geri getirir.

Ne zaman kullanılır?

Akışın bir noktasında dil modeline iş yaptırmanız gerektiğinde kullanın: bir metni özetletmek, formdan gelen serbest metni sınıflandırmak ya da yapılandırılmış bir çıktı üretmek gibi. Çalıştırılacak sorgu önceden tanımlanır; nesne bu sorguyu QueryId ya da QueryName ile seçer ve QueryParameters ile besler.

Ayarlar

GPT İstemi nesnesi seçildiğinde tasarımcıda şu başlıklar düzenlenir:

Ayar	Açıklama
QueryId	Çalıştırılacak GPT sorgusunun kimliği.
QueryName	Çalıştırılacak GPT sorgusunun adı (kimlik yerine adla seçim).
QueryParameters	Sorguya geçirilecek parametreler (Dictionary<string, object>).
ErrorOptions	Sorgu çalışırken hata oluşursa akışın nasıl davranacağını belirleyen hata yönetimi seçenekleri.

Akıştaki yeri

GPT İstemi, akışın ortasında bir işlem adımıdır: önceki adım tamamlanınca seçili sorgu parametreleriyle çalıştırılır, sonuç döndüğünde akış bir sonraki adıma geçer. Hata yönetimli bir adım olduğundan (BaseErrorManagedApiStep), sorgu sırasında oluşan hatalar ErrorOptions üzerinden yönetilebilir.

Kod örnekleri

Sorgu, akış kodunda nesnenin adıyla çalıştırılır. Sunucu (akış) kodu turuncu çerçevelidir.

caution

Aşağıdaki kullanım, doğrulanmış sınıf üyelerine dayanır ancak çalışma anındaki idiom henüz örnekle teyit edilmedi. TODO: doğrulanacak parametre adları ve sonuç okuma şekli IDE'de doğrulanmalı.

// Çalıştırılacak sorguyu seç
p_GptIstem.QueryName = "TalepOzetle";

// Sorgu parametrelerini doldur
p_GptIstem.QueryParameters["metin"] = aciklama;

// Sorguyu çalıştır (asenkron)
await p_GptIstem.ExecuteQueryAsync();

İpuçları

• Sorguyu ya QueryId (kimlik) ya da QueryName (ad) ile seçin; ikisinden biri yeterlidir.
• QueryParameters bir Dictionary<string, object> olduğundan parametre tipleri sorgu tanımıyla uyumlu olmalıdır.
• ExecuteQueryAsync asenkron bir metottur; akış kodunda await ile çağrılır.
• Sorgu çağrısı hata verebilir; akışın durmaması için ErrorOptions ayarını gözden geçirin.

Doğrulanmış kod arayüzü (FlowGptPrompt)

Taban sınıf: BaseErrorManagedApiStep<FlowGptPromptProperties>

Özellikler: QueryId (Int64), QueryName (String), QueryParameters (Dictionary<String, Object>) + miras alınan ErrorOptions (IFlowErrorOptions).

Metotlar: ExecuteQueryAsync() → Task

Kaynak: synergy-csp references/flow-objects.md (FlowGptPrompt, dump-only: çalışma anı idiomu doğrulanmamış).