컨텍스트 엔지니어링 개념

LangSmith의 컨텍스트 엔지니어링을 위한 핵심 개념으로, 스킬(skills), 에이전트(agents), 버전 관리 및 공유에 대해 다뤄요.

에이전트는 컨텍스트를 잘못 관리하면 프로덕션에서 일관되지 않게 동작해요. 컨텍스트는 시스템 지시문, 도구 정의, 참조 자료와 같이 에이전트가 행동하기 위해 의존하는 정보예요. 컨텍스트 엔지니어링은 에이전트 성능과 역량을 개선하기 위해 그 컨텍스트를 구축하고 최적화하는 작업이에요.

이 페이지에서는 LangSmith의 컨텍스트 엔지니어링 핵심 개념인 스킬, 에이전트, 컨텍스트 허브, 버전 관리, 공유를 다뤄요.

출처: 문서

본문

스킬

스킬은 에이전트가 호출할 수 있는 재사용 가능한 기능을 패키징한 컨텍스트 허브의 버전 관리된 저장소(repo)예요.

스킬 저장소에는 보통 다음이 포함돼요:

공통 파일:

루트 디렉터리의 지시문 및 사용 가이드를 위한 SKILL.md.
참조, 템플릿, 스키마 같은 선택적 지원 파일.

예시로는 이메일 서식, 코드 리뷰, 웹 리서치가 있어요.

에이전트

에이전트는 도구, 스킬, 하위 에이전트를 사용해 엔드투엔드로 작업을 완료하는 AI 시스템이에요. 에이전트 저장소는 높은 수준의 지시문, 연결된 스킬 및 하위 에이전트, 도구 구성을 포함한 자체 구성을 패키징해요.

에이전트 저장소에는 보통 다음이 포함돼요:

공통 파일:

시스템 프롬프트 및 운영 지시문을 위한 AGENTS.md.
tools.json과 연결된 agents/* 또는 skills/* 항목 같은 선택적 파일.

예시로는 이메일 어시스턴트, 코딩 코파일럿 또는 고객 지원 에이전트가 있어요.

스킬과 에이전트 중 선택하기

스킬은 재사용 가능한 컨텍스트 모듈이에요. 에이전트 저장소는 에이전트가 어떻게 운영되어야 하는지를 정의하는 최상위 번들이에요.

여러 에이전트에서 공유하는 재사용 가능한 지시문, 정책 또는 예시에는 스킬을 사용하세요.
단일 에이전트의 운영 지시문, 도구 및 연결된 의존성에는 에이전트 저장소를 사용하세요.

연결된 저장소

컨텍스트 허브 커밋은 files에서 세 가지 항목 유형을 지원해요:

file: 인라인 파일 콘텐츠.
agent: 다른 에이전트 저장소에 대한 링크.
skill: 다른 스킬 저장소에 대한 링크.

연결된 에이전트 또는 스킬 저장소에 새 커밋이 생기면 LangSmith는 그 업데이트를 참조하는 상위 저장소에 전파해요.

여러 에이전트에 동일한 컨텍스트 블록을 복사하고 있다면, 그 블록을 스킬 저장소로 분리하고 각 에이전트에서 참조하세요.

컨텍스트 허브 vs 스토어 백엔드

LangSmith의 컨텍스트는 컨텍스트 허브와 스토어 백엔드라는 두 가지 다른 백엔드로 관리될 수 있어요. 이 둘은 다른 목적을 가지며, 대부분의 에이전트는 둘 다 사용해요.

컨텍스트 허브는 에이전트의 장기 컨텍스트 저장소예요. 모든 변경 사항을 커밋으로 추적하고 버전 관리, 공유, 지속적 개선을 지원해요.

스토어 백엔드는 런타임 상태를 위해 만들어졌어요. 실행 중 에이전트가 축적하는 정보(메모리, 대화 기록, 사용자 선호도, 학습된 사실, 그리고 세션별 또는 사용자별로 진화하는 기타 데이터)를 보유해요.

버전 관리

컨텍스트 허브의 저장소에 대한 모든 변경은 새 커밋을 만들어요. 커밋은 불변이며, 탐색하고 비교할 수 있어서 다음을 할 수 있어요:

에이전트의 두 버전 사이에 정확히 무엇이 바뀌었는지 확인.
변경으로 인해 동작이 회귀하면 이전 커밋으로 되돌리기.
중요한 커밋(예: 특정 날짜에 배포한 커밋)에 태그를 달아 쉽게 참조.
커밋을 Staging 또는 Production 같은 환경으로 승격해서, 다운스트림 에이전트가 최신 편집본 대신 안정 버전을 가져오도록 하기.

이 워크플로가 익숙해 보인다면 의도된 것입니다. 컨텍스트 허브는 Git이 코드에 가져온 동일한 규율을 에이전트 지시문에 가져와요.

공유 및 권한

컨텍스트 허브는 팀을 위해 설계되었어요. 모든 저장소는 워크스페이스에 있으며, 접근은 워크스페이스 권한과 저장소 가시성에 따라 달라져요:

Private(비공개) 저장소는 워크스페이스 내에서만 볼 수 있어요.
Public(공개) 저장소는 누구나 찾아서 가져올 수 있어요.
커밋 생성, 태그 추가, 환경 승격에는 워크스페이스의 업데이트 접근 권한이 필요해요.

워크스페이스 수준의 공유 및 가시성 제어는 허브를 에이전트와 스킬을 협업하고 시간이 지나며 개선하기에 자연스러운 장소로 만들어 줘요.

다음 단계

컨텍스트 허브 사용하기로 첫 스킬 또는 에이전트를 만들어 보세요.

컨텍스트 엔지니어링 개념