UiPathのPython SDKで作成されたプロセスの実行エラー

こんにちは、仲間の自動化ツールさん、情報が見つからない興味深い問題があります。現在、従来のアクティビティとPythonアクティビティの組み合わせを使用して、主にスクリプトを実行する自動化があります。このプロセス全体をPythonで行うのが理にかなうため、UiPathのPython SDKを使用してプロセスを作成し、Orchestratorを通じて通常のプロセスとして呼び出せるようにすることを検討しています。

(古いか不完全な)UiPath Python SDKのドキュメントを参考にし、ソースコードを掘り下げた結果、単に入力されたものを文字列結合で返す非常にシンプルなプロセスを公開することができました。

uipath run main <INPUT>を使用してローカルで実行でき、Orchestratorに公開しましたが、Orchestratorからプロセスを呼び出すことができません。個人のワークスペースフォルダーと別の共有フォルダーの両方に展開しましたが、実行しようとすると次のエラーが表示されます:Serverless.Api.CreditsExceeded - 自動化を実行するためのエージェントユニットが不足しています。管理者に連絡してください。

これはもちろん意味をなさない、プロセスはコーディングされたエージェントではなく、エージェントユニットを必要としないはずです。興味深いことに、共有フォルダーに公開して実行しようとしたとき、別のエラーが出ました:Cloud - サーバーレスランタイムライセンスが選択されています。このフォルダーのテンプレートには、Cloud - サーバーレスランタイムが構成されていません。(#2818) このエラーは実際には意味があり、フォルダーに[Default] Cloud Robots - Serverlessマシンを追加しましたが、エラーは前述のServerless.Api.CreditsExceeded - 自動化を実行するためのエージェントユニットが不足しています。管理者に連絡してください。に戻ってしまいました。

UiPathから誰かが意見を述べることを望んでいます。これはバグの可能性がありますか?Python SDKを使用してプロセスを作成するのはニッチなため、誰もこれに遭遇していないと思います。

私は、Python SDKを本来の使い方で使用しているのかどうかについて、とても混乱しています。Python SDKのリポジトリには、たとえば [pizza-order-function](uipath-python/packages/uipath/samples/pizza-order-function at main · UiPath/uipath-python · GitHub) のようなサンプルがあります。

UiPath.jsonファイルには次のようにあります。

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

これは、私の理解では、関数とエージェントの違いを考えると、オーケストレーターなどから呼び出すことができる通常のプロセスであるべきだと考えています。しかし、README.mdには明示的に「ピザの注文を価格設定し、確認するコーディングされたエージェントです…」と書かれています。

main.pyを見てみると、プロセスがコーディングされたエージェントであることを示すものは何もありません。LLMの呼び出しもなければ、プロンプトもありません。単に入力を受け付けて決定論的な出力を返します。私は、関数がコーディングされたエージェントが呼び出すためのツールであるべきだということを誤解しているのでしょうか?

私のユースケースを再度強調すると、私はデータベースからたくさんのデータをダウンロードし、その後にPythonスクリプトを呼び出すハイブリッドなプロセスを持っています。このスクリプトは、前のアクティビティがプロジェクトディレクトリの特定の場所にファイルをダウンロードしたことを前提としていますので、非常に複雑になります。すべてを1つのPythonスクリプトで実行することもできますが、問題は多くの変動性があり、エラーや問題が発生した場合にオーケストレーターに示すことが難しい、または不可能です。したがって、Python SDKを使用してプロセスを作成すれば、その問題を完全に解消できるのですが、ただ呼び出すことができれば!

洞察を持っている方がいれば、特にUiPath Python SDKの開発に関与している方からの情報があれば、大変感謝します :slight_smile:

よろしく、

エウウェン

こんにちは @hivesew

最近、クライアントプレゼンテーションのためにまさにこの同じ問題に直面しました(笑)。

結局、コーディングされたエージェントを実行するためにエージェンティックユニットを使わざるを得ませんでした。でも、私はUiPathのSDKを使ってコーディングされたエージェントを作りたかったのです。

いくつかの調査を行った結果、UiPath Python SDKを使用すると、自動的にコーディングされたエージェントを作成することを前提としているため、そのようにデプロイされることがわかりました。だから、あなたがエラーを受け取っているのはこのためだと思います。そして、これはバグではなく、実際にそのように実行されることを期待しているのです。

完全にエージェンティックユニットを使わないようにしたい場合は、以下を試すことをお勧めします:(これは以前試したことがないので、一緒に見てみましょう)

UiPath プロセス → Invoke Python → ややこしいファイル依存関係のルートを行くのではなく、重要な作業を処理する関数(Main()関数)をPythonコードから公開して、通常通りにデプロイしますが、オーケストレーターAPIを使用して呼び出してみてください(これはUiPath Swagger UIの中で見つけることができます)。

これがあなたの問題を解決するかもしれません。

どうなったか教えてください :slight_smile:

これについてUiPathに確認してほしいです。私にはあまり意味がありません。私が望んでいるのは、オーケストレーターから呼び出せるコーディングされたPythonプロセスを作成できることです。それによって、ログやトレーシングの利点を得られると思っていますが、それにエージェントユニットが必要になるのはなぜか不明です。

現在のプロセスは、キュートリガーを介して呼び出され、プロジェクト内に保存されたPythonスクリプトを使用し、Pythonアクティビティを用いて呼び出されるメイン関数を含んでいますが、使うのが面倒です。実際に私が知りたいのは、Python SDKがコーディングされたエージェント専用か、または入門ガイドで宣伝されているように、コーディングされたプロセスにも使えるのかどうかです。

@Alexandru_Bizonをここにタグ付けさせてください。彼が返信方法を最もよく知っており、私が間違っていた場合は訂正してくれるでしょう。

私の理解では、私たちはPython SDKと必要なプラットフォームの依存関係を拡張して、あなたのユースケースをカバーする作業を進めています。

こんにちは @hivesew - 詳細な書き込みありがとうございます。そして、@JarrydScott も参加してくれてありがとう。

混乱を解消するために簡単にフレーミングしますと、UiPath Python SDKはGAですが、特にコーディングされたエージェントを構築するためのものです。だから、今日あなたがそれを通じて公開するすべてはエージェントとしてルーティングされます。あなたの「単純な文字列を返すプロセス」も含めてです。今のプラットフォームの観点から見ると、SDKに関連するものはすべてエージェントとして扱われるため、Serverless.Api.CreditsExceeded - Not enough Agentic Unitsというエラーが発生しています。Jarrydのこの見解は正しいです。

実際にあなたが求めているのはUiPath Functionsです — これは既存のPython SDKインフラストラクチャの上に構築している新しい製品です。Functionsは同じSDK、パッケージング、あなたがすでに使用しているuipath CLIを拡張しますので、それが登場するとあなたの作業はそのまま引き継がれます。ただプロジェクトのタイプとルーティングが異なるだけです。

UiPath Functionsの特徴

コーディングされた自動化を適切なOrchestratorプロセスとして公開および呼び出すための一級の方法です: まずはPythonから始まり、JavaScript / TypeScriptがロードマップにあります。Functionsは標準のロボット実行環境で動作し、独自の価格モデル(まだ最終決定されていません)があります。あなたの正確なシナリオ、ほとんどのロジックがPythonで、単にクリーンなOrchestrator呼び出しを望んでいるというのは、デザインを推進する主要なユースケースの一つです。

現在の状況

  • Python SDK: GAで、コーディングされたエージェント用です。
  • Python用のUiPath Functions(SDKの上に構築される): WIP、数週間以内に公開プレビュー予定。それまでは、SDKを通じて公開されたものはエージェントランタイムを介してルーティングされ、Agentic Unitsを消費します。
  • JS/TS用のUiPath Functions: WIP - 本当に新しいユースケースを解放する専用のSDKが来ています。ティーザー: 100ms未満の応答時間をターゲットにしています。
  • pizza-order-function のREADMEがそれをコーディングされたエージェントとして誤ってラベル付けしているのはドキュメントのバグで、UiPath.jsonの"functions"ブロックが正しい信号です。修正します。

私の推奨

率直に言うと、今はクリーンな回避策はありません。それがまさにUiPath Functionsが閉じるために構築されているギャップであり、コードをUiPathプラットフォームの一級市民として持ち込むのです。

最良の道は公開プレビューを待つことです。 それが実際にあなたが求めているものを提供します: クリーンなPythonコード、ネイティブのOrchestrator呼び出し、Agentic Unitsの消費なし。あなたの現在のハイブリッド設定をもう少しの間保持しておいてください; 移行は簡単であるべきですので、すでにSDKの探索作業を行っているからです。

公開プレビューが登場したら、ここに戻って投稿します。これを完成させるまでの間、お待ちいただきありがとうございます。

アレックス・ビゾン

@hivesew @JarrydScott コミュニティの皆さんに向けて、Python関数が使用可能になりました!

:snake: Python関数が現在パブリックプレビュー中です - ニュース / プロダクトニュース - UiPathコミュニティフォーラム

ああ!これを待っていました、ありがとうございます @Alexandru_Bizon!企業向け組織がまだパブリックプレビュー中にアクセスを得る方法はありますか?さもなければ、これが企業向けに正式にリリースされるのを待ちきれません。混沌としたスタジオデスクトップRPAプロセスをPythonを実行するものからこれに変換したいです。 :slight_smile:

私は1週間ほどで企業の全員にそれを有効にする予定です。