본문으로 건너뛰기
Documentation

플래너 구성

마지막 게시: 2026-07-21 19:00

플래너 구성

플래너 구성에서는 복합 요청을 여러 작업으로 나눌 때 모델에 제공할 역량, 활성 manifest와 테넌트 근거를 확인합니다. 단순 질문에 불필요한 계획이 만들어지거나 필요한 도구가 계획에서 빠질 때 사용합니다.

개요

Planner Context는 요청 목적, 테넌트, 사용 가능한 capability와 활성 manifest를 모아 구성됩니다. 각 capability에는 수명주기 상태와 근거가 포함되며, 모델은 이 정보를 바탕으로 실행 가능한 단계만 계획해야 합니다.

컨텍스트 구성

항목 설명
Tenant ID 계획에 적용할 회사별 데이터와 정책 범위입니다.
Capability 실행 가능한 업무 역량과 입력·출력 계약입니다.
Lifecycle Status active, preview, retired 등 현재 사용 가능 상태입니다.
Evidence 역량이 선택된 이유와 출처입니다.
Manifest 실제 서비스와 도구가 제공하는 기능 정의입니다.

계획 확인

  1. 요청에 올바른 Tenant ID가 포함됐는지 확인합니다.
  2. 필요한 capability가 활성 상태인지 확인합니다.
  3. manifest의 최신 발견 시각과 상태를 확인합니다.
  4. 계획 단계마다 실행할 도구 또는 서비스가 있는지 확인합니다.
  5. 근거 없이 생성된 단계가 없는지 확인합니다.
  6. 쓰기 작업에는 승인과 결과 확인 단계가 포함되는지 확인합니다.

좋은 계획의 기준

계획은 실행 가능한 작은 단계로 나뉘고 각 단계의 입력과 완료 조건이 분명해야 합니다. 단순 조회를 여러 단계로 과도하게 분해하거나 사용할 수 없는 capability를 포함하면 실행 실패와 토큰 낭비가 늘어납니다.

테넌트 경계

같은 capability라도 테넌트에 따라 연결 데이터와 허용 도구가 다를 수 있습니다. Planner Context에 tenantId가 없거나 잘못되면 다른 회사의 용어와 도구를 선택할 위험이 있으므로 실행 전에 격리 키를 확인합니다.

변경 검증

  1. 조회만 필요한 단순 요청을 실행합니다.
  2. 두 개 이상의 도구가 필요한 복합 요청을 실행합니다.
  3. 쓰기 단계에서 승인 요청이 생성되는지 확인합니다.
  4. 비활성 capability가 계획에 포함되지 않는지 확인합니다.
  5. 턴 검사기에서 계획 근거와 실제 실행 순서를 비교합니다.

문제 해결

계획은 생성됐지만 실행되지 않으면 capability의 실제 도구 연결과 정책을 확인합니다. 같은 단계가 반복되면 종료 조건과 도구 결과 해석을 확인합니다. 필요한 capability가 없으면 manifest 발견 상태와 수명주기를 먼저 점검합니다.

수정 이력

이 문서의 변경 내역을 시간순으로 볼 수 있습니다.

표시할 수정 이력이 없습니다.

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.