Nástroj Python pro toky v Azure AI Studiu

Důležité

Některé funkce popsané v tomto článku můžou být dostupné jenom ve verzi Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

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

Sestavení pomocí nástroje Python

1. Vytvořte nebo otevřete tok v Azure AI Studiu. 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 Pythonu, které jsou popsány v tabulce Vstupy. Do textového pole Pro zadání kódu můžete například zadat následující kód Pythonu:

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

   Další informace najdete v tématu Požadavky na zadání kódu Pythonu.

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

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

Vstupy

Po uložení kódu se seznam vstupů mě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.

Name	Typ	Popis	Povinní účastníci
Kód	string	Fragment kódu Pythonu.	Ano
Vstupy	-	Seznam parametrů funkce nástroje a jeho přiřazení	-

Výstupy

Výstupem je return hodnota 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 Pythonu	Popis
int	parametr: int	Celočíselná typ
bool	parametr: bool	Logický typ
string	param: str	Typ řetězce
double	parametr: float	Dvojitý typ
list	param: list nebo param: List[T]	Typ seznamu
objekt	param: dict or param: Dict[K, V]	Object type
Connection	parametr: CustomConnection	Typ připojení se zpracovává speciálně.

Parametry s poznámkami Connection typu se považují za vstupy připojení, což znamená:

• Rozšíření toku výzvy zobrazuje selektor pro výběr připojení.
• Během provádění se tok výzvy pokusí najít připojení se stejným názvem z hodnoty parametru, která byla předána.

Poznámka:

Poznámka Union[...] k typu je podporována pouze pro typ připojení. Příklad: param: Union[CustomConnection, OpenAIConnection].

Požadavky na zadání kódu Pythonu

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

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

Následující kód Pythonu je příkladem osvědčených postupů:

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 Pythonu, který vyžaduje volání externích služeb s ověřováním, můžete použít vlastní připojení v toku výzvy. Umožňuje bezpečně uložit přístupový klíč a pak ho načíst do kódu Pythonu.

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.

1. Přejděte na stránku Nastavení projektu. Pak vyberte + Nové připojení.

2. Vyberte Vlastní službu. Můžete definovat název připojení. Výběrem možnosti Přidat páry klíč-hodnota můžete přidat několik párů klíč-hodnota pro uložení přihlašovacích údajů a klíčů.

   Poznámka:

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

Využívání vlastního připojení v Pythonu

Využití vlastního připojení v kódu Pythonu:

1. V části kódu v uzlu Pythonu naimportujte vlastní knihovnu from promptflow.connections import CustomConnectionpřipojení . Definujte vstupní parametr typu CustomConnection ve funkci nástroje.
2. Parsujte vstup do vstupního oddílu. 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