Ch6. Context, Skills, Dynamic Capabilities

에이전트 품질은 모델보다 컨텍스트 설계에 더 자주 좌우됩니다. Eve는 컨텍스트를 한 prompt에 다 붙이지 않고 always-on instructions, on-demand skills, dynamic capabilities, sandbox workspace로 나눕니다.

컨텍스트 레버

좋은 Eve 에이전트는 “항상 보이는 prompt”를 줄이고 “필요할 때 드러나는 지식/도구”를 늘립니다.

Instructions는 짧고 안정적으로

instructions.md에는 변하지 않는 계약만 넣습니다.

좋은 예:

You are an internal operations agent.
Verify facts before taking action.
For destructive or external side-effecting actions, explain the planned action and wait for approval.
Use available skills when a task matches their description.

나쁜 예:

• 모든 업무 절차를 instructions에 붙인다.
• 팀별 정책을 하나의 prompt에 모두 넣는다.
• 자주 바뀌는 가격/조직/권한 정보를 prompt에 하드코딩한다.

자주 바뀌는 정보는 dynamic instructions 또는 tool/connection으로 가져와야 합니다.

Skills는 procedure memory다

Eve skill은 “새 실행 능력”이 아니라 “모델이 로드하는 절차”입니다. tool은 skill을 로드하기 전에도 보일 수 있습니다. 여기를 헷갈리면 skill을 보안 경계로 오해합니다.

Packaged skill은 sibling files를 가질 수 있습니다.

agent/skills/incident-response/
├── SKILL.md
├── references/severity-matrix.md
└── scripts/render-report.ts

모델은 load_skill로 SKILL.md를 prompt에 추가하고, 필요하면 sandbox file tools로 sibling files를 읽습니다.

Skill description은 routing contract다

description은 “무엇인지”보다 “언제 써야 하는지”를 적습니다.

Eve는 skill description을 모델에게 광고합니다. 설명이 약하면 모델은 skill을 로드하지 않습니다.

Dynamic tools

defineDynamic을 agent/tools/*.ts에서 사용하면 session/turn/step event에 따라 tool set을 생성할 수 있습니다.

대표 시나리오:

여기서 주의할 점은 dynamic tool의 execute가 inline function이어야 한다는 것입니다. Eve bundler transform은 inline execute closure를 step boundary 이후에도 복원하도록 처리합니다. execute: myFn 형태로 쓰면 replay/resume 안정성이 깨질 수 있습니다.

Dynamic naming

Dynamic tool map을 반환하면 tool name은 <fileSlug>__<key>가 됩니다.

export default defineDynamic({
  events: {
    "session.started": async () => ({
      orders: defineTool({ /* query__orders */ }),
      users: defineTool({ /* query__users */ }),
    }),
  },
});

이 naming은 운영 로그와 eval에 그대로 남습니다. key가 tenant data에서 온다면 sanitize하고, 이름이 흔들리지 않게 유지해야 합니다.

Dynamic skills와 instructions

팀/역할/요금제별 컨텍스트는 dynamic skills/instructions가 적합합니다.

import { defineDynamic, defineInstructions } from "eve/instructions";

export default defineDynamic({
  events: {
    "session.started": (_event, ctx) => {
      const plan = ctx.session.auth.current?.attributes.plan ?? "unknown";
      return defineInstructions({
        markdown: `The caller plan is ${plan}. Apply the matching support policy.`,
      });
    },
  },
});

보안상 중요한 점:

• dynamic resolver는 ctx.session.auth를 기준으로 capability를 제한할 수 있다.
• 제한된 capability가 prompt에 노출되기 전에 route auth가 정확해야 한다.
• channel metadata도 resolver 입력이 되므로, channel은 신뢰할 수 있는 metadata만 project해야 한다.

Event 순서

Eve의 stream event 처리 순서는 구조적입니다.

1. channel adapter handler가 실행된다.
2. channel metadata projection이 갱신된다.
3. hooks가 실행된다.
4. dynamic tool/skill/instruction resolver가 실행된다.

그래서 dynamic resolver는 갱신된 channel metadata를 읽습니다. 예를 들어 channel event handler가 Slack thread state를 업데이트하면, dynamic skill resolver가 그 thread의 team/playbook을 고릅니다.

컨텍스트 오염 방지 패턴

평가 기준

컨텍스트 설계는 eval로 검증해야 합니다.

Eve의 progressive disclosure는 고급 기능이지만 품질을 저절로 보장하지는 않습니다. description, routing eval, dynamic resolver의 auth 기준이 함께 갖춰져야 합니다.