# Workload APIスキル

> Workload APIスキル - Claude Code、Cursor、OpenCode、VS Code Copilotなどのサードパーティ製コーディングエージェントに、DataRobot
> Workload APIのスキルをインストールして使用します。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-27T18:44:30.809884+00:00` (UTC).

## Primary page

- [Workload APIスキル](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [スキルのインストール](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#install-the-skill): In-page section heading.
- [インストールの確認](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#verify-installation): In-page section heading.
- [環境設定](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#configure-your-environment): In-page section heading.
- [コーディングエージェントでスキルを使用する](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#use-the-skill): In-page section heading.
- [デプロイ、設定、スケーリング](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#deploy-configure-scale): In-page section heading.
- [障害の診断](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#diagnose-failures): In-page section heading.
- [実行中のワークロードの監視](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#observe): In-page section heading.
- [アーティファクトのライフサイクルの管理](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#artifact-lifecycle): In-page section heading.
- [バンドルされたヘルパースクリプト](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#helper-scripts): In-page section heading.
- [関連スキル](https://docs.datarobot.com/ja/docs/workload-api/get-started-workloads/workload-api-skill.html.md#related-skills): In-page section heading.

## Documentation content

> [!NOTE] プレミアム機能
> Workload APIはプレミアム機能です。 この機能を有効にする方法については、DataRobotの担当者または管理者にお問い合わせください。

Workload APIのスキル（ `datarobot-workload-api` ）は、サードパーティ製のコーディングエージェント内で使用できるよう、Workload APIの知識と運用ワークフローをパッケージ化したものです。 作業中にリファレンスドキュメントを参照する代わりに、希望する内容を自然言語で記述するだけで、このスキルがコーディングエージェントに対し、適切なAPI呼び出し、デバッグ手順、ライフサイクルに関する判断をガイドします。

このスキルは、他のDataRobotスキルとともに [DataRobot Agentic Skillsリポジトリ](https://github.com/datarobot-oss/datarobot-agent-skills) にあります。 このスキルは、ワークロードのデプロイとスケーリング、障害の診断、実行中のワークロードの監視、およびドラフトから本番環境への展開に至るまでのアーティファクトのライフサイクル管理という、4つの運用領域をカバーしています。

## スキルのインストール

[ユニバーサルスキルインストーラー](https://github.com/skillcreatorai/Ai-Agent-Skills) を使用して、すべてのDataRobotスキル（Workload APIスキルおよび必須の `datarobot-setup` スキルを含む）をインストールします。

```
npx ai-agent-skills install datarobot-oss/datarobot-agent-skills 
```

デフォルトでは、インストーラーはマシン上のサポートされているすべてのコーディングエージェントにスキルをコピーします。 特定のエージェントをターゲットにするには、 `--agent` フラグを追加します。

```
npx ai-agent-skills install datarobot-oss/datarobot-agent-skills --agent cursor
npx ai-agent-skills install datarobot-oss/datarobot-agent-skills --agent claude 
```

エージェント固有のマーケットプレースまたは拡張機能カタログからインストールすることもできます。

| エージェント | インストール元 |
| --- | --- |
| Claude Code | claude.com/plugins/datarobot-agent-skills |
| Cursor | cursor.com/marketplace/datarobot |
| Gemini CLI | geminicli.com/extensions |
| Skillsリポジトリ | github.com/datarobot-oss/datarobot-agent-skills |

エージェント固有のインストールの詳細およびサポートされているエージェントの完全なリストについては、 [DataRobotのエージェントスキル](https://docs.datarobot.com/ja/docs/agentic-ai/agentic-develop/agentic-skills.html.md) を参照してください。

### インストールの確認

インストール後、コーディングエージェントに `利用可能なDataRobotスキルは何ですか？` と尋ねます。

`datarobot-setup` および `datarobot-workload-api` が一覧に表示されるはずです。 スキルのソースとヘルパースクリプトは、リポジトリ内の [skills/datarobot-workload-api/](https://github.com/datarobot-oss/datarobot-agent-skills/tree/main/skills/datarobot-workload-api) にあります。

## 環境設定

ワークロードを扱う前に、ワークスペースごとに1回、 `datarobot-setup` スキルを実行します。 これにより、Pythonやその他の依存関係がチェックされ、DataRobot APIトークンが設定されて、セッション用の `DATAROBOT_ENDPOINT` および `DATAROBOT_API_TOKEN` が設定されます。

以下のいずれかの方法でセットアップをトリガーします。

- Run datarobot-setup を入力します。
- またはスラッシュコマンド ./datarobot-setup を使用します。

プロンプトに従って環境設定を完了します。 後のセッションで設定が再度実行される場合は、前提条件を最新に保つために実行を許可してください。

## コーディングエージェントでスキルを使用する

Workload APIのタスクを自然言語で記述すると、スキルが自動的に起動します。 スラッシュコマンドを使用したり、スキルの名前を明示的に指定したりする必要はありません。 このスキルは、以下の4つの領域をカバーしています。

### デプロイ、設定、スケーリング

実行したい内容を記述するだけで、スキルがアーティファクトとワークロードの作成、環境変数の注入、コンピュートバンドルの選択、およびオートスケーリングの設定を処理します。

プロンプトの例

- 「 ghcr.io/my-org/my-app:latest を、ポート8000でリスニングするDataRobot上のワークロードとしてデプロイしてください。」
- 「 agent-service ワークロードを3つのレプリカにスケールし、CPUのオートスケーリングを有効にしてください。」
- 「 prod-llm の重要度を critical に変更してください。」
- 「私のS3資格情報を AWS_ACCESS_KEY_ID として data-pipeline ワークロードに注入してください。」

### 障害の診断

ワークロードがスタックしたり、エラーが発生したり、クラッシュループに陥ったりした場合、このスキルはワークロードのステータス、ライフサイクルイベント、Proton状態、およびレプリカごとのコンテナの状態について体系的な診断を実行し、解決策を提案します。

プロンプトの例

- 「私の rag-service ワークロードが launching 状態でスタックしています。 何が問題なのでしょうか？」
- 「 inference-server 上の CrashLoopBackOff をデバッグしてください。」
- 「なぜ私のワークロードは ImagePullBackOff で失敗しているのでしょうか？」

### 実行中のワークロードの監視

実行中のワークロードからログ、トレース、指標、およびサービス統計情報をプルします。 このスキルは、OTelのオブザーバビリティインターフェイスのエンドポイントとWorkload APIの統計インターフェイスを把握しており、結果を表示する前に適切な単位変換を適用します。

プロンプトの例

- 「 llm-gateway からの直近100件のエラーログを表示してください。」
- 「過去1時間に agent-service のどのトレースでエラーが発生しましたか？」
- 「 prod-api のリクエストエラー率とP50レイテンシーはどのくらいですか？」

### アーティファクトのライフサイクルの管理

アーティファクトのドラフトを反復修正し、本番環境用にロックして、稼働中のワークロードにダウンタイムゼロで新しいコンテナバージョンを展開します。

プロンプトの例

- 「 staging-api のアーティファクトをロックし、本番環境に昇格させてください。」
- 「ローリング置換を使用して、 ghcr.io/my-org/my-app:v2 を prod-api に展開してください。」
- 「 llm-service でアーティファクトのクローンを作成し、イメージタグを :v3 に更新して、置換を開始してください。」

## バンドルされたヘルパースクリプト

このスキルには、 `skills/datarobot-workload-api/scripts/` ディレクトリのPythonスクリプトが含まれており、コーディングエージェントが直接実行できます。

| スクリプト | 目的 |
| --- | --- |
| wait_for_running.py <workload_id> | running状態になるまでポーリングします。回復不能なエラーまたはタイムアウト時には、0以外の値で終了します。 |
| diagnose_workload.py <workload_id> | 5ステップのデバッグフローをすべて実行し、構造化された診断結果を出力します。 機械で読み取り可能な出力を得るには、--jsonオプションを追加します。 |
| wait_for_build.py <artifact_id> <build_id> | サーバー側のイメージビルドをポーリングします。失敗した場合は、ログの最後の2 KBを出力します。 |
| wait_for_replacement.py <workload_id> | ローリング置換が完了するまでポーリングします。 |
| check_limits.py | 組織で設定された、有効な同時実行数およびレプリカ数の上限を出力します。 |

すべてのスクリプトは、環境変数から `DATAROBOT_ENDPOINT` および `DATAROBOT_API_TOKEN` を読み取ります。

## 関連スキル

| スキル | 目的 |
| --- | --- |
| datarobot-setup | DataRobot SDKのインストール、認証の設定、および環境変数の設定を行います。 このスキルを使用する前に必要です。 |
| datarobot-app-framework-cicd | PulumiおよびCI/CDパイプラインを用いた宣言型のアーティファクトおよびワークロード管理。 |
| datarobot-external-agent-monitoring | OpenTelemetryを使用して任意のエージェントコードを計装し、テレメトリをDataRobotにルーティングします。 |