Python-eszköz folyamatokhoz az Azure AI Studióban

Fontos

A cikkben ismertetett funkciók némelyike csak előzetes verzióban érhető el. Ez az előzetes verzió szolgáltatásszint-szerződés nélkül érhető el, és éles számítási feladatokhoz nem javasoljuk. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.

A parancssori folyamat Python-eszköze egyéni kódrészleteket kínál önálló végrehajtható csomópontokként. Gyorsan létrehozhat Python-eszközöket, szerkesztheti a kódot, és ellenőrizheti az eredményeket.

Buildelés a Python-eszközzel

1. Folyamat létrehozása vagy megnyitása az Azure AI Studióban. További információ: Folyamat létrehozása.

2. Válassza a + Python lehetőséget a Python-eszköznek a folyamathoz való hozzáadásához.

   

3. Adja meg az Inputs táblában leírt Python-eszköz bemeneti paramétereinek értékeit. A Kód beviteli szövegmezőjében például a következő Python-kódot adhatja meg:

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

   További információ: Python-kódbeviteli követelmények.

4. Szükség szerint adjon hozzá további eszközöket a folyamathoz. Vagy válassza a Futtatás lehetőséget a folyamat futtatásához.

5. A kimeneteket a Kimenetek táblában ismertetjük. Az előző Példa Python-kódbemenet alapján, ha a bemeneti üzenet "világ", akkor a kimenet a hello worldkövetkező.

Bevitelek

A bemenetek listája az eszközfüggvény argumentumai alapján változik a kód mentése után. A típus argumentumokhoz és return értékekhez való hozzáadása segít az eszköznek a típusok megfelelő megjelenítésében.

Név	Típus	Leírás	Kötelező
Kód	húr	A Python-kódrészlet.	Igen
Bevitelek	-	Az eszközfüggvény paramétereinek és hozzárendeléseinek listája.	-

Kimenetek

A kimenet a return Python-eszközfüggvény értéke. Vegyük például a következő Python-eszközfüggvényt:

from promptflow import tool

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

Ha a bemeneti üzenet "világ", a kimenet a hello worldkövetkező: .

Típusok

Típus	Python-példa	Leírás
egész	param: int	Egész szám típusa
logikai	param: bool	Logikai típus
húr	param: str	Sztring típusa
double	param: float	Dupla típus
list	param: list vagy param: List[T]	Lista típusa
object	param: dict vagy param: Dict[K, V]	Objektumtípus
Connection	param: Egyéni Csatlakozás ion	Csatlakozás ion típust speciálisan kezelik.

A típusjegyzetekkel rendelkező Connection paraméterek kapcsolati bemenetekként vannak kezelve, ami azt jelenti, hogy:

• A parancssori folyamat bővítménye egy választót jelenít meg a kapcsolat kiválasztásához.
• A végrehajtási idő alatt a parancssori folyamat megkísérli megkeresni az azonos nevű kapcsolatot az átadott paraméterértékből.

Feljegyzés

A Union[...] típusjegyzet csak kapcsolattípus esetén támogatott. Például: param: Union[CustomConnection, OpenAIConnection].

Python-kódbeviteli követelmények

Ez a szakasz a Python-eszköz Python-kódbemenetének követelményeit ismerteti.

• A Python-eszközkódnak egy teljes Python-kódból kell állnia, beleértve a szükséges modulimportálásokat is.
• A Python-eszközkódnak tartalmaznia kell egy (eszközfüggvény) kitüntetett @tool függvényt, amely a végrehajtás belépési pontjaként szolgál. A @tool dekoratőrt csak egyszer szabad alkalmazni a kódrészleten belül.
• A Python-eszközfüggvény paramétereit a Inputs szakaszban kell hozzárendelni.
• A Python eszközfüggvénynek visszatérési utasítással és értékkel kell rendelkeznie, amely az eszköz kimenete.

A következő Python-kód egy példa az ajánlott eljárásokra:

from promptflow import tool

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

Egyéni kapcsolat használata a Python-eszközben

Ha olyan Python-eszközt fejleszt, amely külső szolgáltatásokat igényel hitelesítéssel, használhatja az egyéni kapcsolatot egy parancssori folyamatban. Lehetővé teszi a hozzáférési kulcs biztonságos tárolását, majd a Python-kódban való lekérését.

Egyéni kapcsolat létrehozása

Hozzon létre egy egyéni kapcsolatot, amely az összes nagy nyelvi modell API-kulcsát vagy más szükséges hitelesítő adatait tárolja.

1. Lépjen a projekt Gépház lapjára. Ezután válassza az + Új Csatlakozás ion lehetőséget.

2. Válassza az Egyéni szolgáltatás lehetőséget. Megadhatja a kapcsolat nevét. A hitelesítő adatok és kulcsok tárolásához több kulcs-érték pár is hozzáadható a Kulcs-érték párok hozzáadása lehetőség kiválasztásával.

   Feljegyzés

   Győződjön meg arról, hogy legalább egy kulcs-érték pár titkosként van beállítva. Ellenkező esetben a kapcsolat nem jön létre sikeresen. Ha titkos kulcs-érték párokat szeretne beállítani, válassza a titkos kulcs lehetőséget a kulcsérték titkosításához és tárolásához.

Egyéni kapcsolat használata a Pythonban

Egyéni kapcsolat használata a Python-kódban:

1. A Python-csomópont kódszakaszában importálja az egyéni kapcsolattárat from promptflow.connections import CustomConnection. Adja meg az CustomConnection eszközfüggvény típusának bemeneti paraméterét.
2. A bemeneti szakasz bemenetének elemzése. Ezután válassza ki a cél egyéni kapcsolatot az érték legördülő listában.

Példa:

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

Következő lépések

• További információ a folyamat létrehozásáról