Большинство разработчиков, впервые сталкивающихся с профессиональной разработкой в UiPath, наступают на те же грабли, что и я в начале своего пути: три двери и ни одной карты. Вы можете создать агента с помощью SDK uipath-python, используя Coded Agents через UiPath CLI или в Studio Web на cloud.uipath.com. Все три варианта являются первоклассными, но ничто не подскажет, какую дверь открыть первой или чем вы пожертвуете, сделав неправильный выбор. За этим процессом можно наблюдать прямо в деле.
Например, в ветке форума UiPath под названием "Путаница с SDK UiPath" один из разработчиков пишет: "Я не понимаю назначение SDK... Я не вижу способа опубликовать процесс неагентного типа с помощью SDK... Я думал, что Python SDK позволит мне создать скрипт/проект на Python, который фактически интегрируется с очередями, активами, заданиями...". И он прав — в файле README описано именно то, что он хочет сделать, а нужные примеры присутствуют в репозитории.
Тем не менее, между README и примерами в документации SDK нашелся один заметный путь для быстрого старта: ссылка на создание вашего первого агента на UiPath... и в этом руководстве по быстрому старту не оказалось того, что он искал. Это было наше упущение, которое мы исправили. Но эта проблема выходит за рамки конкретно этого SDK. Каждая страница продукта и каждый набор документации в отрасли объясняют, как создать вещь, и делают это хорошо. Но они редко объясняют, является ли это именно тем решением, которое вам следует создавать.
Я надеюсь, что эта карта поможет преодолеть этот разрыв при создании агентов для UiPath.
Краткая классификация точек входа для разработчиков агентов в UiPath:
- Python SDK, с самостоятельным хостингом: вы размещаете и запускаете агента самостоятельно, используя SDK для вызова сервисов UiPath из собственного кода. Выбирайте этот вариант, если UiPath выступает в роли зависимости, а не вашей среды выполнения.
Python SDK, с самостоятельным хостингом: вы размещаете и запускаете агента самостоятельно, используя SDK для вызова сервисов UiPath из собственного кода. Выбирайте этот вариант, если UiPath выступает в роли зависимости, а не вашей среды выполнения.
- С ориентацией на код, с хостингом от UiPath: вы пишете тот же код агента на Python, что и в первом варианте, но UiPath берет на себя его размещение, масштабирование, мониторинг и управление версиями. Выбирайте этот вариант, когда вы хотите запустить свой код в продакшн, не занимаясь операционной поддержкой.
С ориентацией на код, с хостингом от UiPath: вы пишете тот же код агента на Python, что и в первом варианте, но UiPath берет на себя его размещение, масштабирование, мониторинг и управление версиями. Выбирайте этот вариант, когда вы хотите запустить свой код в продакшн, не занимаясь операционной поддержкой.
- Studio Web, создание в браузере: вы создаете полноценную автономную автоматизацию с помощью холста конструктора агентов на cloud.uipath.com. Выбирайте этот вариант, когда работа должна выполняться совместно с людьми, которые не работают в IDE, или когда проект больше опирается на коннекторы платформы и инструменты, чем на ваш собственный код.
Studio Web, создание в браузере: вы создаете полноценную автономную автоматизацию с помощью холста конструктора агентов на cloud.uipath.com. Выбирайте этот вариант, когда работа должна выполняться совместно с людьми, которые не работают в среды разработки, или когда проект больше опирается на коннекторы платформы и инструменты, чем на ваш собственный код.
Первые два варианта представляют собой один и тот же путь «с упором на код»; это тот же Python, работающий с тем же SDK. Разница между ними заключается в том, кто размещает агента и управляет им (вы или UiPath). Studio Web — это путь «low-code». Держите эту схему в голове, когда будете переходить из этой статьи на страницы продуктов.
А теперь подробности.
Дверь 1: Прямое использование uipath-python SDK – агенты на Python под вашим управлением
uipath-python SDK — это базовый уровень для всего, что связано с Python в UiPath. Цитата из репозитория: "Python SDK, обеспечивающий программное взаимодействие с сервисами UiPath Cloud Platform... также включает интерфейс командной строки (CLI) для создания, упаковки и развертывания". С помощью SDK ваш код на Python может обращаться к сервисам платформы UiPath через API или через входящий в комплект интерфейс командной строки (CLI) uipath.
Обращайтесь к SDK UiPath, когда у вас есть код на Python или служба, которой необходимо взаимодействовать с сервисами UiPath Platform™ (например, очередями, активами, заданиями, коннекторами); то есть с тем, чем Orchestrator управлял годами, а теперь доступно для написания скриптов из вашего собственного кода. Вы не просите UiPath ничего размещать. Вы просите предоставить вам примитивы.
SDK перестает быть подходящим решением в тот момент, когда вы хотите, чтобы UiPath заставил эту систему работать. Он предоставляет примитивы, оставляя операционную работу вам. Если вы пишете агента и хотите, чтобы он работал в UiPath, вы открыли эту дверь на один шаг раньше.
Дверь 2: Coded Agents через CLI – размещаемые, масштабируемые и мониторируемые агенты из консоли
Coded agent (подход к созданию агентов с упором на код), согласно руководству по началу работы с UiPath, — это "агент на Python, развернутый на платформе". Одна команда CLI упаковывает ваш код, а платформа берет на себя его размещение, масштабирование, мониторинг и версионирование.
Несколько слов об интерфейсах командной строки (CLI) UiPath, так как их названия могут запутать. Python SDK поставляется с собственной командной строкой под названием uipath. Независимо от этого существует uip — CLI UiPath, выпущенный в этом году как UiPath для разработки агентов (Coding Agents): он охватывает большую часть платформы, а не только функции Python, и именно его используют пакеты навыков агентов кодирования. Используйте uip. Пока что держите установленными обе утилиты, поскольку uip codedagent перенаправляет практически каждую подкоманду на базовый uipath.
Цикл прост: uip login позволяет войти в систему, uip codedagent setup и uip codedagent init создают структуру проекта, а uip codedagent run agent проверяет агента локально. Когда вы будете готовы к выпуску, uip codedagent deploy упаковывает все компоненты, и UiPath берет управление на себя. В этом и заключается преимущество перед чистым Python SDK для вашего агента с самостоятельным хостингом: одна команда CLI uip codedagent deploy переносит его с вашего компьютера на хостинг в виде размещенного, масштабируемого, отслеживаемого агента с версионированием.
Стоит обратить внимание на это перенаправление. uip codedagent — это тонкая надстройка над собственным CLI SDK, что означает, что Дверь 2 не является отдельной технологией по сравнению с Дверью 1. Это тот же код, операционная поддержка которого передана компании UiPath. Переход между ними требует минимальных усилий, и это весомая практическая причина начать именно с SDK, если вы еще не до конца определились.
Еще одна важная особенность Coded Agents заключается в том, что поскольку SDK является базовым уровнем, среды выполнения для конкретных фреймворков устанавливаются поверх него. охватывает агентов LangChain и LangGraph, а растущий набор Интеграций среды выполнения агентов UiPath в монорепозитории uipath-integrations-python добавляет среды выполнения для LlamaIndex, Google ADK, OpenAI Agents, Microsoft Agent Framework и PydanticAI. Так что, если ваш агент уже создан на базе одного из этих фреймворков, эта логика продолжит работать при упаковке в Coded Agents.
Дверь 3: UiPath Studio Web – среда разработки в браузере для кросс-платформенных команд
Studio Web — это low-code холст UiPath в браузере на сайте cloud.uipath.com. Никакой установки и никакой настройки локального окружения. На странице продукта UiPath Studio названа "средой разработки на базе браузера для автоматизации на основе агентов и API. Лучше всего подходит для: ИИ-агентов, API-воркфлоу, моделирования процессов с участием агентов, приложений и кросс-платформенных команд". В обзоре документации Studio Web целевая аудитория описана намеренно широко: "бизнес-пользователи, гражданские разработчики, RPA-разработчики, IT-администраторы, администраторы Orchestrator".
Вы можете прочитать это и подумать, что Studio Web не для вас, если вы живете в VS Code. Однако существует два сценария, в которых Studio Web может оказаться именно тем местом, где вам захочется создать своего агента:
- Во-первых, когда вашей работой должен владеть тот, кто никогда не откроет терминал: владелец процесса или автоматизации, администратор Orchestrator, руководитель операционного отдела. В Studio Web вы можете создавать агентов аналогичного класса с полными возможностями агентов и способностью вызывать внешние API и инструменты, но на холсте, который вся команда может видеть и редактировать.
Во-вторых, когда вашей работой должен владеть тот, кто никогда не откроет терминал: владелец процесса или автоматизации, администратор Orchestrator, руководитель операционного отдела. В Studio Web вы можете создавать агентов аналогичного класса с полными возможностями агентов и способностью вызывать внешние API и инструменты, но на холсте, который вся команда может видеть и редактировать.
- Во-вторых, когда агент больше опирается на платформу, чем на ваш собственный код. Коннекторы Integration Service, рабочие процессы API, потоки UiPath Maestro™ (наш уровень оркестрации долгосрочных процессов) и другие возможности UiPath, представленные в виде инструментов агента, являются объектами первого класса в Studio Web. В кодовом агенте каждый из них — это вызов API, который вы пишете и поддерживаете самостоятельно.
Во-вторых, когда агент больше опирается на платформу, чем на ваш собственный код. Коннекторы Integration Service, рабочие процессы API, потоки UiPath Maestro™ (наш уровень оркестрации долгосрочных процессов) и другие возможности UiPath, представленные в виде инструментов агента, являются объектами первого класса в Studio Web. В кодовом агенте каждый из них — это вызов API, который вы пишете и поддерживаете самостоятельно.
Если вы профессиональный разработчик-одиночка, который никогда не сотрудничает вне своей среды разработки (IDE), вы, вероятно, сначала обратитесь к кодовым агентам и перейдете в Studio Web только тогда, когда организация догонит то, что вы создали.
Python SDK
Кодовые агенты
Studio Web
Кто размещает
Вы
UiPath
UiPath
Чем вы управляете
Все
Ничего
Ничего
Где вы создаете
Ваша IDE
Ваша IDE
Холст браузера
Могут ли неразработчики владеть этим совместно
Да
Лучше всего, когда работа состоит в
В основном ваш код, UiPath как зависимость
В основном ваш код, UiPath как среда выполнения
В основном возможности UiPath
Используйте собственный фреймворк
Да
Да: LangGraph, LangChain, LlamaIndex, Google ADK, OpenAI Agents, Microsoft Agent Framework, PydanticAI
Коннекторы, рабочие процессы API, потоки Maestro
Вы вызываете API
Вы вызываете API
Объекты первого класса
Что вы устанавливаете
pip install uipath
UiPath CLI (uip)
Ничего
Решение, которое вы на самом деле принимаете
Три вопроса в следующем порядке.
- Нужен ли мне UiPath для размещения моего агента? Если нет: выберите прямой путь через SDK. Вы сохраняете среду выполнения и обращаетесь к UiPath за такими сервисами, как очереди, ресурсы, задания и коннекторы. Если да, продолжайте.
Нужен ли мне UiPath для размещения моего агента? Если нет: выберите прямой путь через SDK. Вы сохраняете среду выполнения и обращаетесь к UiPath за такими сервисами, как очереди, ресурсы, задания и коннекторы. Если да, продолжайте.
- Работают ли все владельцы этой задачи в IDE? Если нет, то Studio Web — это то, что нужно. Холст, который может открыть вся команда, лучше репозитория, который можете запустить только вы.
Работают ли все владельцы этой задачи в IDE? Если нет, то Studio Web — это то, что нужно. Холст, который может открыть вся команда, лучше репозитория, который можете запустить только вы.
- Это в основном мой код или возможности UiPath? Если это в основном ваш код, включая все, что уже работает на LangGraph или другом фреймворке: выбирайте кодовые агенты, развертываемые одной командой. Если вы используете значительный объем возможностей UiPath, таких как коннекторы Integration Service, рабочие процессы API, потоки Maestro и другие инструменты агента, выберите Studio Web, даже если вы разработчик, пишущий весь код самостоятельно.
Это в основном мой код или возможности UiPath? Если это в основном ваш код, включая все, что уже работает на LangGraph или другом фреймворке: выбирайте кодовые агенты, развертываемые одной командой. Если вы используете значительный объем возможностей UiPath, таких как коннекторы Integration Service, рабочие процессы API, потоки Maestro и другие инструменты агента, выберите Studio Web, даже если вы разработчик, пишущий весь код самостоятельно.
Это и есть сортировка. Если она не дает однозначного ответа, определяющим фактором обычно является организационный, а не технический, и об этом стоит сказать вслух, а не пересматривать выбор инструментов.
Сравнение с OpenAI Agents SDK, LangGraph, Google ADK и Claude Agent SDK
Каждая серьезная платформа для создания агентов в 2026 году делает одно и то же: отделяет SDK от размещенных в облаке и визуальных слоев. В марте 2025 года компания OpenAI выпустила Agents SDK в качестве производственной версии Swarm: небольшого и намеренно минималистичного набора примитивов (Агенты, Передачи управления, Защитные барьеры при запуске) с независимостью от провайдеров благодаря официальному расширению LiteLLM, которое открывает доступ более чем к 100 поддерживаемым LiteLLM провайдерам. Agent Development Kit от Google представляет собой с открытым исходным кодом инструментарий для разработчиков, доступный для Python, TypeScript, Go, Java и Kotlin. LangGraph объединяет свою библиотеку графов с открытым исходным кодом со слоем развертывания в облаке и визуальной студией, первоначально выпущенными как LangGraph Platform и LangGraph Studio, которые в конце 2025 года были переименованы в LangSmith Deployment и LangSmith Studio.
Claude Code от Anthropic — это, по их словам, «инструмент для разработки с помощью агентов, который работает в вашем терминале», а Claude Agent SDK предоставляет базовые инструменты и среду выполнения Claude Code для разработчиков, создающих на их основе собственных агентов.
Стратегия UiPath дополняет этот паттерн, а не противостоит ему. Приносите тот фреймворк, который вам нравится. UiPath предоставляет возможности — оркестрацию, этапы с участием человека (human-in-the-loop), корпоративные коннекторы и уровень управления, — которые работают с любым созданным вами агентом, предоставляя те части, которые сложнее всего воспроизвести с нуля надежным и соответствующим требованиям образом.
На мастер-классе, который я проводил на конференции WeAreDevelopers, я описал сложный корпоративный процесс состоящим из четырех фаз: прием и сортировка, исследование и анализ, ввод данных, разрешение и закрытие. Суть в том, что в большинстве стеков агентов по умолчанию нет дирижера. Ничто не знает, на каком этапе находится тот или иной кейс в любой момент времени. Выполнение делает работу; оркестрация обеспечивает достижение результата. Это тот слой, который UiPath добавляет поверх любого выбранного вами агентского фреймворка. И этот слой также обеспечивает возможности RPA для устаревших систем и систем без API, UiPath IXP (Intelligent Xtraction & Processing) для работы с большим количеством документов, Maestro для сквозной оркестрации, Action Center для взаимодействия с человеком (human-in-the-loop) и уровень доверия к ИИ (AI Trust Layer), который независимо сертифицирован по стандартам ISO 42001 и AIUC-1.
С чего начать создание агентов на UiPath
Если вы пройдете через одну из этих дверей, и она не приведет туда, куда написано в этой статье, сообщите мне. Ветка форума в верхней части — это отчет об ошибке в нашей документации. Эта карта — первый патч.
Часто задаваемые вопросы
Пакет uipath-python SDK создан именно для этого: очереди, активы, задания, бакеты, процессы и подключения — все это доступно прямо из вашего собственного кода на Python. Вы не создаете агента, и вам это не нужно. Если вы хотите, чтобы UiPath запускал этот скрипт, а не просто выступал в роли чего-то, что вызывается вашим скриптом, вам нужна кодируемая функция, а не кодируемый агент. UiPath определяет кодируемую функцию как «код на Python с типизированными входными и выходными данными, который выполняется как задание Orchestrator», «позволяя агенту запускать пользовательский код на Python в качестве детерминированного инструмента на основе процессов наряду с автоматизацией и рабочими процессами API». Он использует тот же SDK, тот же CLI и обходится без LLM. Чтобы начать работу с кодируемыми функциями, ознакомьтесь с документацией по началу работы с функциями Python.
Один суффикс, но две совершенно разные вещи. Агент для написания кода — это инструмент вроде Claude Code, Cursor или Codex, который пишет код в вашей IDE. Кодируемый агент — это подход к созданию агентов «код прежде всего», то есть агент на Python, который вы развертываете в UiPath, и имя CLI прямо указывает на это в вводимой вами команде: uip codedagent.
Вы можете использовать первое для создания второго, для чего и предназначен UiPath for Coding Agents. Именно поэтому эти два названия постоянно путают. В рамках этой статьи кодируемый агент означает то, что вы развертываете.
Нет. uipath — это CLI, поставляемый внутри Python SDK и устанавливаемый с помощью pip install uipath, а uip — это CLI UiPath, устанавливаемый отдельно и обеспечивающий доступ к большей части платформы, а не только к интерфейсу Python.
Используйте uip. Если вы создаете кодируемые агенты, пока держите оба на своем компьютере — uip codedagent перенаправляет практически каждую подкоманду на uipath «под капотом».
Да. uipath-langchain-python охватывает LangChain и LangGraph. Монорепозиторий uipath-integrations-python добавляет среды выполнения для LlamaIndex, Google ADK, OpenAI Agents, Microsoft Agent Framework и PydanticAI.
Логика вашего графа продолжает работать в прежнем виде. Меняется лишь обертка: UiPath берет на себя хостинг, масштабирование, мониторинг и версионирование, а ваш агент получает доступ к службам платформы UiPath, которых у него не было раньше.
Переход между агентами, ориентированными на код (автономными или работающими на UiPath), прост. Это тот же Python с тем же SDK, поэтому внедрение кодируемых агентов в основном сводится к добавлению uip CLI и публикации агента в UiPath для хостинга.
Переход от агента на базе кода к Low-code агенту сложнее: кодируемый агент — это проект на Python, выполняющий код на Python; Low-code агент — это артефакт холста Studio Web. Переход от кодируемого агента к Low-code агенту часто означает пересоздание, а не импорт. Это единственная граница в данной статье, не имеющая простого решения, и об этом лучше знать до того, как вы сделаете выбор, а не после.
И хотя вы можете добавить кодируемый агент в решение Studio Web, создав проект «кодируемый агент» и добавив этот ID проекта в файл .env, агент остается проектом кодируемого агента, и код потребуется поддерживать в вашей локальной среде разработчика (вне Studio Web).
Вероятно, нет. Если все владельцы работы трудятся в IDE, а агент в основном представляет собой написанный вами код, кодируемые агенты UiPath предоставляют вам ту же среду выполнения через привычный рабочий процесс. Ответ меняется в двух случаях. В тот момент, когда совместным владельцем работы должен стать человек, который не станет открывать терминал, или если агент сильнее опирается на коннекторы, рабочие процессы API и потоки Maestro, чем на ваш собственный код, Studio Web перестает быть худшим выбором и становится практичным.
