uipath-agents

UiPath エージェント

厳守事項

• 「UiPath エージェントを構築／作成／スキャフォールド／実装する」という依頼は、デフォルトで One-Prompt Flow 全体を意味します。ユーザーがそこで停止するよう明示しない限り、ファイルの作成やローカル実行だけで終わらせないでください。

• 通常の完了時点は、スモーク評価と必須の Delivery 分岐質問を終えた後です。実行／評価がブロックされている場合、またはユーザーがオプトアウトした場合を除き、それより前に最終的なビルドの概要を提示するのは時期尚早です。

• 最初のスキャフォールドまたはデプロイの前に、セッションごとに一度 solution 動詞を確認してください。 uip solution init --help --output json を実行します。結果が Success → solution init と solution deploy run --parent-folder-path／--parent-folder-key（名称変更後、デフォルト）を使用します。unknown command／終了コードが 0 以外 → CLI が名称変更より前のバージョンです。このスキルで指定されている箇所では、同じ引数を使い、uip solution new <Name> と --folder-path／--folder-key に置き換えてください。

• グリーンフィールドのコードエージェント — uip codedagent new でスキャフォールドし、プロジェクトを手作業で作成しないでください。 新しいコードエージェントをゼロから構築する場合は、まず有効な venv にフレームワークパッケージをインストールし、次に必ず uip codedagent new <name> でプロジェクトを作成し、uip codedagent init でスキーマを生成してください。単純なエージェントであっても、pyproject.toml／main.py／langgraph.json／entry-points.json を手作業で作成しないでください。手作業での作成では必要なプロジェクト構成が省かれ、無効なパッケージが生成されます。インストールされたフレームワークパッケージによってスキャフォールドが選択されます。new の後、<framework>.json が存在することを確認してください。復旧手順は coded/lifecycle/setup.md § スキャフォールドの確認を参照してください。（既存のプロジェクトまたは Studio Web のローカルワークスペースプロジェクトでは、uip codedagent new を実行しないでください。coded/quickstart.md のプロジェクト状態に応じた手順に従ってください。）

• コードエージェントのみ — バインディングは必ず UiPath Python SDK の呼び出しから導出し、手作業で作成してはなりません。 導出するには、coded/lifecycle/bindings-reference.md の同期ワークフローを必ず実行してください。コードをスキャンし、bindings.json を再生成します。これを行わないと、実行環境ごとにリソースをオーバーライドできず、SDK 呼び出しにハードコードされた値が常にデフォルトで使われます。assets、queues、processes、buckets、indexes、connections、apps、MCP servers、または InvokeProcess|CreateTask|CreateEscalation(...) など、UiPath SDK のリソース呼び出しを追加、削除、変更するたびにバインディングを導出してください。

プロジェクトタイプの判定

先に進む前に、エージェントのモードを判定します。

1. まず、Coded Function ではなくエージェントであることを確認します。 uipath.json に functions マップが宣言されている場合、たとえば Python のエントリーポイント（"functions": {"main": "main.py:main"} と同じ階層の pyproject.toml）や、JS/TS のエントリーポイント（"functions": {"invoice": "functions/invoice.ts:default"} と同じ階層の package.json）がある場合、そのプロジェクトはエージェントではなく Coded Function です。ここで処理を停止し、代わりに uipath-functions スキルを使用します。Functions は決定論的で、LLM による推論は行わず、ライフサイクルも異なります（uip function new/pack/publish/run。init は Python のみです）。
2. 作業ディレクトリ内に既存のエージェントプロジェクトファイルがあるか確認します。
   • pyproject.toml、.py ファイル、フレームワーク依存関係（uipath-langchain、uipath-llamaindex、uipath-openai-agents のいずれか）→ コードベース。フレームワークパッケージですでに uipath が依存関係として宣言されているため、uipath を明示的に追加する必要はありません。
   • "type": "lowCode" を含む agent.json と project.uiproj があり、pyproject.toml がない → ローコード
3. 既存のプロジェクトが見つからない場合 → ユーザーに尋ねます。

   ローコードエージェント（Python 不要。プロンプトと構築済みの UiPath ツールで設定）と、コードベースのエージェント（Python を使用。LangGraph、LlamaIndex、または OpenAI Agents による完全なプログラム制御）のどちらを構築しますか？ ただし、会話型のユースケースでは、ユーザーに尋ねずにローコードを選択し、現在、本番環境のユースケースではローコードの会話型エージェントが強く推奨されていることを説明してください（references/coded/capabilities/conversational-agents.md を参照）。

4. 判断に迷っているユーザーには、機能を比較するために references/coded-vs-lowcode-guide.md を読みます。

判定後、ほかのことをする前に、そのモードのクイックスタートを読みます。

• コードベース → references/coded/quickstart.md を読みます。クイックスタートの最初のステップでプロジェクトの状態（greenfield／existing-coded／local-workspace）を判定し、状態に応じて各ライフサイクルステップの実行可否を判断します。Studio Web Local Workspace の詳細については、references/coded/lifecycle/local-workspace.md を参照してください。
• ローコード → references/lowcode/lowcode.md を読みます。

タスクのナビゲーション

必要な作業	モード	最初に読むもの	次に読むもの
コードベースかローコードかをユーザーが選ぶのを支援する	両方	coded-vs-lowcode-guide.md
認証する	両方	authentication.md
Studio Web のローカルワークスペースソリューション内でコードベースのエージェントを反復開発する	コードベース	coded/quickstart.md（状態検出で project_state = local-workspace が設定されます）	SW が所有するファイルとアンチパターンについては coded/lifecycle/local-workspace.md、coded/lifecycle/running-agents.md、coded/lifecycle/evaluate.md
コードベースのエージェントを作成／ビルド／デプロイする	コードベース	coded/quickstart.md	coded/lifecycle/*、coded/frameworks/*
コードベースのフレームワークを選択する	コードベース	coded/quickstart.md § フレームワークの選択
コードベースの機能（HITL、RAG、トレース）を追加する	コードベース	coded/quickstart.md	coded/capabilities/*
コードベースのエージェントから Data Fabric エンティティを照会または書き込む（SDK の直接利用または NL-to-SQL ツール）	コードベース	coded/capabilities/datafabric.md	coded/capabilities/sdk-services.md § エンティティ
コードベースのエージェントの環境変数を設定する、またはそこから Orchestrator アセット（%ASSETS/<ASSET_NAME>%）を参照する	コードベース	coded/lifecycle/environment-variables.md	.env が引き継ぐものと引き継がないものについては coded/lifecycle/file-sync.md
コードベースのエージェントから Integration Service コネクタ（Slack、Jira、Web Search）を呼び出す	コードベース	coded/capabilities/integration-service.md を読んだ直後に uipath-platform/references/integration-service/agent-workflow.md を読む — 検出方法は uipath-agents ではなく、こちらに記載されています	coded/capabilities/sdk-services.md § 接続
コードベースの評価を実行する	コードベース	coded/quickstart.md § 評価	coded/lifecycle/evaluate.md
新しいローコードエージェントプロジェクトを作成またはひな形から生成する	ローコード	lowcode/lowcode.md § クイックスタート	lowcode/project-lifecycle.md、lowcode/agent-definition.md
agent.json（プロンプト、モデル、スキーマ、contentTokens、entry-points.json）を編集する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/agent-definition.md
ローコードのツール（Orchestrator プロセス — RPA／エージェント／API／agentic — または Integration Service）を追加する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/capabilities/process/*、lowcode/capabilities/integration-service/*
ローコードエージェントに MCP（Model Context Protocol）サーバーツールを追加する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/capabilities/mcp/mcp.md
ファイルをエージェントの入力として受け入れる／組み込みの Analyze Files ツールを呼び出す	ローコード	lowcode/capabilities/built-in-tools/built-in-tools.md	lowcode/capabilities/built-in-tools/analyze-attachments.md、lowcode/agent-definition.md § ファイル添付
ファイル添付（入力、出力、または実行中に作成されるファイル）を扱う	コードベース	coded/capabilities/file-attachments.md
会話型（チャット形式）エージェントを構築する	ローコード	lowcode/lowcode.md	lowcode/project-lifecycle.md、lowcode/agent-definition.md
ローコードのコンテキスト（Context Grounding RAG／添付ファイル／DataFabric エンティティセット）を追加する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/capabilities/context/*
ローコードのメモリースペースを追加する、またはメモリー項目をシードする	ローコード	lowcode/capabilities/memory/memory.md	uip agent memory を使用し、その後更新／検証する
ローコードエージェントに Action Center エスカレーション（HITL）を追加する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/capabilities/escalation/escalation.md
ローコードエージェントにガードレール（PII、有害コンテンツ、カスタムルール）を追加する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/capabilities/guardrails/guardrails.md
添付ファイルまたは生成ファイルをガードレールで保護する（detectionScope: Text / Files / Both）	ローコード	lowcode/capabilities/guardrails/guardrails.md § ファイルと添付ファイル	lowcode/capabilities/guardrails/files-guide.md
コードベースのエージェントに新しいガードレールを追加する	コードベース	coded/capabilities/guardrails/guardrails.md	WebFetch で公式ドキュメントを取得し、ミドルウェアかデコレーターかを確認し、エージェントのコードを読み、Python を記述する
エスカレーションガードレール（エスカレーションアクション／Action Center アプリ）を追加する	ローコード	lowcode/capabilities/guardrails/escalation-guide.md	uip solution resources list --kind App --source remote --output json を実行してアプリの存在を確認する
ローコードエージェントのコンテキストに基づいてガードレールを推奨する	ローコード	lowcode/capabilities/guardrails/guardrails-recommend.md	カタログとリストを取得し、エージェントのコンテキストを分析し、適用して検証する
特定のスコープまたはツール向けのガードレールを推奨する	ローコード	lowcode/capabilities/guardrails/guardrails-recommend.md § スコープまたはツール固有のフィルタリング	カタログの分析後、スコープまたはツール名で候補を絞り込む
既存のガードレールが正しく設定されているか検証する	ローコード	lowcode/capabilities/guardrails/guardrails-recommend.md § 検証モード	ガードレールごとに正確性、実行可能性、関連性を確認する
コードベースのエージェントのコンテキストに基づいてガードレールを推奨する	コードベース	coded/capabilities/guardrails/guardrails-recommend.md	カタログ、リスト、SDK ドキュメントを取得し、エージェントのコードを分析し、適用して検証する
特定のスコープまたはツール向けのガードレールを推奨する（コードベース）	コードベース	coded/capabilities/guardrails/guardrails-recommend.md § スコープとツールのフィルタリング	カタログの分析後、@tool 関数またはスコープで候補を絞り込む
既存のコードベースのガードレールが正しく設定されているか（配置／スコープ）を確認、検証、診断、または修正する	コードベース	coded/capabilities/guardrails/guardrails-recommend.md § 検証モード	最初に SDK ドキュメントを取得する（スコープ／配置に関する正式な情報源です）。関連性／利用権限についてはカタログとリストも取得し、その後、正確性、実行可能性、関連性を確認し、既存の設定をその場で修正する
ローコードエージェントをフローにインラインで埋め込む、またはマルチエージェントソリューションを接続する	ローコード	lowcode/lowcode.md § 機能レジストリ	lowcode/capabilities/inline-in-flow/inline-in-flow.md、lowcode/capabilities/process/solution-agent.md
ローコードの評価を実行する	ローコード	lowcode/evaluations/evaluate.md	lowcode/evaluations/evaluators.md、lowcode/evaluations/evaluation-sets.md、lowcode/evaluations/running-evaluations.md
公開済みエージェントのランタイム評価を管理する	ローコード	lowcode/evaluations/runtime-eval-run.md	uip eval execute-and-evaluate、評価器／評価セット／評価の CRUD、シミュレーション、実行結果、スケジュール
ローコードエージェントを検証、パック、公開、アップロード、またはデプロイする	ローコード	lowcode/lowcode.md	lowcode/project-lifecycle.md、lowcode/solution-resources.md
ローコードエージェントをエンドツーエンドでデバッグ／実行し、出力を確認する	ローコード	lowcode/debug.md	lowcode/project-lifecycle.md § uip agent debug
コードベースのエージェントをフローに埋め込む（ソリューションレベル）	コードベース	coded/embedding-in-flows.md
フローでコードベースのエージェントを使用する	コードベース	coded/flow-integration.md
フロー内の別のエージェントのツールとしてコードベースのエージェントを使用する	コードベース	coded/flow-integration.md § パターン 3
PDF または TXT を対象に要約／調査／統合する（DeepRAG、コードベース）	コードベース	context-grounding-patterns.md	coded/capabilities/deeprag/planning.md
PDF または TXT を対象に要約／調査／統合する（DeepRAG、ローコード）	ローコード	context-grounding-patterns.md	lowcode/capabilities/built-in-tools/deeprag/planning.md
CSV の各行を LLM で処理する（BatchTransform、コードベース）	コードベース	context-grounding-patterns.md	coded/capabilities/batch-transform/planning.md
CSV の各行を LLM で処理する（BatchTransform、ローコード）	ローコード	context-grounding-patterns.md	lowcode/capabilities/built-in-tools/batch-transform/planning.md
CLI からコンテキストグラウンディングのインデックスを管理する（一覧表示／作成／取り込み／検索）	プラットフォーム	uipath-platform/references/context-grounding/index-management.md	uip context-grounding — 複数領域にまたがる CLI で、uipath-platform が管理します

Resources

• UiPath Python SDK: https://uipath.github.io/uipath-python/
• UiPath Evaluations: https://uipath.github.io/uipath-python/eval/