OPEN-SOURCE DECISION AI　/　API Docs

APIドキュメント Preview / MOCK

Overview

Layaは、文章に対して用意した質問ごとに選択肢・段階・Yes / No の推定確率を返す意思決定モデルです。文章の生成や要約は行いません。

Preview / MOCK　公開APIのURLは準備中です。下記のURLは開発環境の例です。

リクエストとレスポンスの要点

{
  "model": "multilingual",
  "state": {
    "body": "先月分の利用料が二重に引き落とされています。本日中に確認をお願いします。"
  },
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "この問い合わせを担当すべき部署を選んでください。",
      "criteria": {
        "billing": "請求、支払い、返金に関する問い合わせ",
        "technical": "不具合、障害、操作方法に関する問い合わせ",
        "other": "上記以外の問い合わせ"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "対応の緊急度を評価してください。",
      "criteria": ["通常の対応でよい", "早めの対応が必要", "至急の対応が必要"]
    },
    "churn_risk": {
      "type": "noul",
      "instructions": "利用者は解約を検討していますか？"
    }
  }
}

質問IDごとの結果は answers に入ります。確率は正答率ではなく、業務で用いる閾値は実データで評価して決めてください。

Quickstart

APIキーを環境変数に設定し、JSONを送信します。

curl -sS "$LAYA_API_URL/v1/systemone" \
  -H "Authorization: Bearer $LAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

認証

サインアップ後、メールアドレスを確認して Dashboard から API キーを発行します。有効にできるキーは1本で、生の値は発行時に一度だけ表示されます。

Authorization: Bearer <API_KEY>
Content-Type: application/json

APIキーの扱い　キーはサーバー側の環境変数で管理し、ブラウザ・ログ・リポジトリーに含めないでください。失効すると同じキーは直ちに使えなくなります。

リクエスト

フィールド	型	必須	説明
model	string	任意	auto / english / multilingual / typed-decisions
state.body	string	必須	判定対象の文章
questions	object	必須	質問IDをキーとした質問定義

Choice

用意した選択肢から当てはまるものを選ばせます。

{ "type": "choice", "instructions": "担当部署を選んでください", "criteria": { "billing": "請求・支払い", "technical": "不具合" } }

Score

段階の説明を低い順に並べます。scoreは段階番号の期待値です。

{ "type": "score", "instructions": "緊急度を評価してください", "criteria": ["通常", "早め", "至急"] }

Yes / No (noul)

Yesに相当する推定確率 P(true) を返します。criteriaは不要です。

{ "type": "noul", "instructions": "解約を検討していますか？" }

レスポンス

{
  "answers": {
    "department": { "type": "choice", "choice": "billing", "probabilities": { "billing": 0.91, "technical": 0.05, "other": 0.04 } },
    "urgency": { "type": "score", "score": 1.72, "probabilities": { "0": 0.06, "1": 0.16, "2": 0.78 } },
    "churn_risk": { "type": "noul", "noul": 0.87 }
  }
}

ステータス	意味
200	推論成功
401	認証失敗
413	入力サイズ超過
422	入力不正
502	推論失敗

エラー

エラー時は { "error": { "code": "...", "message": "..." } } の形式で返ります。429や503はリトライ可能な一時的な障害として扱ってください。

利用上の注意

返り値は推定確率であり、判断の正しさを保証するものではありません。機密情報や個人情報を送信する場合は取り扱い条件を個別にご確認ください。

APIの利用を相談