Primeros pasos

Esta página te guía a través de la instalación del SDK, el andamiaje de un proyecto y la ejecución de tu primera función Python localmente.

Requisitos previos

• Python 3.10 o posterior.
• La CLIuipath y el SDK, instalados con pip.
• Una cuenta de UiPath con acceso a Orchestrator (para publicar e invocar).

Instalar el SDK

pip install uipath

Verifica la instalación:

uipath --version

Andamio de un proyecto

Crea un nuevo proyecto de función:

uipath new my-function

Esto aplica andamios a los archivos que editas:

Archivo	Propósito
main.py	Tu lógica de función y los modelos Input/Output. Se inicia como un ejemplo ejecutable.
pyproject.toml	Metadatos y dependencias del proyecto.
uipath.json	Declara los puntos de entrada a los que se puede llamar. El andamio registra main por ti.

Escribe tu primera función

Reemplaza la lógica andamiada en main.py:

from pydantic.dataclasses import dataclass


@dataclass
class Input:
    message: str = ""


@dataclass
class Output:
    reply: str = ""


def main(input: Input) -> Output:
    return Output(reply=f"Hello, {input.message}!")

El uipath.json andamiado ya declara este punto de entrada:

{
  "functions": {
    "main": "main.py:main"
  }
}

La clave (main) es el nombre del punto de entrada utilizado en los comandos CLI; el valor hace referencia al archivo y la función. Actualízala solo si cambias el nombre de la función o añades más puntos de entrada.

Generar el esquema del proyecto

Una vez definidos tus Input y Output, genera el esquema y los enlaces:

uipath init

Esto lee tu código y uipath.json y genera:

Archivo	Propósito
entry-points.json	Esquema JSON de entrada/salida derivado de tus modelos, utilizado para la vinculación de variables.
bindings.json	Resource binding manifest, created with an empty structure only when the file does not already exist.

Re-run uipath init whenever you change your Input or Output models. It regenerates entry-points.json and never modifies bindings.json — resource bindings are maintained by hand. For what they do and how to declare them, see Resource bindings.

Ejecutarlo localmente

uipath run main '{"message": "world"}'

Local runs resolve platform resources through the entries in bindings.json, so you can test against real Orchestrator assets and buckets before publishing. The same entries are what let each resource be remapped when the package runs in another tenant.

Próximos pasos

• Crear funciones de Python : esquemas tipados, gestión de errores y múltiples puntos de entrada.
• Resource bindings — declare the platform resources your function reaches.
• Empaquetar y publicar : implementar en Orchestrator.