Managed Deep Agents에 스킬 추가하기

Managed Deep Agents에 스킬 추가하기

관리형 딥 에이전트에 재사용 가능한 작업별 지침을 추가하는 방법을 알려드릴게요.

스킬은 작업별 절차와 보조 파일을 재사용 가능한 디렉터리로 묶습니다. MDA가 이를 자동으로 발견합니다. 에이전트는 작업이 frontmatter의 설명과 일치할 때만 스킬의 전체 내용을 로드합니다.

참고: Managed Deep Agents는 공개 베타 상태이며 LangSmith Cloud의 미국 리전에서만 사용할 수 있어요.

출처: 문서

본문

각 스킬은 프로젝트 루트의 skills/ 아래에 둡니다:

my-agent/
  agent.ts
  skills/
    research/
      SKILL.md

전체 프로젝트 레이아웃은 프로젝트 구조를 참고하세요.

스킬 추가하기

작업이 frontmatter의 설명과 일치할 때만 에이전트가 따라야 하는 절차에는 스킬을 사용하세요:

1. 스킬 디렉터리 만들기

각 스킬 디렉터리에는 name과 description frontmatter가 있는 SKILL.md 파일이 필요합니다:

---
name: research
description: Gather and synthesize context before answering complex questions.
---

# Research

Use this skill when a task needs more than a direct answer.

1. Identify what information is missing.
2. Use `query_db` to look up relevant records.
3. Summarize findings before responding to the user.

스킬 작성 패턴과 전체 형식은 Skills를 참고하세요. 점진적 공개(progressive disclosure)를 이해하려면 에이전트가 스킬을 사용하는 방식을 보세요.

2. 보조 파일 추가하기 (선택)

스킬 디렉터리에는 보조 스크립트, 참조 파일, 템플릿도 포함할 수 있습니다. 에이전트가 언제 사용할지 알 수 있도록 SKILL.md에서 이 파일들을 참조하세요:

skills/
  research/
    SKILL.md
    templates/
      report.md
    scripts/
      fetch_sources.ts

에이전트가 스킬을 사용하는 방식

시작 시 에이전트는 각 스킬의 name과 description을 봅니다. 작업이 스킬 설명과 일치하면 에이전트는 전체 SKILL.md를 읽고 지침을 따릅니다. 보조 파일은 필요할 때만 로드됩니다.

에이전트는 런타임에 스킬을 수정할 수 없습니다.

배포

mda deploy를 실행하면 MDA는 skills/ 아래의 모든 UTF-8 파일을 에이전트의 Context Hub에 동기화합니다.

그런 다음 LangSmith UI에서 스킬을 편집하고 그 변경사항을 에이전트에 적용할 수 있습니다.

지속적인 변경사항의 원천(source of truth)은 스킬 파일을 저장소에 두는 것이 좋습니다. 이후 배포가 프로젝트 사본을 다시 동기화하고 로컬에 존재하지 않는 배포된 스킬 파일을 제거하기 때문입니다.

무엇이 동기화되고 무엇이 되지 않는지, 배포에서 저장소를 여는 방법은 Context Hub를 참고하세요.

스킬 사용 시점

자세한 내용은 프로젝트 구조를 참고하세요.

더 알아보기

• 프로젝트 구조 — 전체 프로젝트 레이아웃 안내.