本文へ移動
ModAsteraドキュメント
English
サーバー側連携

ヘッドレスワークフローと API リファレンス

信頼できるサーバーまたはローカルのエージェントクライアントから、データセット作成、パイプラインの学習・評価、モデルのデプロイ、結果取得を行います。

連携方法を選ぶ

REST

直接 API

バックエンドサービスから API キー認証付き HTTP リクエストを使用します。本番連携の安定した選択肢です。

MCP

ローカルエージェントツール

信頼できるローカル stdio アダプターで、データセット、パイプライン、結果、デプロイ操作をエージェントから実行します。

REST の基本フロー

  1. アカウントと API キーを作成する

    プラットフォームでアカウント、組織、キー設定を完了します。生のキーは一度だけコピーし、シークレット管理に保存します。

  2. 認証を確認する

    Authorization: Api-Key <raw_api_key> を付けて /datasets/datasets/ を呼び出します。

  3. データセットを作成・確認する

    データセットを作成し、サンプルをアップロードまたはインポートして、ラベル、アノテーション、分割件数を確認します。

  4. タスククエリを作成・実行する

    データセットを選択し、パイプラインを計画してタスク実行を開始します。永続状態は REST でポーリングし、WebSocket は任意のライブ更新として使用します。

  5. モデルバージョンをデプロイする

    完了済みバージョンとチェックポイントを選び、デプロイを作成して Predictor、利用状況、成果物を確認します。

ヘッドレス手順を進める

安全な認証から開始し、データ、モデル、提供、成果物、エージェントの順に進みます。各ガイドから正規の本番リファレンスを参照できます。

  1. 01クイックスタートと認証運用 API キーを作成・安全に確認し、最初のサーバー側リクエストを送信します。
  2. 02データセットとアノテーションデータセット作成、サンプル取り込み、アノテーション読込、準備確認、分割維持を行います。
  3. 03パイプライン、学習、結果パイプラインを計画・実行し、永続状態、チェックポイント復旧、完了結果を扱います。
  4. 04デプロイメントと予測対象モデルバージョンをデプロイし、Predictor、利用状況、結果メディアを扱います。
  5. 05ファイル、成果物、エラー保護出力を正しく取得し、API ごとのエラーを安全に処理します。
  6. 06ローカル MCP アダプター信頼できるローカル stdio アダプターを設定し、信頼境界を広げず本番連携ツールを使用します。
  7. 07REST・MCP リファレンス本番と照合したエンドポイント・ツールカード、対象範囲、バージョン履歴を使用します。

プラットフォームのデプロイガイドに戻る