Microsoft Foundry'de iş akışı oluşturma

İş akışları, Microsoft Foundry'de kullanıcı arabirimi tabanlı araçlardır. Görsel oluşturucuda aracıları ve iş mantığını düzenleyen bildirim temelli, önceden tanımlanmış eylem dizileri oluşturmak için bunları kullanın.

İş akışları, yapay zeka aracılarını iş süreçleriyle görsel bir şekilde sorunsuz bir şekilde harmanlayan akıllı otomasyon sistemleri oluşturmanıza olanak tanır. Geleneksel tek aracılı sistemlerin karmaşık, çok yönlü görevleri işleyebilme özellikleri sınırlıdır. Her biri özel becerilere veya rollere sahip birden çok aracıyı düzenleyerek daha güçlü, uyarlamalı ve gerçek dünya sorunlarını işbirliğiyle çözebilen sistemler oluşturabilirsiniz.

Önkoşullar

• Aktif bir aboneliğe sahip bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren ücretsiz bir Azure hesabı oluşturun.
• Microsoft Foundry'de bir proje. Daha fazla bilgi için bkz. Proje oluşturma.
• Foundry projenizde iş akışları oluşturma ve çalıştırma erişimi. Daha fazla bilgi için bkz. Foundry'de Azure rol tabanlı erişim denetimi (RBAC).

İş akışlarının ne zaman kullanılacağına karar verme

İş akışları, şunlara ihtiyacınız olan senaryolar için idealdir:

• Tekrarlanabilir bir işlemde birden çok aracıyı koordine etme.
• Kod yazmadan dallanma mantığı (örneğin, varsa/değilse) ve değişken işlemesi ekleyin.
• İnsan etkileşimli adımlar oluşturma (örneğin, onaylar veya netleştirici sorular).

Visual Studio Code'da iş akışı YAML'sini düzenlemek veya iş akışlarını yerel bir oyun alanında çalıştırmak istiyorsanız bkz:

• Visual Studio Code'da Bildirim temelli (Düşük kodlu) Aracı iş akışlarıyla çalışma
• Visual Studio Code'da Barındırılan (Pro-code) Aracı iş akışlarıyla çalışma

İş akışı desenlerini anlama

Foundry, yaygın düzenleme desenleri için şablonlar sağlar. Boş bir iş akışıyla başlayın veya bir şablon seçin:

Desen	Description	Tipik kullanım örneği
Döngüdeki insan	Kullanıcıya bir soru sorar ve devam etmek için kullanıcı girişini bekler	İş akışı yürütme sırasında onay istekleri oluşturma ve insan onayı bekleme veya kullanıcıdan bilgi alma
Sıralı	Sonucu, bir aracıdan tanımlı bir sıraya göre bir sonrakine aktarır.	Adım adım iş akışları, işlem hatları veya çok aşamalı işleme
Grup sohbeti	Bağlam veya kurallara göre aracılar arasında kontrolü dinamik olarak aktarır.	Dinamik iş akışları, yükseltme, geri dönüş veya uzman iletim senaryoları

Daha fazla bilgi için bkz. Microsoft Agent Framework iş akışı düzenlemeleri.

İş akışı oluşturma

Bu yordam, sıralı iş akışının nasıl oluşturulacağını gösterir. Aynı genel adımlar diğer iş akışı türleri için de geçerlidir.

1. Microsoft Foundry'de oturum açın. Yeni Dökümhane anahtarının açık olduğundan emin olun. Bu aşamalar Foundry (yeni) konusuna yöneliktir.

   

2. Sağ üst menüde Derle'yi seçin.

3. Yeni iş akışı oluştur>Sıralı seçin.

4. İş akışındaki her temsilci düğümünü seçerek ve istenen temsilciyi seçerek veya yeni bir temsilci oluşturarak temsilci düğümlerine bir temsilci atayın. Daha fazla bilgi için bu makalenin ilerleyen kısımlarında yer alan Aracı Ekle bölümüne bakın.

5. Değişiklikleri kaydetmek için görselleştiricide Kaydet'i seçin.

   Önemli

   Dökümhane iş akışlarını otomatik olarak kaydetmez. Çalışmanızı korumak için her değişiklikten sonra kaydet'i seçin.

6. İş Akışı Çalıştır'ı seçin.

7. Sohbet penceresinde iş akışıyla etkileşim kurun.

8. İsteğe bağlı olarak iş akışınıza yeni düğümler ekleyin. Bu makalenin sonraki bölümünde düğümler hakkında bilgi sağlanır.

İş akışı çalıştırmanızı doğrulayın

İş Akışını Çalıştır'ı seçtikten sonra şunları doğrulayın:

• Her düğüm, görselleştiricide işlemini tamamlar.
• Sohbet penceresinde beklenen yanıtları görürsünüz.
• Kaydettiğiniz tüm değişkenler (örneğin, bir aracı düğümünden JSON çıkışı) beklediğiniz değerleri içerir.

Düğümler ekle

Düğümler iş akışınızın yapı taşlarıdır. Her düğüm sırayla belirli bir eylem gerçekleştirir.

Yaygın düğüm türleri şunlardır:

• Aracı: Bir aracı çağırın.
• Mantık: if/else kullanın, for each veya goto.
• Veri dönüştürme: Bir değişken ayarlayın veya bir değeri ayrıştırma.
• Temel sohbet: Bir temsilciye ileti gönderin veya soru sorun.

Önceden oluşturulmuş bir iş akışı seçtiğinizde oluşturucu düğümleri sırayla görüntüler. Düğümleri yeniden sıralamak için düğüm üzerindeki üç noktayı seçin ve ardından taşı seçin. Çalışma alanında düğüm eklemek için artı (+) simgesini seçin.

Ajanları ekleyin

Projenizdeki herhangi bir Foundry aracısını iş akışına ekleyin. Aracı düğümleri ayrıca modellerini, istemlerini ve araçlarını yapılandırarak özelleştirilmiş özelliklere sahip yeni aracılar oluşturmanıza olanak sağlar.

Gelişmiş aracı oluşturma seçenekleri için, Foundry portalındaki Foundry Agent sekmesine gidin.

Mevcut bir aracıyı ekle

1. İş akışı görselleştiricisinde artı işaretini seçin.

2. Açılan listede Aracıyı çağır'ı seçin.

3. Yeni aracı oluştur penceresinde var olanı seçin.

4. Foundry projenizde var olan aracıları aramak için aracı adını girin.

5. İstediğiniz aracıyı seçerek iş akışınıza ekleyin.

Yeni aracı oluşturma

1. İş akışı görselleştiricisinde artı işaretini seçin.

2. Açılan listede Aracıyı çağır'ı seçin.

3. Bir temsilci adı giriniz ve ne yaptığını açıklayan bir açıklama giriniz.

4. Add (Ekle) seçeneğini belirleyin.

5. Aracı çağır penceresinde aracıyı yapılandırın.

6. Kaydetseçeneğini seçin.

Çıkış yanıt biçimini yapılandırma

Aracıyı yapılandırılmış JSON çıkışı döndürecek şekilde yapılandırmak için:

1. Aracı yapılandırmayı çağır penceresinde Yeni aracı oluştur'u seçin.

2. Aracıyı çıkışı JSON şeması olarak gönderecek şekilde yapılandırın:

   1. Ayrıntılar'ı seçin.
   2. Parametre simgesini seçin.
   3. Metin biçimi için JSON Şeması'nı seçin.

   

3. İstediğiniz JSON şemasını kopyalayın ve Yanıt biçimi ekle penceresine yapıştırın. Aşağıdaki ekran görüntüsünde matematik örneği gösterilmektedir. Kaydetseçeneğini seçin.

   

Önemli

JSON şemalarına, istemlerine veya kaydedilmiş iş akışı değişkenlerine gizli diziler (parolalar, anahtarlar, belirteçler) eklemeyin.

{
  "name": "math_response",
  "schema": {
    "type": "object",
    "properties": {
      "steps": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "explanation": {
              "type": "string"
            },
            "output": {
              "type": "string"
            }
          },
          "required": [
            "explanation",
            "output"
          ],
          "additionalProperties": false
        }
      },
      "final_answer": {
        "type": "string"
      }
    },
    "additionalProperties": false,
    "required": [
      "steps",
      "final_answer"
    ]
  },
  "strict": true
}

1. Eylem ayarları'nı seçin. Ardından json_object/json_schema çıktısını farklı kaydet olarak seçin.

2. Yeni değişken oluştur'u seçin. Bir değişken adı seçin ve ardından Bitti'yi seçin.

   

Ek özellikleri yapılandırma

• YAML görselleştiricisi görünümü: İş akışını YAML dosyası olarak depolamak için YAML Görselleştirici Görünümü geçiş düğmesini Açık olarak ayarlayın. Görselleştiricide veya YAML görünümünde düzenleyin. Kaydetme, tam sürüm geçmişine sahip yeni bir sürüm oluşturur.

  Görselleştirici ve YAML düzenlenebilir. YAML dosyasındaki değişiklikler görselleştiricide hemen görünür.

• Sürüm Oluşturma: Her kaydetme yeni, değiştirilemez bir sürüm oluşturur. Sürüm geçmişini görüntülemek veya eski sürümleri silmek için Kaydet düğmesinin sol tarafındaki Sürüm açılan listesini açın.

• Notlar: Ek bağlam için iş akışı görselleştiricisine not ekleyin. Görselleştiricinin sol üst köşesinde Not ekle'yi seçin.

Power Fx ile ifadeler oluşturma

Power Fx, Excel gibi formüller kullanan az kodlu bir dildir. Aracılarınızın verileri işlemesine olanak tanıyan karmaşık mantık oluşturmak için Power Fx'i kullanın. Örneğin, Power Fx formülü değişken bir değer ayarlayabilir, bir dizeyi ayrıştırabilir veya bir koşulu değerlendirebilir. Daha fazla bilgi edinmek için bkz. Power Fx genel görünümü ve formül referansı.

Formülde değişkenler kullanma

Power Fx formülünde bir değişken kullanmak için değişkenin kapsamını belirtmek için adına bir önek eklemeniz gerekir:

• Sistem değişkenleri için System.
• Yerel değişkenler için Local.

Sistem değişkenleri şunlardır:

İsim	Description
Activity	Geçerli etkinlik hakkında bilgi
Bot	Aracı hakkında bilgi
Conversation	Geçerli konuşma hakkında bilgi
Conversation.Id	Geçerli konuşmanın benzersiz kimliği
Conversation.LocalTimeZone	Kullanıcının IANA Saat Dilimi Veritabanı biçimindeki saat dilimi
Conversation.LocalTimeZoneOffset	Geçerli yerel saat dilimi için UTC'den saat uzaklığı
Conversation.InTestMode	Konuşmanın test tuvalinde gerçekleşip gerçekleşmediğini gösteren Boole bayrağı
ConversationId	Geçerli konuşmanın benzersiz kimliği
InternalId	Sistem için iç tanımlayıcı
LastMessage	Kullanıcının gönderdiği önceki ileti hakkında bilgi
LastMessage.Id	Kullanıcının gönderdiği önceki iletinin kimliği
LastMessage.Text	Kullanıcının gönderdiği önceki ileti
LastMessageId	Kullanıcının gönderdiği önceki iletinin kimliği
LastMessageText	Kullanıcının gönderdiği önceki ileti
Recognizer	Amaç tanıma ve tetikleme iletisi hakkında bilgi
User	Şu anda müşteri temsilcisiyle konuşan kullanıcı hakkında bilgi
User.Language	Konuşma başına kullanıcı dili yerel ayarı
UserLanguage	Konuşma başına kullanıcı dili yerel ayarı

Formülde sabit değerler kullanma

Bir Power Fx formülünde değişkenlerin kullanımına ek olarak, sabit değerler girebilirsiniz. Formülde bir değişmez değer kullanmak için değeri, türüne karşılık gelen formatta girmeniz gerekir.

Aşağıdaki tabloda veri türleri ve karşılık gelen değişmez değerlerin biçimi listelenmiştir:

Türü	Format örnekleri
Dize	"hi", "hello world!", "copilot"
Boolean	Yalnızca true veya false
Sayı	1, 532, 5.258,-9201
Kayıt ve tablo	[1], [45, 8, 2], ["cats", "dogs"], , { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
Tarih ve saat	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Seçim	Desteklenmez
Blank	Yalnızca Blank()

Ortak Power Fx formülleri

Aşağıdaki tabloda, her veri türüyle kullanabileceğiniz Power Fx formülleri listelenir.

Türü	Power Fx formülleri
Dize	Text işlevi Concat ve Concatenate işlevleri Len işlevi Lower, Upper ve Proper işlevleri IsMatch, Match ve MatchAll işlevleri EndsWith ve StartsWith işlevleri Find işlevi Değiştir ve Yerine Koyma işlevi
Boolean	Boolean işlevi And, Or ve Not işlevleri If ve Switch işlevleri
Sayı	Decimal, Float ve Value işlevleri Int, Round, RoundDown, RoundUp ve Trunc işlevleri
Kayıt ve tablo	Concat ve Concatenate işlevleri Count, CountA, CountIf ve CountRows işlevleri ForAll işlevi First, FirstN, Index, Last ve LastN işlevleri Filter, Search ve LookUp işlevleri JSON işlevi ParseJSON işlevi
Tarih ve saat	Date, DateTime ve Time işlevleri DateValue, TimeValue ve DateTimeValue işlevleri Day, Month, Year, Hour, Minute, Second ve Weekday işlevleri Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday işlevleri DateAdd, DateDiff ve TimeZoneOffset işlevleri Text işlevi
Blank	Blank, Coalesce, IsBlank ve IsEmpty işlevleri Error, IfError, IsError, IsBlankOrError işlevleri

Power Fx ile değişken ayarlama

Bu örnek, bir müşterinin adını büyük harflerle depolamayı ve çıkışını yapmayı gösterir:

1. bir iş akışı oluşturun ve Soru sorun düğümü ekleyin.

2. Görüntülenen bölmedeki Soru sor kutusuna Adınız nedir? veya başka bir ileti girin. Kullanıcı yanıtını farklı kaydet kutusuna bir değişken adı girin; örneğin, Var01. Ardından Bitti'yi seçin.

   

3. İleti gönder eylemi ekleyin. Görüntülenen bölmede, Gönderilecek ileti alanına girin {Upper(Local.Var01)}. Ardından Bitti'yi seçin.

   

4. Önizlemeyi seçin.

5. Önizleme bölmesinde, iş akışını çağırmak için aracıya bir ileti gönderin.

   

Power Fx ile if/else akışları oluşturma

Bu örnekte, if/else akışı ekleme ve sistem değişkenleriyle koşul oluşturma işlemleri gösterilmektedir.

1. bir iş akışı oluşturun ve Soru sorun düğümü ekleyin.

2. Simgeyi + seçin ve bir if/else akışı ekleyin.

3. Her if/else dalı için bir koşul deyimi oluşturmak için System. kutusuna yazın.

   

4. İş akışındaki sonraki adım için bir Sonraki Eylem'i seçin.

5. Seç. Bitti. İş akışınızı kaydetmek için Kaydet'i seçin.

Sorun giderme

Sorun	Çözüm
İş akışları seçeneği görünmüyor veya iş akışlarını oluşturamıyor/düzenleyemez	Projenizde Katkıda Bulunan rolüne veya daha üst bir role sahip olduğunuzu onaylayın. Bkz. Foundry'de Azure rol tabanlı erişim denetimi (RBAC).
Değişiklikler düzenlendikten sonra görünmüyor	Görselleştiricide Kaydet'i seçin. Dökümhane değişiklikleri otomatik olarak kaydetmez.
İş akışı çalıştırıldığında beklenmeyen bir çıktı üretir.	Her bir ajan düğümüne bir ajanın atanmış olduğunu doğrulayın. Kaydedilen çıkışların (JSON şeması) geçerli olup olmadığını denetleyin.
Power Fx formül hatası: "Ad geçerli değil"	Doğru kapsam ön ekini ekleyin. Sistem değişkenleri ve System. yerel değişkenler için kullanınLocal..
Power Fx formül hatası: "Tür uyuşmazlığı"	Değişken türünün beklenen girişle eşleştiğinden emin olun. Veya gerekirse gibi Text()Value() dönüştürme işlevlerini kullanın.
İş akışı zaman aşımına uğradı	Karmaşık iş akışlarını daha küçük segmentlere ayırın. Dış hizmetlerin beklenen zaman çerçeveleri içinde yanıt verdiğini denetleyin.

Kaynakları temizle

Bir iş akışını silmek için artık ihtiyacınız yok:

1. İş akışını Dökümhane portalında açın.
2. Kaydet düğmesinin sol tarafındaki Sürüm açılan listesini seçin.
3. Kaldırmak istediğiniz sürüm için Sil'i seçin.

İlgili içerik

• Döküm Aracı Hizmeti hakkında SSS
• Döküm ajanları için araç en iyi uygulamaları
• Visual Studio Code'da Bildirim temelli (Düşük kodlu) Aracı iş akışlarıyla çalışma
• Visual Studio Code'da Barındırılan (Pro-code) Aracı iş akışlarıyla çalışma