다른 언어: English, Español, Português, 日本語, Deutsch, Français, 简体中文, Italiano, हिन्दी · 한국어 가이드 전체
공개: 저희는 100monkeys.ai에서 Carbon Forge를 만들고 있으므로 이 글은 만든 쪽의 설명으로 읽어 주세요. 이 가이드는 저희 AI 에이전트 하나가 공개 문서(영어), 주로 MCP token scopes (R#62460), MCP tokens (R#61824), Tokens 카탈로그 페이지(R#62188)를 바탕으로 초안을 쓰고 회사가 검토했으며, 이 한국어판은 영어 원문 가이드의 번역입니다. 프리셋 이름, 인수, 인용한 문장은 문서 그대로입니다. 문서에 완성된 발급 호출 예시가 없으므로 예시 대신 인수 목록을 실었습니다. 인용은 영어로 두고 옆에 번역을 붙였습니다. 문서가 답하지 않는 질문은 마지막 절에서 밝힙니다.
모든 토큰에 걸린 두 가지 한도
토큰에는 역할 상한(viewer, editor, admin)과 도구 범위, 곧 "the explicit set of MCP tools the bearer is allowed to call."(소지자가 호출할 수 있는 MCP 도구의 명시적 집합)이 있습니다. 역할 상한은 권한의 위쪽 경계이고, 범위는 그것을 더 좁힙니다. 문서의 예시로, admin 토큰에 SCM reader 범위를 걸면 viewer 토큰에 같은 범위를 건 것과 같은 도구 카탈로그가 돌아옵니다.
1단계. 에이전트가 할 일 정하기
양식을 열기 전에 에이전트의 일을 한 줄로 적으세요. 찾아서 추론하기, 메모하기, 코드 읽기, 레인에서 빌드하기, 릴리스하기 중 무엇인지요. 각각이 아래 프리셋 하나에 대응합니다. 문서의 규칙은 이렇습니다. "Default to the narrowest preset that still covers what the client needs."(클라이언트에 필요한 것을 여전히 담는 가장 좁은 프리셋을 기본으로 하세요.)
2단계. 역할 상한 정하기
설정을 열고 API tokens를 고른 뒤 워크스페이스와 역할 상한을 고르세요. SCM 프리셋은 짝이 되는 역할을 밝힙니다. SCM reader는 viewer, SCM agent와 SCM release는 editor입니다.
3단계. 가장 좁은 프리셋 고르기
문서가 밝힌 도구 수와 함께 본 프리셋입니다(모두 cortex.ground를 포함합니다).
- Read-only memory(
read_only_memory, 14): 페이지와 아톰 읽기, 검색, 교차 링크 따라가기. 쓰기 없음. - Basic LLM memory(
basic_memory, 30): 페이지, 아톰, 태그 읽기와 쓰기, 검색. - Knowledge-graph reader(
knowledge_graph_reader, 31): 모든 콘텐츠 면과 그래프. 쓰기 없음. - SCM reader(
scm_reader, 58): 코드 트리, 레인, changeset, cut, 파일 트리와 함께 페이지와 검색. 쓰기 없음. - SCM agent(
scm_agent, 104): SCM 읽기에 더해 페이지, 아톰, 레인, 트리 쓰기, 레인 랜딩, cut, 렌더링. - SCM release(
scm_release, 67): SCM 읽기에 더해 레인 랜딩과 승인, cut, 아카이브 푸시, 사이트 게시. - Full access(
full, 177): 역할 상한 안의 모든 도구.
레인에서 빌드하는 코딩 에이전트는 SCM agent, 승인하는 리뷰어는 SCM release, 리서치 에이전트는 reader를 받습니다. 문서는 Full access를 "trusted with anything the role can do"(역할이 할 수 있는 모든 것을 맡길 수 있는) 클라이언트를 위해 남겨 둡니다.
4단계. 도구 하나가 더 필요하면 Custom 쓰기
프리셋에 도구 하나가 모자라면 Custom을 고르고 묶음으로 정리된 선택기에서 도구를 고르세요. 문서의 예시는 "that should be able to create comments but not pages"(댓글은 만들 수 있지만 페이지는 만들 수 없어야 하는) 게시 에이전트입니다. 범위는 도구 목록, /api/mcp/manifest의 매니페스트, 그리고 모든 호출에 적용됩니다. 범위 밖의 도구는 Unknown tool: <name>으로 답하며, "exactly as a tool that does not exist"(존재하지 않는 도구와 똑같이) 답하므로 클라이언트는 토큰에 무엇이 없는지 알 수 없습니다.
5단계. 토큰을 발급하고 비밀 값 보관하기
토큰에는 그것을 가질 에이전트나 환경의 이름을 붙이고, 비밀 값을 복사하세요. "it is shown once, then only the prefix."(한 번만 보여 주고 그 뒤로는 접두사만 보여 줍니다.) 토큰마다 현재 워크스페이스를 따로 가지므로, 서로 다른 토큰을 쓰는 두 에이전트는 서로의 포인터를 움직이지 않습니다.
6단계. 실행 토큰은 오케스트레이터에만 허용하기
실행 토큰은 "a short-lived child of one of your tokens, minted for a single AEGIS run"(AEGIS 실행 한 번을 위해 발급되는, 여러분 토큰 중 하나의 수명 짧은 자식)이며, 여기서 AEGIS by 100monkeys.ai, in beta는 에이전트를 실행하는 오케스트레이터입니다. 토큰은 소유자가 토큰 양식에서 May mint execution tokens를 체크해야만 자식을 발급할 수 있습니다. 기본값은 꺼짐이고, 어떤 프리셋도 이것을 켜지 않으며, 문서는 "leave it off unless an orchestrator holds the token."(오케스트레이터가 토큰을 가진 경우가 아니면 꺼 두세요.)이라고 합니다. 발급 도구는 full 프리셋에만 있습니다.
7단계. 실행 한 번을 위한 자식 토큰 발급하기
부모는 다음 인수로 tokens.mint_execution을 호출합니다.
execution_id, instance_id, workspace_id, tree_path, lane_label, tools, role_cap, lifetime_seconds, workflow인스턴스 하나, 워크스페이스 하나, 트리 경로 하나, 레인 레이블 하나, 부모가 가진 도구 1~166개, 부모와 같거나 viewer인 역할 상한, 그리고 최대 86,400초이면서 부모의 만료를 넘지 않는 수명입니다. workflow는 선택 사항으로, 실행이 수행하는 랜딩 규칙 게이트의 이름입니다. 응답은 다음과 같습니다.
{ token_id, parent_token_id, execution_id, instance_id, workspace_id, tree_path, lane_label, workflow, role_cap, tools, expires_at, secret }범위를 넓히려는 요청은 한 문장으로 거부되고 아무것도 발급되지 않습니다. 자식의 모든 쓰기는 자기 레인을 지정하고 자기 경로 아래에 머물러야 합니다. 레인 forge/run-1과 경로 apps/web에 대한 문서의 거부 메시지입니다.
This execution token writes only to lane "forge/run-1", not to the trunk.
This execution token writes only under "apps/web", not to "apps/api/x.ts".자식은 결코 두 번째 신원이 아닙니다. 자식이 만든 모든 변경은 여러분을 행위자로, 그리고 그것이 발급된 실행을 함께 기록합니다.
8단계. 취소하고 감사 로그 읽기
자식은 tokens.revoke_execution으로 스스로를 취소하거나 부모가 취소합니다. 취소한 서버에서는 즉시, 다른 모든 곳에서는 30초 안에 인증이 멈춥니다. 부모를 취소하거나 부모의 범위를 바꾸면 모든 자식이 취소됩니다. 모든 도구 호출은 토큰 신원으로 감사 로그에 남고, 발급과 취소마다 부모, 자식, 실행을 밝힌 감사 행이 기록됩니다.
보호된 트렁크에서 실행의 승인이 효력을 갖게 하려면 가이드 랜딩 규칙: 기록 안에 두는 코드 오너, 그리고 게이트가 되는 AEGIS 워크플로를 읽으세요.
문서가 답하지 않는 것
- 완성된 예시. 카탈로그는 발급의 인수와 응답을 나열하지만 예시 호출은 보여 주지 않습니다.
- 도구 상한. 자식은 도구 1~166개를 받는데
full프리셋에는 177개가 있습니다. 자식에게 넘길 수 없는 도구가 무엇인지는 나와 있지 않습니다. - 오케스트레이터가 부모 토큰을 받는 방법. 문서는 오케스트레이터가 토큰을 가질 때만 발급을 허용하라고 하지만, AEGIS가 그 토큰을 어떻게 받는지는 말하지 않습니다.
- 프리셋 목록이 있는 곳. 개수는 나오지만 프리셋별 도구 이름은 양식의 선택기에만 있습니다.