팀을 위한 Pokee AI 에이전트: 장기 실행 작업 할당부터 검토까지

Pokee AI 에이전트는 지정된 범위의 파일, 스킬, 메모리를 갖춘 영구 샌드박스에서 90분 단위 턴으로 실행됩니다. 팀이 이러한 작업을 할당하고 추적하며 검토하는 방법을 소개합니다.

Aiden Flux

Aiden Flux

5 11월 2026

팀을 위한 Pokee AI 에이전트: 장기 실행 작업 할당부터 검토까지

요약: Pokee AI 에이전트는 Pokee Enterprise API를 통해 실행됩니다. 각 테넌트는 격리된 영구 샌드박스를 제공받아, 에이전트가 범위가 지정된 파일 접근 권한, 업로드된 스킬, .pokee/ 페르소나 파일, 세션 간 유지되는 메모리를 활용하여 1턴당 최대 90분 동안 작업을 수행할 수 있습니다. API는 에이전트를 구동할 뿐입니다. 팀에서는 여전히 작업을 할당하고, 진행 상황을 모니터링하며, 최종 배포 전에 결과물을 검토할 수 있는 공간이 필요합니다.

Pokee는 일반적인 채팅창으로는 감당하기 어려운 작업, 예를 들어 10페이지 분량의 시장 보고서 작성이나 1시간 가까이 소요되는 리서치 등을 위해 개발되었습니다. 90분 동안 진행되는 턴을 계속 지켜보고 있을 사람은 없으므로, 누군가 책임을 맡아 진행 상황을 확인하고 완료 여부를 판단해야 합니다. 이미 코딩 에이전트를 한곳의 보드에서 관리하고 있다면, Sharkly가 바로 이러한 작업을 진행할 최적의 공간입니다. 자세한 내용은 아래에서 다룹니다.

Pokee AI란 무엇인가요?

Pokee는 에이전트 플랫폼으로, Enterprise API는 “격리된 영구 샌드박스에서 장시간 실행되는 에이전트 기반 워크플로를 수행하기 위한 REST API”입니다. 각 테넌트는 독립된 작업 공간과 Bearer 토큰, 그리고 https://your-tenant.enterprise.pokee.ai와 같은 주소에서 세션, 파일, 스킬, 스트리밍 메시지를 처리하는 엔드포인트를 제공받습니다. 엔터프라이즈 전용으로 제공되므로 Pokee 공식 문서에서는 신규 고객에게 “데모 요청(Request demo)”을 안내하고 있으며, 셀프서브나 무료 플랜에 대한 설명은 없습니다.

모델 및 요금 안내 페이지에는 두 가지 모델 등급이 나와 있습니다.

모델 입력 ($/M 토큰) 출력 ($/M 토큰) 캐시 읽기 ($/M 토큰)
pokee-isaac-high-reasoning $3 $15 $0.30
pokee-isaac $0.30 $5 $0.10

신규 테넌트는 기본적으로 high-reasoning 등급으로 설정됩니다. 모델은 세션을 생성할 때 고정되므로, 해당 세션의 모든 턴은 동일한 등급으로 실행됩니다.

Pokee 에이전트 모델: 세션, 샌드박스, 파일, 스킬, 메모리

Pokee의 에이전트 모델은 직접 설정할 수 있는 5가지 요소로 구성되며, 각 요소는 팀 차원의 의사결정과 연결됩니다.

  1. 세션(Sessions): 세션은 전용 Pod 내 독립된 샌드박스에서 실행되는 개별 에이전트 프로세스로, 고유한 히스토리, 파일 범위, 비지(busy) 상태를 가집니다.
  2. 영구 모드(Persistent mode): 기본 세션은 마지막 응답 후 5분이 지나면 자동으로 파기됩니다. persistent: true로 설정하면 TTL(기본 4시간)이 만료되거나 직접 삭제할 때까지 유지됩니다.
  3. 범위 지정 파일 접근(Scoped file access): 세션 생성 시 read 및 write 경로를 전달합니다. 지정된 범위를 벗어난 경로는 에이전트의 파일 시스템 내에 아예 존재하지 않습니다.
  4. 스킬(Skills): 루트에 SKILL.md가 포함된 zip 파일을 업로드합니다. 테넌트 내의 모든 신규 세션에서 이를 참조할 수 있습니다.
  5. 페르소나 파일 및 메모리(Persona files and memory): .pokee/ 디렉터리의 마크다운 파일은 시스템 프롬프트 맨 앞에 추가되며, .memory/MEMORY.md는 여러 세션에 걸쳐 컨텍스트를 유지해 줍니다.

Pokee는 파일 접근 범위를 어떻게 제한하나요?

접근 범위는 이중으로 엄격하게 제한됩니다. 에이전트 내부에서는 세션별 bubblewrap 마운트 네임스페이스를 통해 허용된 경로 외의 모든 항목을 숨기므로, 읽기를 시도하면 ENOENT 오류가 반환됩니다. HTTP 파일 API를 통해 동일한 요청을 보낼 경우에는 403 Forbidden 오류가 반환됩니다.

범위 지정 파일 접근 쿡북에서는 특정 고객사의 폴더와 공용 템플릿 폴더만 읽을 수 있고, 해당 고객사의 출력 폴더에만 쓸 수 있는 세션 예시를 보여줍니다.

curl -X POST "$POKEE_API/v1/sessions" \
  -H "Authorization: Bearer $POKEE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persistent": true,
    "ttl": 14400,
    "metadata": {"board_task": "COIN-412", "client": "acme-corp"},
    "file_access": {
      "read": ["projects/acme-corp", "shared/templates"],
      "write": ["projects/acme-corp/output"]
    }
  }'

접근 범위는 세션이 유지되는 동안 변경할 수 없습니다. 범위를 확장하려면 기존 세션을 삭제하고 새 세션을 생성해야 합니다. 이는 컴플라이언스 준수에 도움이 되며, 작업 도중이 아니라 작업을 할당할 때 미리 범위를 명확히 정의하도록 만듭니다.

.pokee/ 페르소나 파일과 메모리는 어떤 역할을 하나요?

workspace/.pokee/*.md에 있는 파일들은 알파벳 순서대로 시스템 프롬프트에 로드되며, 각각 ## <filename> 헤더 아래에 배치됩니다. 페르소나 쿡북에서는 톤앤매너를 위해 00_soul.md를, 도메인 용어를 위해 10_glossary.md를, 포맷팅을 위해 20_style_guide.md를 사용합니다. 해당 디렉터리의 전체 용량 제한은 1MB입니다.

수정 사항은 다음 세션부터 적용되며, 이미 실행 중인 세션은 기존 프롬프트를 유지합니다. 또한 에이전트는 세션마다 .memory/MEMORY.md를 읽고 업데이트하는데, 이 파일은 파일 API를 통해 직접 수정할 수 있으며 에이전트 컨텍스트 페이지의 설명대로 Pokee 측에 비활성화를 요청할 수도 있습니다.

장시간 실행되는 AI 에이전트가 팀에 미치는 영향

장시간 실행되는 AI 에이전트는 팀의 업무 방식에서 세 가지를 변화시킵니다. 바로 누가 작업을 시작하는지, 진행 상황을 어떻게 파악하는지, 그리고 최종 승인을 누가 하는지입니다. Pokee의 기본 제한 사항을 살펴보면 이러한 점이 더욱 명확해집니다.

제한 항목 기본값
동시 세션 수 10
턴 타임아웃 90분
세션 TTL 4시간
시간당 / 일일 턴 수 300 / 5,000
시간당 / 일일 토큰 수 20M / 200M
최대 워크스페이스 크기 100 GB

Pokee에 따르면 요청 시 이 제한값들을 모두 상향 조정할 수 있습니다.

90분짜리 에이전트 작업은 누가 할당하나요?

동시 세션 10개는 여유로워 보이지만, 월요일 아침에 5명이 각각 보고서 생성을 2개씩 실행하면 금세 한도에 도달합니다. 또한 비지(busy) 상태인 세션에 두 번째 메시지를 보내면 409 오류로 거부됩니다. 따라서 담당자를 지정하여 태스크를 정의하고, 모델 등급, 파일 접근 범위, 세션을 명시해 두어야 두 사람이 동일한 90분짜리 작업을 중복으로 실행하는 일을 방지할 수 있습니다.

오래 걸리는 에이전트 턴의 진행 상황은 어떻게 확인하나요?

클라이언트 연결이 끊어져도 에이전트는 계속 실행됩니다. 장시간 실행 작업 쿡북에서는 15초마다 GET /v1/sessions/{id}를 폴링하여 busy 플래그를 확인하고, 워크플로가 metadata에 기록하는 진행 상태 키를 읽은 뒤 최종 출력 파일을 다운로드하는 방식을 안내합니다.

while True:
    s = c.get(f"/v1/sessions/{sid}").json()
    if not s["busy"]:
        break
    print(f"metadata: {s['metadata']}")
    time.sleep(15)

스트림 자체는 Server-Sent Events(SSE)를 사용하며, message.created, message.completed, message.error, message.cancelled 이벤트가 발생합니다. 재개(resume) 엔드포인트는 Last-Event-ID를 기반으로 토큰을 중복 과금하지 않고 끊어진 스트림을 다시 연결합니다. 하지만 이는 스크립트에게 턴이 완료되었음을 알려줄 뿐, 작성된 보고서의 품질이 우수한지까지 알려주지는 못합니다.

최종 배포 전 결과물 검토는 누가 하나요?

Pokee는 워크스페이스에 파일을 생성합니다. 결과물 검토는 API 외부에서 사람이 직접 수행해야 하는 단계입니다. 누군가 report.md를 열어 요구사항에 맞게 작성되었는지 확인하고, 승인하거나 반려해야 합니다. 병렬 에이전트 작업에서는 주로 이 검토 단계가 병목이 되며, 이는 사람의 검토가 병목이 되는 이유에서 다루는 핵심 논점이기도 합니다.

보드에 할당되고, 범위가 지정된 파일로 세션이 생성되며, 샌드박스에서 90분간 턴이 실행되고, 출력 파일이 작성된 후 배포 전 사람이 검토하는 장시간 실행 Pokee 에이전트 작업의 수명 주기.

실전 예시: 고객사 보고서 할당부터 검토까지

3명이 하나의 Pokee 테넌트를 공유하고 있으며, 결과물은 “Acme Corp”을 위한 분기별 시장 보고서인 상황을 가정해 보겠습니다.

  1. 할당: Dana가 태스크를 등록합니다. 태스크명은 “Acme 3분기 시장 보고서”, 담당자 Dana, 검토자 Sam, 마감일은 목요일입니다.
  2. 범위 지정: 태스크에 사용할 Pokee 모델(pokee-isaac-high-reasoning), 읽기 경로(projects/acme-corp, shared/templates), 쓰기 경로(projects/acme-corp/output)를 명시합니다.
  3. 시작: Dana가 metadata에 태스크 ID를 포함하여 영구 세션을 생성한 후, output/report.md에 보고서를 작성하도록 요청하는 메시지를 1회 전송합니다.
  4. 추적: 세션 ID를 태스크 댓글에 남깁니다. GET /v1/sessions/{id}를 폴링하면 턴이 완료될 때까지 busy: true가 반환됩니다.
  5. 수거: busy가 false로 바뀌면 Dana가 결과 파일을 다운로드하여 태스크에 첨부합니다.
  6. 검토: Sam이 요구사항에 맞는지 검토합니다. 미흡한 부분이 있으면 피드백 코멘트와 함께 새 턴을 실행하고, 통과하면 다음 단계로 넘깁니다.
  7. 정리: Dana가 세션을 직접 삭제하거나, 매일 밤 실행되는 DELETE /v1/sessions?status=idle&older_than=1h 정기 작업을 통해 일괄 정리합니다.

1단계, 4단계, 6단계는 API 호출이 아닙니다. 바로 팀 간 ‘조율(coordination)’ 과정입니다. 에이전트의 작업이 빠를 때는 쉽게 건너뛰었다가, 1시간씩 걸리는 작업이 되고 나서야 필요성을 뼈저리게 느끼게 되는 단계이기도 합니다.

Pokee 에이전트 워크플로에서 Sharkly의 역할

Sharkly는 에이전트 업무 관리 플랫폼입니다. 사람과 에이전트 모두에게 작업을 할당하고, 실행 상태를 추적하며, 결과물에 대한 사람의 검토를 대기시키는 단일 보드를 제공합니다. Sharkly가 Pokee 세션을 대신 실행해 주는 것은 아니며 전용 Pokee 커넥터가 있는 것도 아닙니다. 대신 작업, 담당자, 상태, 그리고 이를 둘러싼 검토 과정을 통합 관리해 줍니다.

실제 구현 방식은 다음과 같습니다.

  • 작업 할당: Pokee 작업은 다른 팀원들의 업무와 나란히 담당자(Assignee) 및 상태가 지정된 채 보드에 등록됩니다. 담당자를 명확히 지정해야 하는 이유는 에이전틱 팀 글을 참조하세요.
  • API를 구동하는 에이전트: Sharkly 에이전트는 Claude Code와 같은 런타임을 통해 사용자의 로컬 컴퓨터에서 실행됩니다. 앞서 살펴본 curl 호출을 래핑한 스킬을 부여하면, 에이전트가 직접 세션을 생성하고 폴링하며 세션 ID와 결과물을 태스크에 다시 등록할 수 있습니다.
  • Pokee에 맞춘 실행 제한: 각 에이전트에는 할당된 작업의 최대 동시 실행 수, 작업당 최대 실행 시간, 대기열 타임아웃 등의 실행 설정(Run settings)이 있습니다. 아래 이미지의 에이전트는 작업 1개, 40분으로 제한되어 있습니다. Pokee 작업을 진행할 때는 동시 실행 수를 보유한 세션 한도인 10개 이하로 유지하고, 실행 시간을 90분 턴을 감당할 수 있도록 설정하거나 에이전트가 턴을 시작한 뒤 나중에 다시 확인하도록 구성하면 됩니다.
Sharkly 에이전트의 실행 설정: 할당된 작업의 최대 동시 실행 수, 작업당 최대 실행 시간, 대기열 타임아웃.
  • 메시지가 아닌 ‘상태’로서의 검토: 에이전트가 태스크를 사람의 검토 대기 상태로 넘기면, 해당 태스크는 검토자의 받은편지함(Inbox)에 표시됩니다. 이러한 중단 지점을 어디에 배치해야 하는지는 인간 참여형(Human-in-the-loop) 코딩 에이전트 및 코딩 에이전트를 위한 승인 관문에서 다루고 있습니다.
  • 외부 트리거: Sharkly 자동화(Automation)는 웹훅 트리거를 지원합니다. 외부 서비스가 비밀 URL로 POST 요청을 보내면 실행이 시작되는 방식으로, Pokee 턴이 완료되었을 때 자체 스크립트로 이 URL을 호출할 수 있습니다.

Sharkly는 무료로 시작할 수 있으며, 모델 사용량은 기존에 결제 중인 계정에 그대로 청구됩니다. 장시간 실행 작업의 검토 패턴에 대한 자세한 내용은 100만 토큰 에이전트 실행에 검토 대기열이 필요한 이유를 참조하세요.

Pokee가 적합한 경우와 그렇지 않은 경우

코드 변경이 아닌 문서나 데이터셋을 생성하고, 수 분에서 1시간가량 실행되며, 영구 샌드박스가 필요한 작업에는 Pokee가 적합합니다. 파일 시스템 레벨에서 접근 범위가 강제되므로 “에이전트가 고객사 B의 데이터를 절대 열람해서는 안 된다”와 같은 계약 조항이 있는 경우 강력한 솔루션이 됩니다. 또한 Pokee의 오프라인 모드는 아웃바운드 경로를 모델 API로만 엄격히 제한한 테넌트를 제공합니다.

영업팀과의 상담 절차 없이 오늘 당장 시작해야 한다면 다른 대안을 찾아보는 것이 좋습니다. 자체 리포지토리 내부의 코딩 작업에는 로컬 컴퓨터에서 Claude Code나 Codex를 직접 구동하는 편이 훨씬 직관적입니다. 실제로 많은 팀이 두 방식을 병행하여 사용할 것이며, 이 모든 것을 아우르는 단일 보드가 필요한 이유가 바로 여기에 있습니다.

마치며

Pokee AI 에이전트는 팀에 완벽한 격리 환경과 장시간 작업 처리 능력을 제공합니다. API는 “턴이 완료되었는가?”에 대한 답을 줄 뿐입니다. 작업을 누가 시작했는지, 어떤 파일에 접근했는지, 그리고 결과물이 올바른지 판단하는 것은 여전히 팀의 몫입니다.

첫 번째 세션을 시작하기 전에 이 세 가지 답을 태스크에 미리 명시해 두세요. Pokee 실행과 코딩 에이전트를 한곳에서 함께 관리할 보드가 필요하다면, 지금 Sharkly 워크스페이스를 시작하고 이번 주 첫 장시간 작업을 에이전트에 할당해 보세요.

자주 묻는 질문 (FAQ)

Pokee Enterprise API란 무엇인가요?

Pokee Enterprise API는 테넌트별 전용 영구 샌드박스에서 장시간 실행되는 에이전트 워크플로를 구동하기 위한 REST API입니다. Bearer 토큰으로 인증하며, 세션, 파일, 스킬, 스트리밍 메시지, 사용량을 관리하는 엔드포인트를 제공합니다.

Pokee 에이전트는 얼마나 오래 실행될 수 있나요?

기본적으로 1턴당 최대 90분, 1세션당 최대 4시간까지 실행할 수 있으며, 요청 시 두 제한 모두 상향 조정할 수 있습니다.

Pokee AI는 무료인가요?

공식 문서에는 무료 플랜에 대한 안내가 없습니다. 데모 요청을 통해 도입할 수 있으며, 사용량은 토큰당 과금됩니다. 요금은 pokee-isaac-high-reasoning의 경우 100만 토큰당 입력 $3, 출력 $15이며, pokee-isaac의 경우 입력 $0.30, 출력 $5입니다.

두 사람이 동일한 Pokee 세션에 동시에 메시지를 보내면 어떻게 되나요?

두 번째 메시지는 세션이 다른 메시지를 처리 중(busy)이라는 의미의 409 오류를 받게 됩니다. 각 세션은 한 번에 하나의 턴만 처리하므로, 병렬 작업을 수행하려면 기본 최대 10개까지 별도의 세션을 생성해야 합니다.

Pokee 에이전트는 세션 간의 정보를 기억할 수 있나요?

네, 가능합니다. 에이전트는 세션마다 workspace/.memory/MEMORY.md를 읽고 업데이트하며, 이 파일은 Pod가 재시작되어도 유지됩니다.

Sharkly에서 Pokee 에이전트를 직접 실행할 수 있나요?

아니요, 불가능합니다. Sharkly에는 전용 Pokee 커넥터가 없습니다. 대신 사용자의 컴퓨터에서 실행되는 Sharkly 에이전트가 스킬을 통해 Pokee API를 호출할 수 있으며, Sharkly 태스크를 통해 할당, 진행 상태, 사람의 검토 과정을 관리합니다.

더 둘러보기

AI 에이전트 거버넌스: 샌드박스는 최종 승인이 아닙니다

AI 에이전트 거버넌스: 샌드박스는 최종 승인이 아닙니다

팀에서 운영하는 코딩 에이전트에 AI 에이전트 거버넌스가 필요하신가요? Codex와 Docker 샌드박스가 한도를 어떻게 설정하는지, 그리고 각 실행을 누가 책임지고 검토하는지 확인해 보세요.

20 11월 2026

오픈소스 Slack 대안: ExitPath로 Slack에서 떠나는 방법

오픈소스 Slack 대안: ExitPath로 Slack에서 떠나는 방법

오픈 소스 Slack 대안을 찾고 있나요? ExitPath가 Mattermost, Zulip, Element로 옮길 때 무엇을 고려해야 하는지, 그리고 에이전트 작업이 유실되지 않게 하는 방법을 확인해 보세요.

20 11월 2026

GPT-6.2 Astra vs Fable 5.2: 내 리포지토리에서 직접 테스트해보세요

GPT-6.2 Astra vs Fable 5.2: 내 리포지토리에서 직접 테스트해보세요

GPT-6.2 Astra vs Fable 5.2: 코딩 에이전트를 어느 모델에 맡겨야 할까? 같은 가격의 토큰이 비용을 어떻게 나누는지 비교하고, 두 모델을 내 저장소에서 직접 테스트해 보세요.

20 11월 2026