herramienta Python para gestionar flujos en el Portal de Foundry de Microsoft (clásico)

Solo se aplica a:portal Foundry (clásico). Este artículo no está disponible para el nuevo portal de Foundry. Obtenga más información sobre el nuevo portal.

La herramienta de flujo de mensajes Python proporciona fragmentos de código personalizados como nodos ejecutables independientes. Puede crear rápidamente herramientas de Python, editar código y comprobar los resultados.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.
• Si no tiene uno, cree un proyecto basado en hub.

Compilación con la herramienta Python

1. Cree o abra un flujo en Microsoft Foundry. Para obtener más información, consulte Creación de un flujo.

2. Seleccione + Python para agregar la herramienta de Python al flujo.

   

3. Escriba valores para los parámetros de entrada de la herramienta Python que se describen en la tabla Inputs. Por ejemplo, en el cuadro de texto de entrada Code escriba el código Python siguiente:

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

   Para obtener más información, consulte Python requisitos de entrada de código.

4. Agregue más herramientas a tu flujo de trabajo, según sea necesario. O bien, seleccione Ejecutar para ejecutar el flujo.

5. Las salidas se describen en la tabla Salidas. En función del ejemplo de código Python anterior, si el mensaje de entrada es "mundo", la salida es hello world.

Entradas

La lista de entradas cambia en función de los argumentos de la función de herramienta, después de guardar el código. Agregar tipo a argumentos y return valores ayuda a la herramienta a mostrar los tipos correctamente.

Salidas

La salida es el valor return de la función de herramienta Python. Por ejemplo, considere la siguiente función de herramienta Python:

from promptflow import tool

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

Si el mensaje de entrada es "world", la salida es hello world.

Tipos

Tratar los parámetros con anotación de tipo Connection como entradas de conexión. Este tratamiento significa:

• La extensión de flujo del símbolo del sistema muestra un selector para seleccionar la conexión.
• Durante el tiempo de ejecución, el flujo de avisos intenta encontrar la conexión con el mismo nombre a partir del valor del parámetro que pasa.

requisitos de entrada de código de Python

En esta sección se describen los requisitos para la entrada de código Python para la herramienta Python.

• El código de herramienta Python debe constar de código Python completo, incluidas las importaciones de módulo necesarias.
• El código de herramienta de Python debe contener una función decorada con @tool (función de herramienta), que actúa como punto de entrada para la ejecución. Aplique el @tool decorador solo una vez dentro del fragmento de código.
• Asigne los parámetros de función de la herramienta Python en la sección Inputs.
• La función de Python debe tener una declaración de retorno y un valor, que es la salida de la herramienta.

El código de Python siguiente es un ejemplo de procedimientos recomendados:

from promptflow import tool

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

Consumo de una conexión personalizada en la herramienta Python

Si está desarrollando una herramienta de Python que requiere llamar a servicios externos con autenticación, utilice una conexión personalizada en un flujo de comandos. Con esta conexión, puede almacenar de forma segura la clave de acceso y, a continuación, recuperarla en el código de Python.

Creación de una conexión personalizada

Cree una conexión personalizada que almacene todas las claves de API de su modelo de lenguaje extenso u otras credenciales necesarias.

• Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.
• Si no tiene uno, cree un proyecto basado en hub.

1. Vaya a la página Centro de administración del proyecto.

2. En el encabezado Hub o Project, seleccione Recursos conectados.

3. Seleccione + Nueva conexión.

4. Seleccione Servicio personalizado . Puede definir el nombre de la conexión. Seleccione Agregar pares clave-valor para agregar varios pares clave-valor para almacenar las credenciales y las claves.

   Nota

   Asegúrese de que al menos un par clave-valor esté establecido como secreto. De lo contrario, la conexión no se crea correctamente. Para establecer un par clave-valor como secreto, seleccione secreto para cifrar y almacenar el valor de clave.

Consumo de una conexión personalizada en Python

Para consumir una conexión personalizada en tu código en Python:

1. En la sección de código del nodo de Python, importe la biblioteca de conexiones personalizada mediante from promptflow.connections import CustomConnection. Defina un parámetro de entrada del tipo CustomConnection en la función de herramienta.
2. Analice la entrada en la sección de entrada. A continuación, seleccione la conexión personalizada de destino en la lista desplegable de valores.

Por ejemplo:

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

Pasos siguientes

• Más información sobre cómo crear un flujo