참조AI 스킬권한·승인·한도

권한·승인·한도

나두바이오에서 권한·승인·사용 한도 때문에 막혔을 때 사용한다.

스킬 버전: 1.0.0. 자료: skill://nadoobio-account-and-approval/SKILL.md.

고객 자료 조회 전에 get_connection_context로 연결 계정·조직·스코프를 확인한다. 공개 목록 조회는 인증 증거가 아니다. legacyUnscoped는 구형 역할 권한이며, 이 조회는 프로젝트 접근이나 실행을 승인하지 않는다. 웹 링크는 브라우저의 현재 계정으로 재인가한다. 다른 계정·조직이면 웹에서 전환하고 같은 주소를 다시 연다.

오류뜻사용자에게
authentication_required유효한 인증이 확인되지 않았다나두바이오에서 API 키를 발급해 설정하도록 안내한다.
scope_required (required)키에 그 작업 스코프가 없다필요한 스코프(catalog:read, jobs:read, plans:write, jobs:submit, files:write)를 알린다.
agent_execution_disabled이 서비스에서 AI 에이전트(API 키)의 계획 생성·제출이 꺼져 있다(플랫폼 관리자 설정). 키나 프로젝트 권한 문제가 아니다같은 요청을 반복하지 않는다. 연구자가 화면에서 직접 계획을 만들거나, 플랫폼 관리자에게 "AI 에이전트 실행 허용"을 요청하도록 안내한다. 조회 도구는 계속 쓴다.
not_found / plan_unavailable없거나 볼 권한이 없다둘을 구분하지 않는 것이 정상이다. 식별자와 프로젝트를 확인하게 한다. 다른 식별자를 추측해 시도하지 않는다.
plan_not_approved사람 승인이 없거나 만료됐다승인 링크를 전달한다. 응답의 승인 정책을 확인한다. API 키 단건 계획의 승인 대기는 만료되지 않지만 승인 뒤15분 안에 명시적으로 제출해야 한다. 승인만으로 에이전트가 재개되거나 작업이 제출되지 않는다.
실행 옵션에 원하는 도구가 없음원인은 목록 부재만으로 알 수 없다reason·reasonText·workflowSupport와 supportDocPath의 문서를 확인하고, 지금 할 수 있는 입력 준비·검증으로 안내한다.
runtime_consumer_unavailable플랫폼에 해당 실행기가 없다(fixableBy: platform)권한이나 키 문제가 아니라고 전하고, 입력 준비·검증을 다음 단계로 안내한다.
release_unavailable이 조직에 게시 릴리스가 없다(fixableBy: organization-operator). 조직 단위라 같은 조직의 프로젝트는 모두 같다reasonText를 그대로 전하고, 다음 단계는 두 가지로 안내한다: 입력 준비·검증, 그리고 조직 운영 관리 권한자에게 릴리스 게시 요청.
session_submission_required현재 웹 세션에서 작성한 계획만 제출 가능이 사유가 실제 반환된 경우에만 웹의 새 계획 작성 경로를 안내한다. API 키 계획 승인·스코프 추가로 해결되지 않는다.
monthly_limit_exceeded월 작업 건수 한도 소진used·limit·remaining과 응답의 recoveryBoundary.submissionDeadline(이 계획의 제출 기한)을 알리고 멈춘다. 금액 과금이 아니라 작업 건수 한도다. 한도 회복 시점은 확인되지 않는다. 기한이 지나면 이 계획은 제출할 수 없으므로 rerun_plan으로 새 계획과 새 승인이 필요하다. 이 계획은 제출 기한 안에 한도가 조정될 때만 제출할 수 있다고 안내하고, 남은 시간을 계산하지 말고 기한 시각을 그대로 전한다.
context_changed선택한 조직이 바뀌었다제품 화면에서 원래 조직으로 돌아오게 한다.

지키는 것

  • 승인·권한 제약은 받은 사유를 그대로 사용자에게 알리고, 같은 키·같은 프로젝트·사용자 본인의 계획으로 진행한다.
  • API 키, 쿠키, 토큰을 대화나 파일에 적지 않는다.
  • 제품 링크(create_view_link)는 권한을 다시 확인한 뒤 만들어진다. 다운로드 자격 URL을 만들거나 요구하지 않는다.

후보 입력 링크와 현재 권한

list_candidate_inputs는 jobs:read로 본인 기록을 읽으며 준비·계획 저장 권한을 부여하지 않는다. 반환된 목록/개별 링크는 로그인 후 같은 주소로 돌아오고 브라우저의 현재 계정·조직·프로젝트 권한을 다시 검사한다. API 키 인증과 웹 로그인은 별개이며 키·쿠키를 URL에 넣지 않는다.

개별 링크의 snapshotId·payloadHash를 보존한다. 해시 충돌이나 권한 오류에서 해시를 지우거나 최신 입력 링크로 바꾸지 않는다. sourceStatus=unavailable은 해당 기록의 현재 출처를 사용할 수 없는 상태이므로 단순 재로그인으로 해결된다고 약속하지 않는다. 후보 입력의 web-session-required는 웹에서 준비 계획을 저장하라는 경계이며, 준비 계획의 제출 차단은 API 키 재발급이나 승인으로 해결되지 않는다.

유료 위임의 로그인과 키

위임 문서의 웹 링크는 브라우저 로그인으로 검토하며, MCP 제출은 문서에 지정된 API 키로 수행한다. 웹 로그인 성공이 API 키 설정이나 원 승인 세션 복구를 뜻하지 않는다. 다른 세션에서 이력을 볼 수 있어도 새 위임 동의·제출 요청 생성은 허용되지 않을 수 있다. 원 승인 세션의 만료·철회나 context 변경은 재로그인만으로 복구된다고 약속하지 않는다.

submit_delegated_plan의 접수 영수증을 받은 뒤 get_job이 scope_required를 반환하면 jobs:read 부족과 접수 실패를 구분한다. 원 접수·요청 키를 보존하고 반환된 작업 링크로 안내한다. 키를 교체해 위임을 재사용하지 않는다. agent_delegation_runtime_not_connected는 해당 모델의 위임 실행 연결이 없다는 뜻이며 스코프 추가·재로그인으로 해결되지 않는다.

이 페이지의 내용