본문으로 건너뛰기

Managed Deep Agents의 Instructions 관리와 Context Hub 활용법

Managed Deep Agents에서 instructions.md를 통해 에이전트 행동을 정의하고, LangSmith Context Hub로 동기화하여 코드를 수정하지 않고도 지침을 변경하는 방법을 다룬다.

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Managed Deep Agents는 instructions.md 파일을 통해 에이전트의 시스템 프롬프트를 정의한다. 개발자는 mda dev로 로컬에서 행동을 테스트하고, mda deploy를 통해 이를 LangSmith의 Context Hub로 동기화할 수 있다. 이 구조는 코드를 재배포하지 않고도 LangSmith UI에서 직접 지침을 수정할 수 있게 하며, 로컬과 원격 간의 변경 사항 충돌을 관리하는 동기화 기능을 제공한다.

챕터별 상세

00:00

Managed Deep Agents의 Instructions 정의

Managed Deep Agents에서 에이전트의 행동은 instructions.md 파일에 정의된 시스템 프롬프트를 통해 결정된다. 이 파일은 에이전트의 핵심 규칙을 담고 있으며, 에이전트가 실행될 때 자동으로 로드된다. 사용자는 이 파일을 수정하여 에이전트의 응답 방식이나 행동을 즉시 변경할 수 있다.

Instructions는 에이전트가 특정 작업을 수행하도록 유도하는 지침서 역할을 한다.

00:33

로컬 환경에서의 테스트와 실행

mda dev 명령어를 실행하면 로컬 환경에서 에이전트가 구동된다. instructions.md 파일을 수정하고 저장하면 변경 사항이 즉시 반영되어 에이전트의 행동이 바뀐다. 이를 통해 개발자는 배포 전 에이전트의 응답을 빠르게 검증할 수 있다.

mda dev는 로컬 개발을 위한 런타임 환경을 제공한다.

bash
mda dev

에이전트를 로컬 환경에서 실행하고 테스트하는 명령어이다.

01:31

LangSmith Studio를 통한 시스템 프롬프트 확인

LangSmith Studio의 트레이스 기능을 사용하면 에이전트의 실행 과정을 상세히 볼 수 있다. 모델 호출 단계에서 시스템 프롬프트가 어떻게 전달되는지 확인 가능하며, instructions.md에 작성한 내용이 에이전트의 시스템 프롬프트에 포함되어 있음을 알 수 있다.

Tracing은 에이전트의 내부 의사결정 과정을 시각화하여 디버깅을 돕는다.

03:08

Context Hub를 통한 원격 지침 관리

mda deploy 명령어를 사용하면 로컬의 instructions.md가 LangSmith의 Context Hub로 동기화된다. 이후 LangSmith UI에서 직접 지침을 수정하면 코드를 다시 배포할 필요 없이 에이전트의 동작이 업데이트된다. 이는 운영 중인 에이전트의 행동을 유연하게 변경할 수 있게 한다.

Context Hub는 에이전트의 설정을 중앙화하여 관리 효율성을 높인다.

bash
mda deploy

에이전트를 배포하고 Context Hub와 동기화하는 명령어이다.

04:19

로컬과 원격 지침의 동기화 및 충돌 해결

로컬 파일과 Context Hub의 내용이 다를 경우 mda deploy 실행 시 충돌이 발생한다. 시스템은 변경 사항을 감지하고 로컬 버전으로 덮어쓸지 여부를 사용자에게 묻는다. 사용자가 동의하면 로컬의 변경 사항이 원격 저장소에 반영되어 일관성이 유지된다.

배포 시 발생하는 버전 충돌을 방지하기 위한 동기화 메커니즘이다.

용어 해설

시스템 프롬프트(System Prompt)
AI 에이전트의 행동 양식과 규칙을 정의하는 핵심 지침이다. Managed Deep Agents에서는 instructions.md 파일에 작성되어 에이전트의 동작을 제어한다.
컨텍스트 허브(Context Hub)
LangSmith에서 에이전트의 설정과 지침을 중앙에서 관리하는 저장소이다. 코드를 재배포하지 않고도 UI를 통해 에이전트의 동작을 실시간으로 수정하고 동기화할 수 있다.
AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 08. 20.수집 2026. 08. 20.출처 타입 YOUTUBE

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.