- 概要
- インストールと設定
- スタート アップ ガイド
- 信頼とコンプライアンス
- ガバナンス
- 機能
- 参照
- トラブルシューティング
- バックアップと復元
チームとスキルを共有する
権限やフィードの動作など、Cartographer のスキルとルーチンをパブリッシュ、インストール、レビュー、共有します。
構築したスキルは、パブリッシュするまでマシン上にのみ存在します。ルーチンはユーザーが呼び出し可能とマークされたスキルであるため、このページのすべてはルーチンにも適用されます。
スキルの公開場所: フィード
スキルをパブリッシュすると、そのスキルはフィードにアップロードされます。フィードは、スキル パッケージの読み書き先となる場所です。フィードを切り替えるには、[スキルを検出] のソース セレクターを使用します。
| フィード | リーチ | 設定者 |
|---|---|---|
| Orchestrator テナントのライブラリ フィード | そのテナント内のすべてのユーザー | 自分自身の Orchestrator 管理者 — これはすべてのテナントの既定のターゲットです |
| 共有フィード | 一度に複数の組織を操作する | UiPath によって個別に設定され、Orchestrator の外部で、組織にスキルが存在する場合にのみ設定されます。「組織外でスキルを共有する」をご覧ください。 |
| 追加するリポジトリ | GitHub がホストするスキル リポジトリなど、どこを指す場合でも | [アドオンと連携] → [プラグイン] から — 「リポジトリのソース」をご覧ください |
Cartographer からパブリッシュされるすべてのスキルは、Orchestrator の [テナント ] → [ パッケージ ] → [ライブラリ ] → [テナント] にあります。
これらのフィードに表示されるスキル、スキルの検出、およびキュー レビューの各ビューについては、「 スキル リファレンス 」をご覧ください。
スキルを作成する
エージェントに説明する場合でも、手書きで記述する場合でも、スキルには次のものが必要です。
- 明確な トリガー — エージェントはいつこのスキルに手を伸ばす必要があるか。
- 明確な 指示 — ステップバイステップで何をすべきか?
これらは、スキルをパブリッシュする際に、スキル の概要フィールドと 「 いつ使用すべきか 」フィールドになります。
また、チャットで実行した操作を再利用可能なスキルに変えることもできます。そのためには、チャットで実行した操作を直接依頼するか、提案されたプロンプト [ 現在のタスクを再利用可能なオートメーション スキルに変換] を使用するか、[ 記録を作成 ] を選択して自分で実行したステップをキャプチャします。
いずれにせよ、その結果、マシン上にスキル フォルダーが作成され、パブリッシュするまで他の誰にも表示できません。[ アドオンと連携 ] → [ スキル ] → [ スキルを検出] で、[インストール 済み ] として [ 未公開] の下に一覧表示されます。
スキルを追加する
[ アドオンと連携 ] → [ スキル] で [ スキルを追加 ] を選択し、次の 3 つのオプションのいずれかを選択します。
| オプション | 機能 |
|---|---|
| Cartographer で新しいスキルを作成する | 何が欲しいかを説明し、エージェントにスキルを構築させます |
| スキルを zip からインポート | .zip ファイルからスキル パッケージを追加する |
| スキル フォルダーを開く | ローカルのスキル フォルダーを直接開いて、ファイルを自分で追加または編集する |
手動で作成したスキル フォルダーは、Cartographer の起動時にのみ選択されます。 [スキルを同期 ] オプションでは検出されません。この方法で Cartographer を追加した後、Cartographer を再起動します。
公開する前に
次の 3 つのことが当てはまる必要があります。そうしないと、パブリッシュは機能しません。
- Orchestrator に接続されました。オフラインの場合は、閲覧するものもパブリッシュする場所もありません。
- テナントがライブラリのアップロードを受け入れているOrchestrator 管理者が [ テナント →設定] → [ デプロイ] の [ ライブラリ ] カードでこれを設定します。[ フィード] を [ ホスト フィードとテナント フィードの両方 ] (または [ テナント フィードのみ)] に設定して保存します。[ ホスト フィードのみ] に設定すると、パブリッシュはテナント全体で無効化され、[ スキルを検出 ] セクションは参照とインストールのみになります。
- Orchestrator で
Libraries.Create権限を持っている。タイムアウトが設定されていない場合、[ パブリッシュ] ボタンはまったく表示されず、[ レビューのために提出] としか表示されません。Libraries.Viewで、参照してインストールできます。
ロールと権限
ここには 2 つの別々の権限レイヤーが適用され、異なるものを制御します。
| レイヤー | コントロール | 場所 |
|---|---|---|
Orchestrator (Libraries.View / Libraries.Create) | フィードの表示と使用の有無 ([表示] で参照してインストールし、[作成] でパブリッシュ) | 管理者が設定する Orchestrator ロール |
| ツールの権限 | インストール済みのスキルが実行後にマシンで実際にできること (ツールごとの許可、確認、またはブロック) | 設定 → セキュリティ、または Automation Ops を使用したガバナンスを介して一元的に |
Libraries.Create を押したままにしても、Orchestrator でパブリッシュできるという意味だけです。実行時にスキル自体が実行できる操作については何も示されません。これは、Cartographerが実行する他のアクションと同様に、 ツールの権限 と承認モードによって完全に制御されます。
自分で構築していないスキルをインストールする前に、そのスキルの [ファイル] タブで、使用されているツール、接続、ファイル システムまたはネットワーク アクセス、およびそれが記載されている目的と一致しているかどうかを確認してください。目的に関係のないツール、正当な理由のない広範なファイルシステムへのアクセス、または明確な理由のない機密性の高いサービス(銀行、人事システム)への接続を求めるスキルには注意してください。
ロールに関しては、スキルを参照、インストール、実行するには Automation User で十分です。パブリッシュには、 Libraries.Createを持つロール (通常は Automation Publisher ロール、またはカスタム テナント) が必要です。
スキルをパブリッシュする
構築したスキルをパブリッシュするには、次の手順を実行します。
- [ アドオンと連携 ] → [ スキル] → [ スキルを検出] で、[ インストール済み] でスキルを見つけます。共有するまで「 未公開 」と表示されます。
- カードを開いて [ 概要 ] タブを確認します。この説明により、ユーザーはスキルを公開する前にスキルを判断します。
- カードのアップロード アイコンを選択するか、詳細ページで [ローカルな変更をパブリッシュ ] を選択します。
- 必須フィールドに入力します: [バージョン ] (このスキル用に既にパブリッシュされているバージョンよりも高い必要があります)、[ ロール]、[ 種類]、[ 概要]。変更メモ は、初回公開時の任意です。Generate with AI では、パッケージの記述フィールドの下書きを作成できます。
- [ 公開 ] を選択してすぐに公開するか、[ レビューのために提出 ] を選択して最初にレビュー担当者に送信します。どちらのフッターで指定されているかを選択します。
[ ロール] と [種類 ] の選択肢は結果として生成されるパッケージのプロパティになり、タグはラベルになり、[ 概要 ] はパッケージの説明になります。
パブリッシュ済みであることを確認するには、詳細ページを確認します。テナント名がバージョンの横に表示され、アクションが [ローカルの変更をパブリッシュ ] から [再パブリッシュ] に変わります。確実な答えについては、Orchestrator のテ ナント → パッケージ → ライブラリ →テ ナント を確認してください。これが実際のパッケージ リストです。
スキルが公開されると、チームは [スキルを検出] で 利用可能 でスキルを見つけ、[ インストール ] を選択して自分のスキル フォルダーにダウンロードできます。これで、エージェントは次の会話から開始して使用できます。「 スキルをインストールする」をご覧ください。
パブリッシュ済みのスキルを更新する
スキルの編集 — チャット内で、またはスキルのファイルを直接変更します。パブリッシュ済みバージョンのインプレース編集はありません。変更はすべて新しいバージョンとして出荷されます。変更を加えたら、以下の操作を行います。
- カタログにスキルが 変更済みとマークされ、詳細ページに [ 変更 ] タブが再度表示され、変更内容が表示されます。
- [ 更新をパブリッシュ] を選択します。バージョン番号は、公開されているバージョン番号より 1 ステップ上にあらかじめ入力されています。今回は 変更点 を説明する変更メモが必要です。
- もう一度 [ 更新をパブリッシュ ] を選択して出荷します。
バージョンはそれ以降にのみ実行されます。バージョン番号の再利用は拒否されます。
スキル品質ガイドライン
他のユーザー向けに公開するスキルは、次の基準を満たしている場合、より有用であり、信頼される可能性が高くなります。
| 基準 | 説明 |
|---|---|
| 明確な目的 | 一つのことをうまく、一文で説明します |
| 十分に文書化されている | 「概要」では、その機能、使用すべき状況、必要なものについて説明しています |
| テスト済み | さまざまなマシンや構成で確実に動作します |
| セキュリティ保護 | 不要な権限を要求せず、資格情報を安全に処理します |
| 保守が可能 | 指示が読みやすく、依存関係が最小限である |
| バージョン管理 | セマンティック バージョン管理 (1.0.0、1.1.0、など) |
スキルをインストールする
他のユーザーがパブリッシュしたスキルをインストールするには、次の手順を実行します。
- [ スキルを検出] で、[ 利用可能] の下にあります。検索フィルター、ロールフィルター、種類フィルターを使用してリストを絞り込みます。
- カードを開き、自分で構築していないものをインストールする前に、 概要 と ファイル を確認します。
- [インストール] を選択します。
結果:スキル カードが [スキルを検出] の [インストール済み] セクションに移動します。
スキルのインストール、有効化、無効化は、新しい会話でのみ有効になります。新しいバージョンがパブリッシュされると、カードに [ 更新可能] と表示されます。自分のコピーを編集した場合、更新すると最初に警告が表示され、変更を保持するか上書きするかを提案されます。
パブリッシュされたパッケージに影響を与えずに自分のコピーを削除するには、[ このデバイスからアンインストール] を使用します。パッケージを完全に削除するには (すべてのユーザーに対して)、同じメニューの [ Orchestrator から削除 ] を使用します。「 スキルをパブリッシュする」をご覧ください。
レビューと承認を取得する
Libraries.Create権限がない場合、フォームを公開するには [レビューのために送信] のみが提供されます。通常のパブリッシュと同じフィールドに入力して送信します。まだ何も公開されません。
[ アドオンと連携 ] → [ スキル ] → [レビュー] キューの [ 自分の提出物] から提出物を追跡します。いくつかの状態を通過します。
| ステータス | 意味 | 対応策 |
|---|---|---|
| 保留中 | レビュー担当者待機中 | パッケージを取り消すか、削除してステージングされたパッケージを解放します |
| パブリッシュしています... | 承認済み。アップロード中 | 待機 |
| パブリッシュ済み | ライブ — このリストを残します | [スキルを検出] または Orchestrator で確認します |
| 却下済み | 辞退、理由添付 | 理由を読んで修正し、もう一度提出してください |
| パブリッシュに失敗しました。 | 承認されましたが、アップロード自体が失敗しました。 | 何もしない — レビュー担当者はリトライします |
保留中の提出物に所有者がいません。割り当ても、リマインダーも、エスカレーションも、SLA もありません。誰かがキューをチェックするまで、そこに放置されます。チームのレビューに頼る前に、少なくとも 1 人のユーザーが Libraries.Create を保持し、キューの存在を理解していることを確認してください。
公開権限を持っている場合は、[レビュー] キューの 2 番目のレーンに、待機中の提出物が表示されます。開くと、バージョン、提出者、説明、および配信先が表示されます。
- [レビューを実行] では、決定する前に、推奨事項、その推論、リスク フラグなど、パッケージが自動的に読み取られます。これは単なる勧告であり、それ自体は何もアップロードまたは削除しません。
- 承認: 自分のアカウントでパッケージを公開します。
- 却下 には理由が必要で、その理由は提出者に戻されます。
チャットからスキルをパブリッシュおよびインストールする
上記のすべては、あなた自身の言葉で尋ねることによっても利用可能です。
| 読み上げ | フェーズの説明 |
|---|---|
| 「スキルのリストを取得」または「利用可能なものは何ですか?」 | テナント フィードに対してクエリを実行し、パブリッシュ済みのすべてのスキルをバージョンおよび日付とともに出力する |
| 「自分のスキル X を公開してください」 | パッケージ化してアップロードし、初回公開か新規バージョンかを独自に判断します |
| 「Xをインストールする」または「Xをダウンロードする」 | パッケージを取得してインストールします |
| 「更新を確認」 | フィードをインストール済みのフィードと比較する |
チャット ルートは、すでに 1 つを使用している場合、1 つの文で完了したい場合、または一度に多くのスキルを調査している場合に使用します。[スキルを検出] UI は、出力される前にすべてのフィールドを確認または編集する場合、 レビューのために送信 する必要がある場合 (チャット ルートで直接公開される場合)、または [AI で生成 ] で説明の下書きを作成する場合に使用します。
組織外でスキルを共有する
共有フィードを使用すると、スキルを自分のテナントだけでなく他の組織にもリーチできます。共有フィードはセルフサービスではなくデプロイ時に UiPath によって設定されます。組織にフィードがない場合、共有フィードは表示されません。自分のテナント内でのパブリッシュとインストールは、上記のとおりに機能します。
共有フィードにパブリッシュする
組織で共有フィードが設定されている場合は、パブリッシュ フォームで [ フィードに共有 ] セクションが拡張され、フィードごとにチェック ボックスが自分のテナントと並んで表示されます。パブリッシュする前にチェックボックスをオンにします。どちらを選択するか、スキルもそこに移動します。
一度に複数のターゲットにパブリッシュすると、部分的には成功する可能性があります。Cartographer は、どのイベントが失敗したかを正確に報告します (例: 「組織に公開されました。パブリッシュ先:<feed> 。」どちらの宛先が成功しても、公開されたままになります。
共有フィードからスキルを受け取る
共有フィードを通じてあなたのスキルを受け取った別の組織のユーザーは、次のことができます。
- チャットでテスト する (サンドボックスで実行しますが、何もインストールしません)
- ライブラリに追加して 、自分のテナントにコピーします (パブリッシュ可能な場合)
- Orchestrator への追加をリクエストすると、管理者に確認して追加するよう依頼されます
これらのオプションのいずれも、他の組織のフィードからスキルを直接インストールすることはありません。管理者が独自のガバナンスの下でコピーを導入するか、誰かが何もインストールせずに最初に試すかは、受信組織が常に決定します。
スキルを削除する
スキルの詳細ページのゴミ箱アイコンのメニューには、2 つの異なる結果をもたらす 2 つのアクションがあります。
| 操作 | 削除 | 触れない |
|---|---|---|
| このデバイスからアンインストール | ローカル コピー | パブリッシュされたパッケージと他のユーザーのコピー |
| Orchestrator から削除 | テナント全体を対象としてパブリッシュされたパッケージ | ユーザーが既にインストールしたコピー |
アンインストールは最初に確認を求めます:<skill> 「『 』をアンインストールしてもよろしいですか?これにより、ローカル マシンから削除されます。」
ベスト プラクティス
ユーザーの場合
- インストール前に権限を確認する — やみくもに承認しないでください
- 最初に、重要ではないタスクで新しいスキルをテストします
- 最新の修正と互換性に合わせてスキルを最新の状態に保ちます
- 使用していないスキルをアンインストールする
パブリッシャー向け
- 必要な権限のみを要求します — スキルがファイルの読み取りのみである場合は、UI 操作の自動化は要求しないでください
- エラーを適切に処理する — 何が問題だったのか、どのように修正できるかをユーザーに説明します
- ユーザー データを尊重する — データの漏洩を行わないようにし、プライバシーの設定を尊重します。
次のステップ
- スキル リファレンス — スキルとは何か、およびスキル / スキルの検出 / キュー ビューの確認
- Repeating work with Routines — How a routine relates to a skill
- プラグインを使用して機能を拡張 する — スキル、MCP サーバー、資格情報をまとめてバンドルします
- Publishing and installing skills troubleshooting — Fixes for publish, install, and review issues