Aracılığıyla paylaş


Bilgiyi iletmek için giriş ve çıkış değişkenlerini kullanın

Aracı akışları ve Copilot Studio aracıları arasında bilgi geçirmek için değişkenleri, giriş ve çıkış parametreleri olarak kullanın.

Önemli

Bir aracı, tek bir eylemde bir akıştan en fazla 1 MB veri alabilir. Ancak, bir aracının gönderebileceği değişken veya veri miktarı konusunda bir sınırlama yoktur.

Bu örnekte, giriş parametresi olan bir akış oluşturacak ve bunu çıkış parametresi olarak bir aracıya döndüreceksiniz.

Önkoşullar

Desteklenen parametre türleri

Copilot Studio aracıları, aracı akışları için aşağıdaki giriş ve çıkış parametrelerini destekler:

  • Sayı
  • Dize
  • Boolean

Aşağıdaki veri türleri desteklenmez:

  • Nesne
  • Tarih
  • Zaman damgası
  • Liste [Dize]
  • Liste [Sayı]
  • Liste [Boole]
  • Liste [Nesne]
  • Liste [Tarih]
  • Liste [Zaman Damgası]

Bir konu ve akış oluşturun

  1. Aracınızın Konular sayfasına gidin.

  2. Yankı iletisi adlı yeni bir konu oluşturun.

  3. Yankı tetikleme tümceciğini ekleyin.

  4. Bir Soru düğümü ekleyin ve "Bir şey söyleyin ve bunu size geri söyleyeceğim" iletisini girin.

  5. Tanımlama için Kullanıcının tam yanıtı'nı seçin.

  6. Kullanıcı yanıtını farklı kaydet seçeneği için değişkenin adını userResponse olarak değiştirin.

    Kullanıcının yanıtını toplayan Soru düğümünün ekran görüntüsü.

  7. Soru düğümünün altındaki Düğüm ekle simgesini seçin ve Araç ekle'yi seçin.

  8. Temel eylemler sekmesinde Yeni Aracı akışı'nı seçin. Aracı akışı tasarımcısı sekmesi, bir aracı tarafından çağrılan bir aracı akışı için bir başlangıç şablonuyla açılır. Akış iki eylem içerir: Bir aracı akışı çağırdığında ve Aracı yanıtladığında.

  9. Herhangi bir değişiklik yapmadan önce akışı kaydetmek için Yayımla'yı seçin. Akış başarıyla oluşturulduğunda bir bildirim görüntülenir.

  10. Konunuza dönmek için Aracıya geri dön'ü seçin. Akış için konunuza yeni bir Eylem düğümü eklenir.

  11. Akışı, aracınıza araç olarak eklemeyi tamamlamak için Kaydet'i seçin.

Akış ayrıntılarını düzenleme

  1. Akışı içeren Eylem düğümünde Akış ayrıntılarını görüntüle bağlantısını seçerek aracı akışına dönün.

  2. Akışın Genel Bakış sekmesinde, akışın ayrıntılarını düzenleyin ve adı Eko parametresi olarak değiştirin. Kaydet'i seçin.

  3. Tasarımcı sekmesine dönün.

Akışa bir giriş parametresi ekleme

  1. Bir aracı akışı çağırdığında akış tetikleyicisini seçin ve Bir giriş ekle'yi seçin.

  2. Metin seçeneğini belirleyin ve Dize_Giriş adını girin.

    Akış tetikleyicisi giriş parametresinin ekran görüntüsü.

Akışa bir çıkış parametresi ekleyin

  1. Aracıya yanıt ver yanıt eylemini seçin ve Çıktı ekle'yi seçin.

  2. Metin seçeneğini belirleyin ve Dize_Çıkış adını girin.

    Yanıt eylemi çıkış parametresinin ekran görüntüsü.

  3. Değer için kutuya bir eğik çizgi (/) girin, Dinamik içerik ekle'yi seçin ve ardından String_Input değişkenini seçin.

  4. Taslağı kaydet'e ve Yayımla'ya tıklayın. Copilot Studio, aracı akışı yayımlandığında sizi bilgilendirir.

  5. Aracı konu düzenleyicisine dönmek için Aracıya geri dön seçeneğini seçin. Konuya yeni eylem akışı eklendi.

Konudan akışı çağırın

  1. Yeni eylem düğümünü seçin.

  2. Akış giriş parametresini Soru düğümünden çıktı değişkenine ayarlayın: String_Input (dize) değerini userResponse değişkeninden alır.

    'Echo parametresi' akışını çağıran Eylem düğümünün ekran görüntüsü.

  3. Bir İleti düğümü seçin.

  4. Değişken ekle'yi ve ardından Dize_Çıkış öğesini seçin.

    Kullanıcı girişini yankılayan ileti düğümünün ekran görüntüsü.

  5. Kaydet'i seçin.

  6. Aracınızı test etme.

    Aracı görüşmesinin ekran görüntüsü.