権限・承認・上限
権限・承認・使用上限で作業が止まったときに使います。
スキルのバージョン: 1.0.0。資料: skill://nadoobio-account-and-approval/SKILL.md。
顧客データを読む前に get_connection_context で接続中のアカウント・組織・スコープを確認します。公開一覧の取得は認証の証拠ではありません。legacyUnscoped は旧式のロール権限で、この照会はプロジェクトへのアクセスや実行を承認しません。Web リンクではブラウザーの現在のアカウントで再認可します。アカウントや組織が違う場合は Web で切り替え、同じ URL を開き直します。
| エラー | 意味 | 利用者への案内 |
|---|---|---|
authentication_required | 有効な認証を確認できません。 | Nadoo Bio で API キーを発行・設定するよう案内します。 |
scope_required (required) | キーに必要なスコープがありません。 | 必要なスコープ(catalog:read、jobs:read、plans:write、jobs:submit、files:write)を案内します。 |
agent_execution_disabled | 管理者設定で AI エージェント(API キー)による計画作成・提出が無効です。キーやプロジェクト権限の問題ではありません。 | 同じ要求を繰り返しません。研究者が画面で計画を作るか、管理者に「AI エージェントの実行許可」を依頼するよう案内します。照会ツールは引き続き使います。 |
not_found / plan_unavailable | 存在しないか、閲覧権限がありません。 | この2つを区別しない応答は正常です。識別子とプロジェクトの確認を案内し、別の識別子を推測して試しません。 |
plan_not_approved | 人による承認がないか、期限切れです。 | 承認リンクを渡し、応答の承認方針を確認します。API キーで作った単一計画の承認待ちには期限がありませんが、承認後15分以内に明示的に提出する必要があります。承認だけではエージェントは再開せず、ジョブも提出されません。 |
| 実行選択肢に目的のツールがありません。 | 一覧にないことだけでは原因は分かりません。 | reason・reasonText・workflowSupport と supportDocPath の文書を確認し、今できる入力準備・検証を案内します。 |
runtime_consumer_unavailable | プラットフォームに対応する実行機能がありません(fixableBy: platform)。 | 権限やキーの問題ではないことを伝え、次の手順として入力準備・検証を案内します。 |
release_unavailable | この組織に公開されたリリースがありません(fixableBy: organization-operator)。組織単位のため、同じ組織のプロジェクトでは結果が共通です。 | reasonText をそのまま伝え、入力準備・検証と、組織の運用権限者へのリリース公開依頼を案内します。 |
session_submission_required | 現在の Web セッションで作成した計画のみ提出できます。 | 実際にこの理由が返された場合だけ Web で新しい計画を作る手順を案内します。API キー計画の承認やスコープ追加では解決しません。 |
monthly_limit_exceeded | 月間ジョブ件数の上限に達しています。 | used・limit・remaining と応答の recoveryBoundary.submissionDeadline(この計画の提出期限)を伝えて停止します。料金ではなくジョブ件数の上限で、回復時刻は未確認です。期限後はこの計画を提出できず、rerun_plan で新しい計画と承認が必要です。期限内に上限が調整された場合だけ提出できると案内し、残り時間を計算せず期限時刻をそのまま伝えます。 |
context_changed | 選択中の組織が変わりました。 | 製品画面で元の組織に戻るよう案内します。 |
守ること
- 承認・権限の制約は返された理由をそのまま伝え、同じキー・プロジェクトと利用者本人の計画で進めます。
- API キー・Cookie・トークンを会話やファイルに書きません。
- 製品リンク(
create_view_link)は権限を再確認してから生成されます。ダウンロード資格情報を含む URL を作成・要求しません。
候補入力リンクと現在の権限
list_candidate_inputs は jobs:read で本人の記録を読み、準備・計画の保存権限を付与しません。一覧・個別リンクはログイン後に同じ URL に戻り、ブラウザーの現在のアカウント・組織・プロジェクト権限を再確認します。API キー認証と Web ログインは別で、キーや Cookie を URL に含めません。
個別リンクの snapshotId・payloadHash を保持します。ハッシュ衝突や権限エラーでハッシュを消したり最新入力に差し替えたりしません。sourceStatus=unavailable は記録の現在の出典を利用できない状態で、再ログインだけで解決すると約束しません。候補入力の web-session-required は Web で準備計画を保存するための案内です。準備計画の提出制限はキーの再発行や承認では解除できません。
有料実行の委任に使うログインとキー
委任文書の Web リンクはブラウザーログインで確認し、MCP 提出には文書で指定した API キーを使います。Web ログイン成功はキー設定や元の承認セッションの復元を意味しません。別セッションで履歴を見られても、新しい委任同意・提出要求は作れない場合があります。元の承認セッションの失効・撤回・コンテキスト変更が再ログインだけで直るとは約束しません。
submit_delegated_plan の受付記録を受け取った後に get_job が scope_required を返した場合、jobs:read の不足と提出失敗を区別します。元の受付・要求キーを保持し、返されたジョブリンクを案内します。委任を再利用するためにキーを交換しません。agent_delegation_runtime_not_connected はそのモデルの委任実行が未接続という意味で、スコープ追加や再ログインでは解決しません。