Microsoft Dökümhane portalındaki akışlar için Python aracı (klasik)

Yalnızca şunlar için geçerlidir:Dökümhane (klasik) portalı. Bu makale yeni Dökümhane portalında kullanılamaz. Yeni portal hakkında daha fazla bilgi edinin.

Not

Bu makaledeki bağlantılar, şu anda görüntülediğiniz Dökümhane (klasik) belgeleri yerine yeni Microsoft Foundry belgelerinde içerik açabilir.

Uyarı

Microsoft Foundry ve Azure Machine Learning'daki istem akışı 20 Nisan 2027'de kullanımdan kaldırılacaktır. Prompt flow artık yeni geliştirmelerde önerilmemektedir. Mevcut prompt akışı uygulamalarını ve dağıtımlarını 20 Nisan 2027'den önce Microsoft Agent Framework'e geçirin.

Prompt flow kapsayıcı imajları, güvenlik ve paket güncellemeleri dahil, artık güncelleme almıyor. Bu, promptflow-runtime, promptflow-runtime-stable ve promptflow-python dahil olmak üzere Prompt flow çalışma zamanı görüntüleri için geçerlidir.

20 Nisan 2027'den sonra, Microsoft Foundry ve Azure Machine Learning’deki web tabanlı yazma deneyimi, VS Code uzantıları ve ilgili Prompt flow kapsayıcı görüntüleri dahil olmak üzere Prompt flow artık desteklenmeyecek veya kullanılamayacaktır.

Uygulamanız istem akışı dağıtımlarına veya çalışma zamanı görüntülerine bağımlıysa, bu iş yüklerini kullanımdan kaldırma tarihinden önce Microsoft Agent Framework gibi desteklenen alternatiflere taşımayı planlayın. Geçiş yönergeleri için bkz. Prompt flow geçiş kılavuzu ve geçiş kod örnekleri.

istem akışı Python aracı, bağımsız yürütülebilir düğümler olarak özelleştirilmiş kod parçacıkları sağlar. Hızlı bir şekilde Python araçları oluşturabilir, kodu düzenleyebilir ve sonuçları doğrulayabilirsiniz.

Önkoşullar

Önemli

Bu makale, merkez tabanlı projeler için eski sistem desteği sağlar. Foundry projeleri için çalışmaz. Bkz. Ne tür bir projem olduğunu nasıl bilebilirim?

SDK uyumluluk notu: Kod örnekleri için belirli bir Microsoft Döküm SDK'sı sürümü gerekir. Uyumluluk sorunlarıyla karşılaşırsanız hub tabanlı bir projeden Foundry projesine geçiş yapmayı göz önünde bulundurun.

• Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren bir free Azure hesabı oluşturun.
• Bir projeniz yoksa merkez tabanlı bir proje oluşturun.

Python aracıyla oluşturma

1. Microsoft Foundry içinde akış oluşturun veya açın. Daha fazla bilgi için bkz. Akış oluşturma.

2. Python aracını akışınıza eklemek için + Python öğesini seçin.

   

3. Inputs tablosunda açıklanan Python aracı giriş parametrelerinin değerlerini girin. Örneğin, Code giriş metin kutusuna aşağıdaki Python kodunu girin:

   from promptflow import tool
   
   @tool
   def my_python_tool(message: str) -> str:
       return 'hello ' + message
   

   Daha fazla bilgi için bkz. Python kod girişi gereksinimleri.

4. Gerektiğinde akışınıza daha fazla araç ekleyin. Veya akışı çalıştırmak için Çalıştır'ı seçin.

5. Çıkışlar Çıkışlar tablosunda açıklanmıştır. Önceki örnek Python kod girişi temelinde, giriş iletisi "dünya" ise çıkış hello world olur.

Giriş

Kaynak kodu kaydettikten sonra, giriş listesi araç işlevinin parametrelerine bağlı olarak değişir. Bağımsız değişkenlere ve return değerlere tür eklemek, aracın türleri düzgün göstermesine yardımcı olur.

Adı	Türü	Açıklama	Gerekli
Kod	Dize	Python kod parçacığı.	Evet
Giriş	-	Araç işlevi parametrelerinin ve atamalarının listesi.	-

Çıkışlar

Çıktı, Python araç işlevinin return değeridir. Örneğin, aşağıdaki Python araç işlevini göz önünde bulundurun:

from promptflow import tool

@tool
def my_python_tool(message: str) -> str:
    return 'hello ' + message

Giriş iletisi "dünya" ise çıkış hello world olur.

Türler

Türü	Python örnek	Açıklama
Int	param: int	Tamsayı türü
Boolean	param: bool	Boole türü
Dize	parametre: str	Dize türü
Çift	parametre: float	Çift tür
Liste	param: list veya param: List[T]	Liste türü
Nesne	param: dict veya param: Dict[K, V]	Nesne türü
Bağlantı	param: CustomConnection	Bağlantı türü özel olarak işlenir.

Tip açıklaması Connection olan parametreleri bağlantı girişi olarak değerlendirin. Bu işlem şu anlama gelir:

• İstem akışı uzantısı, bağlantıyı seçmek için bir seçici gösterir.
• Yürütme sırasında, istem akışı geçirdiğiniz parametre değerinden aynı ada sahip bağlantıyı bulmaya çalışır.

Not

Union[...] türü ek açıklaması yalnızca bağlantı türünü destekler. Örnek olarak verilmiştir param: Union[CustomConnection, OpenAIConnection].

Python kod girişi gereksinimleri

Bu bölümde, Python aracının Python kod girişi gereksinimleri açıklanmaktadır.

• Python araç kodu, gerekli modül içeri aktarmaları da dahil olmak üzere eksiksiz Python kodundan oluşmalıdır.
• Python araç kodu, yürütme için giriş noktası olarak hizmet veren @tool (araç işlevi) ile süslenmiş bir işlev içermelidir. @tool Dekoratörü kod parçacığı içinde yalnızca bir kez uygulayın.
• Inputs bölümünde Python araç işlevi parametreleri atayın.
• Python araç işlevi, aracın çıktısı olan bir return deyimine ve değerine sahip olmalıdır.

Aşağıdaki Python kodu, en iyi yöntemlerin bir örneğidir:

from promptflow import tool

@tool
def my_python_tool(message: str) -> str:
    return 'hello ' + message

Python aracında özel bir bağlantıyı tüketme

Kimlik doğrulamasıyla dış hizmetleri çağırmayı gerektiren bir Python aracı geliştiriyorsanız, bir istem akışında özel bağlantıyı kullanın. Bu bağlantıyı kullanarak erişim anahtarını güvenli bir şekilde depolayabilir ve ardından Python kodunuzda alabilirsiniz.

Özel bağlantı oluşturma

Tüm büyük dil modeli API anahtarınızı veya diğer gerekli kimlik bilgilerini depolayan özel bir bağlantı oluşturun.

Önemli

Bu makale, merkez tabanlı projeler için eski sistem desteği sağlar. Foundry projeleri için çalışmaz. Bkz. Ne tür bir projem olduğunu nasıl bilebilirim?

SDK uyumluluk notu: Kod örnekleri için belirli bir Microsoft Döküm SDK'sı sürümü gerekir. Uyumluluk sorunlarıyla karşılaşırsanız hub tabanlı bir projeden Foundry projesine geçiş yapmayı göz önünde bulundurun.

• Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren bir free Azure hesabı oluşturun.
• Bir projeniz yoksa merkez tabanlı bir proje oluşturun.

1. Projenizin Yönetim merkezi sayfasına gidin.

2. Hub veya Project başlığı altında Bağlanılan kaynaklar öğesini seçin.

3. + Yeni Bağlantı'ya tıklayın.

4. Özel hizmet'i seçin. Bağlantı adınızı tanımlayabilirsiniz. Kimlik bilgilerinizi ve anahtarlarınızı depolamak üzere birden çok anahtar-değer çifti eklemek için Anahtar-değer çiftleri ekle'yi seçin.

   Not

   En az bir anahtar-değer çiftinin gizli olarak ayarlandığından emin olun. Aksi takdirde, bağlantı başarıyla oluşturulmaz. Bir anahtar-değer çiftini gizli dizi olarak ayarlamak için anahtar değerinizi şifrelemek ve depolamak için gizli dizi'yi seçin.

Python'da özel bağlantı kullanma

Python kodunuzda özel bir bağlantıyı kullanmak için:

1. Python düğümünüzün kod bölümünde, from promptflow.connections import CustomConnection kullanarak özel bağlantı kitaplığını içeri aktarın. Araç işlevinde türüne CustomConnection ait bir giriş parametresi tanımlayın.
2. Girişi giriş bölümüne ayrıştırın. Ardından değer açılır listesinden hedef özel bağlantınızı seçin.

Örneğin:

from promptflow import tool
from promptflow.connections import CustomConnection

@tool
def my_python_tool(message: str, myconn: CustomConnection) -> str:
    # Get authentication key-values from the custom connection
    connection_key1_value = myconn.key1
    connection_key2_value = myconn.key2

Sonraki adımlar

• Akış oluşturma hakkında daha fazla bilgi edinin