Большинство разработчиков, приходящих в UiPath, сталкиваются с той же стеной, что и я, когда начинал изучать возможности для профессиональной разработки: три двери и никакой карты. Вы можете создать агента с помощью Python SDK от UiPath, с помощью 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, self-hosted: вы размещаете и запускаете агента самостоятельно и используете SDK для вызова сервисов UiPath из своего кода. Выбирайте этот вариант, когда UiPath является зависимостью, а не средой выполнения.
Python SDK, self-hosted: вы размещаете и запускаете агента самостоятельно и используете SDK для вызова сервисов UiPath из своего кода. Выбирайте этот вариант, когда UiPath является зависимостью, а не средой выполнения.
- Code-first, UiPath-hosted: вы пишете тот же код агента на Python, что и в первом варианте, но UiPath размещает, масштабирует, отслеживает и версионирует его. Выбирайте этот вариант, если хотите, чтобы ваш код работал в продакшене, не занимаясь при этом эксплуатацией инфраструктуры.
Code-first, UiPath-hosted: вы пишете тот же код агента на Python, что и в первом варианте, но UiPath размещает, масштабирует, отслеживает и версионирует его. Выбирайте этот вариант, если хотите, чтобы ваш код работал в продакшене, не занимаясь при этом эксплуатацией инфраструктуры.
- Studio Web, browser-built: вы создаете полноценную агентную автоматизацию, используя холст конструктора агентов на cloud.uipath.com. Выбирайте этот вариант, когда работу нужно делить с людьми, которые не работают в IDE, или когда решение больше опирается на платформенные коннекторы и инструменты, чем на ваш собственный код.
Studio Web, browser-built: вы создаете полноценную агентную автоматизацию, используя холст конструктора агентов на cloud.uipath.com. Выбирайте этот вариант, когда работу нужно делить с людьми, которые не работают в IDE, или когда решение больше опирается на платформенные коннекторы и инструменты, чем на ваш собственный код.
Первые два варианта — это один и тот же путь «code-first»; это тот же самый 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.
Обращайтесь к UiPath SDK, когда у вас есть Python-код или сервис, которому нужно взаимодействовать с сервисами UiPath Platform™ (например, очередями, активами, заданиями, коннекторами); тем, чем Orchestrator управляет годами, а теперь это можно автоматизировать с помощью вашего собственного кода. Вы не просите UiPath что-либо размещать. Вы просите предоставить вам примитивы.
SDK перестает быть подходящим вариантом в тот момент, когда вы хотите, чтобы UiPath сам запускал этот процесс. Он дает вам примитивы и оставляет эксплуатацию на ваше усмотрение. Если вы пишете агента и хотите, чтобы он работал на UiPath, вы открыли эту дверь слишком рано.
Дверь 2: coded agents через CLI — размещаемые, масштабируемые и отслеживаемые агенты из CLI
Coded agent (подход «code-first» к созданию агентов), согласно руководству UiPath Getting Started, — это «Python-агент, развернутый на платформе». Одна команда CLI упаковывает ваш код, а платформа берет на себя хостинг, масштабирование, мониторинг и версионирование.
Заметка о CLI UiPath, потому что названия могут сбить с толку. Python SDK поставляется со своим собственным CLI под названием uipath. Отдельно существует uip, CLI для UiPath, выпущенный в этом году как UiPath for Coding Agents: он охватывает большую часть платформы, а не только поверхность Python, и именно его используют пакеты навыков coding-agent. Используйте uip. Пока что держите установленными оба, так как uip codedagent перенаправляет почти каждую подкоманду в uipath.
Цикл короткий: uip login позволяет войти в систему, uip codedagent setup и uip codedagent init создают каркас проекта, uip codedagent run agent тестирует агента локально. Когда вы будете готовы к выпуску, uip codedagent deploy упакует его, и UiPath возьмет всё на себя. Это и есть преимущество перед «голым» Python SDK для вашего self-hosted агента: одна команда CLI uip codedagent deploy отправляет его с вашего компьютера в виде размещенного, масштабируемого, отслеживаемого и версионируемого агента.
Это перенаправление стоит заметить. uip codedagent — это тонкий слой поверх собственного CLI SDK, что означает, что Дверь 2 — это не другая технология, отличная от Двери 1. Это тот же самый код, где эксплуатационная часть передана UiPath. Переход между ними стоит очень дешево, и это самая веская практическая причина начать с SDK, если вы еще не уверены в выборе.
Другая важная особенность coded agents: поскольку SDK является базовым уровнем, среды выполнения, специфичные для фреймворков, подключаются поверх него. uipath-langchain-python поддерживает агентов LangChain и LangGraph, а растущий набор интеграций среды выполнения агентов UiPath в монорепозитории uipath-integrations-python добавляет среды выполнения для LlamaIndex, Google ADK, OpenAI Agents, Microsoft Agent Framework и PydanticAI. Так что, если ваш агент уже построен на одном из них, эта логика продолжит работать, когда Coded Agents упакует его.
Дверь 3: UiPath Studio Web — браузерная IDE для кросс-платформенных команд
Studio Web — это браузерный low-code холст UiPath на cloud.uipath.com. Никакой установки, никакой локальной среды. Страница продукта UiPath для Studio называет Studio Web «браузерной IDE для агентной и API-ориентированной автоматизации. Лучше всего подходит для: AI-агентов, 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 от хостинговых и визуальных уровней. OpenAI выпустила Agents SDK в марте 2025 года как производственную версию 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 предоставляет возможности — оркестрацию, этапы с участием человека, корпоративные коннекторы и уровень управления — которые работают с любым созданным вами агентом, предоставляя компоненты, которые сложнее всего воспроизвести с нуля надежным и соответствующим требованиям образом.
На семинаре, который я проводил на конференции WeAreDevelopers, я представил сложный корпоративный процесс как состоящий из четырех этапов — прием и сортировка, исследование и анализ, ввод данных, разрешение и закрытие — и суть в том, что в большинстве агентских стеков по умолчанию нет дирижера. Ничего, что знало бы, в каком состоянии находится кейс в любой момент времени. Исполнение делает работу; оркестрация гарантирует результат. Это тот уровень, который UiPath добавляет поверх любого агентского фреймворка, который вы принесли. И этот уровень также обеспечивает доступ RPA к устаревшим системам и системам без API, UiPath IXP (Intelligent Xtraction & Processing) для работы с документами, Maestro для сквозной оркестрации, Action Center для участия человека и AI Trust Layer, который был независимо сертифицирован по стандартам ISO 42001 и AIUC-1.
С чего начать создание агентов в UiPath
Если вы прошли через одну из этих дверей, и она не привела туда, где сказано в этой статье, сообщите мне. Та ветка форума вверху — это отчет об ошибке в нашей документации. Эта карта — первый патч.
Часто задаваемые вопросы
SDK uipath-python создан именно для этого: очереди, активы, задания, хранилища, процессы и подключения — все это доступно из вашего собственного кода на Python. Вы не создаете агента, и вам это не нужно. Если вы хотите, чтобы UiPath запускал этот скрипт, а не просто был чем-то, что вызывает ваш скрипт, вам нужна кодируемая функция (coded function), а не кодируемый агент (coded agent). UiPath определяет кодируемую функцию как «код на Python с типизированными входными и выходными данными, который выполняется как задание Orchestrator», «позволяя агенту запускать пользовательский код на Python в качестве детерминированного инструмента на основе процессов вместе с автоматизациями и рабочими процессами API». Он использует тот же SDK, тот же CLI, никакой LLM. Чтобы начать работу с кодируемыми функциями, ознакомьтесь с документацией «Начало работы с функциями Python».
Один суффикс, но две совершенно разные вещи. Кодирующий агент (coding agent) — это инструмент, такой как Claude Code, Cursor или Codex, который пишет код в вашей IDE. Кодируемый агент (coded agent) — это подход к созданию агентов, ориентированный на код: агент на Python, который вы развертываете в UiPath, и CLI называет его напрямую в команде, которую вы вводите: uip codedagent.
Вы можете использовать первое для создания второго, именно для этого и предназначен UiPath for Coding Agents. Именно поэтому эти два названия постоянно пересекаются. На протяжении этой статьи под «кодируемым агентом» понимается то, что вы развертываете.
Нет. uipath — это CLI, который поставляется внутри SDK Python и устанавливается с помощью 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, поэтому внедрение кодируемых агентов — это в основном вопрос добавления CLI uip и публикации его в UiPath для хостинга.
Переход от агента, ориентированного на код, к low-code агенту сложнее: кодируемый агент — это проект на Python, выполняющий код на Python; low-code агент — это артефакт холста Studio Web. Переход от кодируемого агента к low-code агенту часто означает перестройку, а не импорт. Это единственная граница в этой статье, не имеющая дешевого пути, и об этом стоит знать до того, как вы сделаете выбор, а не после.
И хотя вы можете добавить кодируемого агента в решение Studio Web, создав проект «coded agent» и добавив этот ID проекта в ваш .env, агент остается проектом кодируемого агента, и код нужно будет поддерживать в вашей локальной среде разработчика (вне Studio Web).
Вероятно, нет. Если все, кто владеет работой, живут в IDE, а агент — это в основном написанный вами код, кодируемые агенты UiPath предоставляют вам ту же среду выполнения через рабочий процесс, который вы уже знаете. Ответ меняют две вещи. В тот момент, когда кто-то, кто не будет открывать терминал, должен стать соавтором работы, или когда агент больше полагается на коннекторы, рабочие процессы API и потоки Maestro, чем на ваш собственный код, Studio Web перестает быть менее предпочтительным выбором и становится практичным.
