nástroj Python pro toky na portálu Microsoft Foundry (classic)

Platí jenom pro:Portál Foundry (Classic). Tento článek není k dispozici pro nový portál Foundry. Přečtěte si další informace o novém portálu.

Poznámka

Odkazy v tomto článku můžou otevírat obsah v nové dokumentaci Microsoft Foundry místo dokumentace Foundry (classic), kterou si právě prohlížíte.

Upozornění

Prompt flow ve službách Microsoft Foundry a Azure Machine Learning bude ukončena 20. dubna 2027. Prompt flow se již pro nový vývoj nedoporučuje. Migrujte stávající aplikace a nasazení Prompt flow na platformu Microsoft Agent Framework před 20. dubnem 2027.

Kontejnerové image Prompt flow již nejsou aktualizovány, a to včetně aktualizací zabezpečení a balíčků. To platí pro image modulu runtime pro Prompt flow, včetně promptflow-runtime, promptflow-runtime-stable a promptflow-python.

Po 20. dubnu 2027 už Prompt flow, včetně webového prostředí pro vytváření ve službách Microsoft Foundry a Azure Machine Learning, rozšíření pro VS Code a souvisejících imagí kontejnerů Prompt flow, nebude podporován ani dostupný.

Pokud vaše aplikace závisí na nasazeních Prompt flow nebo bitových kopiích modulu runtime, naplánujte přesun těchto úloh na podporované alternativy, jako je Microsoft Agent Framework, před datem vyřazení. Pokyny k migraci najdete v průvodci migrací nástroje Prompt flow a v ukázkách kódu pro migraci.

Nástroj pro tok výzvy v Pythonu poskytuje přizpůsobené úryvky kódu jako autonomně spustitelné uzly. Můžete rychle vytvářet nástroje Pythonu, upravovat kód a ověřovat výsledky.

Požadavky

Důležité

Tento článek obsahuje starší verzi podpory pro projekty založené na centrech. Nebude fungovat pro projekty Foundry. Jak zjistím, jaký typ projektu mám?

Poznámky k kompatibilitě sady SDK: Příklady kódu vyžadují konkrétní verzi sady SDK Microsoft Foundry. Pokud narazíte na problémy s kompatibilitou, zvažte migraci z centra do projektu Foundry.

• Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet free Azure, který zahrnuje bezplatné zkušební předplatné.
• Pokud ho nemáte, vytvořte projekt založený na centru.

Sestavení pomocí nástroje Python

1. Vytvořte nebo otevřete tok v Microsoft Foundry. Další informace najdete v tématu Vytvoření toku.

2. Vyberte + Python a přidejte do toku nástroj Python.

   

3. Zadejte hodnoty vstupních parametrů nástroje Python, které jsou popsány v tabulce Vputs. Do textového pole Code zadejte následující Python kód:

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

   Další informace najdete v tématu požadavky na vstup kódu v Pythonu.

4. Podle potřeby přidejte do toku další nástroje. Nebo vyberte Spustit, abyste spustili tok.

5. Výstupy jsou popsány v tabulce Výstupy. Na základě vstupního kódu z předchozího příkladu v Pythonu, pokud je vstupní zpráva "world," výstup je hello world.

Vstupy

Seznam vstupů se po uložení kódu změní na základě argumentů funkce nástroje. Přidání typu k argumentům a return hodnotám pomáhá nástroji správně zobrazit typy.

Jméno	Typ	Popis	Požadované
Code	řetězec	Fragment kódu Python.	Ano
Vstupy	-	Seznam parametrů funkce nástroje a jeho přiřazení	-

Výstupy

Výstupem je hodnota return funkce nástroje Python. Představte si například následující funkci nástroje Python:

from promptflow import tool

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

Pokud je vstupní zpráva "world", výstup je hello world.

Typy

Typ	příklad Python	Popis
Int	parametr: int	Celočíselný typ
Bool	parametr: bool	Logický typ
řetězec	parametr: str	Typ řetězce
Dvojité	parametr: float	Dvojitý typ
Seznam	param: list nebo param: List[T]	Typ seznamu
objekt	param: dict nebo param: Dict[K, V]	Typ objektu
Připojení	parametr: CustomConnection	Typ připojení se zpracovává speciálně.

Zacházejte s parametry s anotací typu Connection jako vstupy pro připojení. Tato léčba znamená:

• Rozšíření toku výzvy zobrazuje selektor pro výběr připojení.
• Během provádění se průběh výzvy pokusí najít připojení se stejným názvem podle hodnoty parametru, kterou předáte.

Poznámka

Poznámka Union[...] typu podporuje pouze typ připojení. Příkladem je param: Union[CustomConnection, OpenAIConnection].

Požadavky na vstup kódu v Pythonu

Tato část popisuje požadavky na vstup kódu Python pro nástroj Python.

• Python kód nástroje by se měl skládat z kompletního Python kódu, včetně všech nezbytných importů modulů.
• Python kód nástroje musí obsahovat funkci zdobenou @tool (funkce nástroje), která slouží jako vstupní bod pro provádění. @tool Dekorátor použijte pouze jednou v rámci fragmentu kódu.
• V části Inputs přiřaďte parametry funkce nástroje Python.
• Python funkce nástroje musí mít návratový příkaz a hodnotu, což je výstup nástroje.

Příkladem osvědčených postupů je následující Python kód:

from promptflow import tool

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

Využití vlastního připojení v nástroji Python

Pokud vyvíjíte nástroj v Pythonu, který vyžaduje volání externích služeb s ověřováním, použijte vlastní připojení v rámci procesu výzvy. Pomocí tohoto připojení můžete přístupový klíč bezpečně uložit a pak ho načíst do kódu Python.

Vytvoření vlastního připojení

Vytvořte vlastní připojení, které ukládá všechny klíče rozhraní API pro velký jazykový model nebo jiné požadované přihlašovací údaje.

Důležité

Tento článek obsahuje starší verzi podpory pro projekty založené na centrech. Nebude fungovat pro projekty Foundry. Jak zjistím, jaký typ projektu mám?

Poznámky k kompatibilitě sady SDK: Příklady kódu vyžadují konkrétní verzi sady SDK Microsoft Foundry. Pokud narazíte na problémy s kompatibilitou, zvažte migraci z centra do projektu Foundry.

• Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet free Azure, který zahrnuje bezplatné zkušební předplatné.
• Pokud ho nemáte, vytvořte projekt založený na centru.

1. Přejděte na stránku Centrum pro správu vašeho projektu.

2. V části Hub nebo Project vyberte Připojené prostředky.

3. Vyberte + Nové připojení.

4. Vyberte Vlastní službu. Můžete definovat název připojení. Vyberte Přidat páry klíč-hodnota a přidejte několik párů klíč-hodnota pro uložení přihlašovacích údajů a klíčů.

   Poznámka

   Ujistěte se, že je alespoň jeden pár klíč-hodnota nastaven jako tajný. V opačném případě se připojení úspěšně nevytvořilo. Chcete-li nastavit pár klíč-hodnota jako tajný, vyberte je tajný pro zašifrování a uložení hodnoty klíče.

Použijte vlastní připojení v jazyce Python

Použití vlastního připojení ve vašem Python kódu:

1. V části kódu uzlu Python naimportujte vlastní knihovnu připojení pomocí from promptflow.connections import CustomConnection. Definujte vstupní parametr typu CustomConnection ve funkci nástroje.
2. Zpracujte vstup do vstupní sekce. Pak v rozevíracím seznamu hodnot vyberte své cílové vlastní připojení.

Příklad:

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

Další kroky

• Další informace o tom, jak vytvořit tok