リファレンスAI スキル権限・承認・上限

権限・承認・上限

権限・承認・使用上限で作業が止まったときに使います。

スキルのバージョン: 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 はそのモデルの委任実行が未接続という意味で、スコープ追加や再ログインでは解決しません。

このページの内容