エージェント プロジェクトのコンテキストを提供する

セッションごとに、コーディング エージェントは新たに開始されます。プロジェクト規則の永続的なソースがなければ、同じ指示が繰り返され、エージェントが忘れられると漂流します。コンテキストファイルは、セッションの開始時にエージェントが自動的に読み取り、毎回従うべきルールと規則を保持するファイルです。

コンテキスト ファイルを使用する理由

すべてのプロンプトで規則を再入力するのは遅く、間違えやすいです。コンテキストファイルは、これらの指示を永続的で一貫性のあるものにするため、エージェントは推測するのではなく、デフォルトでハウススタイルに従います。

AGENTS.md、一般的な規則

AGENTS.md 、新しいクロスツール規則です。プロジェクトのルートにある Markdown ファイルを、コーディング エージェントがプロジェクトの指示のために読み取ることです。一部のエージェントは代わりに独自のファイル名を検索しますが、正確な名前に関係なく、考え方は同じです。エージェント自身のドキュメントには、予期されるファイル名と場所が一覧表示されます。

グローバルとプロジェクトの範囲

ほとんどのエージェントは、次の 2 つのレベルのコンテキストをサポートしています。

• [グローバル ] では、すべてのプロジェクトに適用される個人の地位に関する好み (UiPath の既定の組織とテナント、好みのスタイルなど) が維持されます。
• プロジェクトは 、1つのプロジェクトに固有の規則を保持し、プロジェクトのコンテキストファイルに保持されるため、リポジトリとチーム全体の利益と一緒に移動します。

組織全体のルールは、グローバルなコンテキストに属します。プロジェクト固有のルールはプロジェクト ファイルに属します。

入れるもの

便利なコンテキストファイルは短くて具体的です。UiPath の作業に役立つコンテンツには、次のようなものがあります。

• このプロジェクトには UiPath のスキルが含まれているため、エージェントは適切なスキル (たとえば、ロボティック プロセス オートメーション (RPA) の作業の場合は uipath-rpa 、プロセス オーケストレーションの場合は uipath-maestro-flow など) に到達します。
• 「必ずワークフロー アナライザーを実行し、すべての問題を解決してから作業完了を宣言する」などの永続的な品質ルール。
• 優先パッケージとピン留めされたパッケージ、優先または回避するアクティビティ (例: [コードを呼び出し] ではなくネイティブ アクティビティ)。
• プロジェクトの規則: 名前付け、構造、チームが従うパターン。
• エージェントが考慮しなければならない明示的な制約 (記録済みの UI ワークフローや既存の構成ファイルを上書きしないなど)。

UiPath プロジェクトの簡単な AGENTS.md は次のようになります。

# Project conventions

- Use the `uipath-rpa` skill for automation work in this project.
- Always run the Workflow Analyzer (Analyze Project) and resolve every problem before calling work done.
- Prefer native activities over Invoke Code; keep UI activities inside a Use Application/Browser scope.
- Pin package versions in project.json; do not upgrade packages without asking.

ここでキャプチャする価値のある RPA 固有の規則については、「 RPA ワークフロー」をご覧ください。

最新の状態に保つ

コンテキストファイルの良し悪しは、その内容によって決まります。古くなったファイルは、間違ったコメントが開発者を誤解させるのと同じように、エージェントを静かに誤解させるので、慣習が変わるにつれて刈り込む価値があります。