- はじめに
- ベスト プラクティス
- 機能
- スキル
- CLI
- 例
- Advanced (カスタム)
- ヘルプ
コーディングエージェントは、自律的な開発者ではなく、迅速な共同作業者です。あなたは方向性を設定し、結果を判断します。エージェントが足を運びます。1人とうまく協力することはそれ自体がスキルであり、適切な習慣は、あなたが捨てたドラフトをあなたが出荷できる結果から分離します。
コーディングエージェントの仕組みと役割
コーディングエージェントは、目標を段階的に実行し、各アクションの結果を確認し、曲がり角を逃した後にナビゲーションアプリを再ルーティングするように調整します。途中で問題にぶつかり、そこから回復するのは、システムが意図したとおりに機能し、故障ではありません。
あなたの役割は終始中心的なものです。目標を設定し、作業を監視し、問題を把握し、状態が変わるものはすべて承認します。より有能なエージェントは、その見落としを取り除くのではなく、その見落としの賭け金を上げます:エージェントが支援し、あなたが決定します。
成功するための設定
良い結果は、巧妙な言葉遣いだけでなく、3つのことが連携することでもたらされます。
- 明確な要求。
- サウンドのセットアップ。
- 適切なコンテキスト。
エージェントは有限のワーキングメモリから作業するため、ボリュームよりも関連性があり最新のものが重要です。
- エージェントは、ユーザーが持っているすべてのファイルではなく、タスクに必要な特定のファイル、目標、標準を最も効果的に処理します。
- スキルは必ずしも自動的に選択されるとは限らないため、適切な UiPath スキルが利用可能である必要があります。タスクのスキルに名前を付け (ロボティック プロセス オートメーション (RPA) 作業の
uipath-rpaなど)、読み込まれていることを確認することで、エージェントはハウス パターンにとどまります。詳しくは、「スキルの概要」をご覧ください。 - 新しいタスクごとに新しいセッションを設定することで、古いコンテキストがにじみ込むのを防ぎます。
- セッションごとに繰り返す規則は、エージェントが自動的にロードするファイルに属します。詳しくは、「 エージェント プロジェクトにコンテキストを与える」をご覧ください。
効果的な5つの習慣
- あなたは建築家です。必要なもの、インプット、制約など、明確な意図と構造は、あなたが持っていくものです。
- 出力は下書きです。生成された作業は、信頼する前にレビューする価値があり、未レビューで出荷するためのものではありません。
- 検証は信頼に勝ります。ワークフロー アナライザー (プロジェクトの分析) やローカル実行などの UiPath 独自のチェックは、エージェントの「完了」メッセージよりも信頼性が高くなります。
- レビュアーでもあります。エージェントは、セキュリティの問題、ギャップ、なじみのないコードを記述するだけでなく、それを見つけるのも得意です。
- ループコンパウンドを閉じます。充実したセッションの後、何がうまくいったかについての短いメモは、チームの知識が蓄積するにつれて報われます。
効果的なプロンプトを記述する
リクエストの質は、セッションの進行の最大の要因です。強力なプロンプトには以下が含まれます。
- 明確な成果物:作成する正確なファイルまたはプロジェクト、およびそれがどこにあるか。
- 名前付きの入力データと出力データ、およびその型
- エンドツーエンドで期待される動作です。
- 明示的な制約: 使用するアクティビティまたはパッケージと、回避するアクティビティまたはパッケージです。
- 既存の依存関係など、エージェントが必要とするコンテキスト。
曖昧な要求は、特定の要求よりも修正の反復処理が多くなります。たとえば、"in_FilePath (String)を読み取り、SharePoint にアップロードし、out_Url (String)を返す UploadInvoice.xaml を作成する" は、"ファイルをアップロードするものを作成する" よりも効果的です。
PDD または SDD から開始する
重要なオートメーションの最も強力な入力は、構造化された仕様です。プロセス設計書 (PDD) またはソリューション設計書 (SDD) には、適切な要求に必要なもののほとんどが既に含まれています。
- 手順
- 入力
- 関連するシステム
- 例外パス
メモリからプロセスを記述するのではなく、エージェントに渡すと、前後のやり取りが少なくなり、より近い最初の結果が得られます。
大規模な作業では、エージェントは PDD を SDD とビルド計画に変換し、1 回のパスで生のドキュメントからすべてをビルドするのではなく、1 つずつ作業できます。1 つの注意点: PDD または SDD は実際の顧客データを保持できるため、ドキュメントがエージェントに届く前にデータを削除することが重要です。エージェントは実際の値ではなく構造を必要とするためです。
最初に計画し、計画を反復処理する
コーディングエージェントは、何かを変更する前に、エージェントが実行しようとしていることの計画をドラフトし、レビューするプランモードを提供する場合があります。計画はコードよりも修正にかかる時間が短いため、アプローチ、ファイル レイアウト、または作業の順序を修正して反復処理すると、1 行も書き込まれる前に報われます。計画が正しく読み取られた後にのみ計画を承認することで、ビルドは順調に進み、間違ったアーキテクチャが遅れて浮上するのを防ぎます。
レビューされ、合意された計画は、ガイド付きセッションとドリフトセッションの違いです。
生成、チェック、改良のループ
ほとんどの重要な作業は、エージェントが生成し、チェックしてから、改良または再生成するという2〜3サイクルで実行されます。最後のステップだけでなく、意味のある各ステップの後にチェックすると、最初の問題が切り分けられ、遅く感じる場合でも全体的に高速になります。UiPath プロジェクトの場合、チェックは具体的に行われます。エージェントはワークフロー アナライザーとビルドを実行し、すべての問題を解決し、ローカルでの実行を確認してから何かが完了しました。
| 次の場合に反復処理 | [最初からやり直す] |
|---|---|
| この問題はローカライズされており、修正に名前を付けることができます | エージェントは、同じ壊れた出力のバリエーションでループ処理を行います |
| 構造は正しいです | 構造自体が間違っている |
| あなたは修正または2つの範囲内にあります | 3 回目か 4 回目の修正を試みている |
新たなスタートは失敗ではありません。それは最速の道になる傾向があります。言い回しについて学んだ内容は、次のプロンプトに反映されます。
コントロールを維持する
コーディング エージェントは、元に戻すのが難しいアクションを実行できます。いくつかのルールにより、作業が安全になります。
- Orchestrator へのパブリッシュやデプロイなど、共有システムを変更するアクションは、明示的に承認する価値があります。
- 秘密はプロンプトに含まれません。UiPath アセットとして保存されるか、資格情報ストアに保存されている場合は、代わりに名前で参照されます。
- 実際の顧客データはプロンプトには属しません。エージェントに必要なのは値ではなく構造だからです。
- すべてのパッケージの変更はレビューする価値があり、バージョンは
project.jsonにピン留めされています。
このエージェントは、ユーザーの権限と監査証跡を含む、ユーザーの UiPath ID の下で動作するため、そのアクションは事実上ユーザー自身のものになります。これが組織にどう適用されるかについては、「 ガバナンスと信頼」をご覧ください。生成された作業で何を探すべきかについては、「 出力のレビューと検証」を参照してください。