Deep Agents
긴 작업에 맞춰 기본값을 정해 둔 에이전트 하네스
pip install deepagents여러 단계를 오래 이어 가는 작업에 맞춰 기본값을 정해 둔 에이전트 하네스입니다. 하위 에이전트에게 격리된 맥락으로 일을 넘기고, 로컬이나 샌드박스, 원격 저장소를 골라 파일을 읽고 씁니다. 긴 대화를 요약하고 도구 출력을 디스크로 내려 맥락을 관리하며, 세션을 넘어가는 기억을 붙일 수 있습니다. 도구 호출을 실행하기 전에 사람이 승인하거나 고치거나 거절하는 단계도 들어 있습니다. 도구를 부를 수 있는 모델이면 어느 것이든 붙고, 마음에 들지 않는 부분은 갈아 끼우거나 통째로 바꾸도록 설계했습니다. 터미널에서 바로 쓰는 코딩 에이전트 판도 함께 제공합니다.
판단
이럴 때 씁니다
- 여러 단계를 오래 이어 가는 작업을 에이전트에게 맡길 때
- 하위 에이전트에게 격리된 맥락으로 일을 넘겨야 할 때
- 도구 호출 전에 사람 승인을 끼워야 할 때
이럴 땐 쓰지 마세요
- 단순한 도구 호출 한두 번이면 기본 SDK 로 충분합니다
- 기본값이 정해진 하네스라 흐름을 완전히 직접 설계하려면 아래 층을 쓰는 편이 낫습니다
- 패키지가 여럿이라 어느 판을 말하는지 헷갈립니다
차별점
- 긴 작업에 맞춰 기본값이 미리 정해져 있어 바로 돌아갑니다.
- 파일 백엔드를 로컬과 샌드박스, 원격 중에서 갈아 끼웁니다.
- 도구 호출 승인과 편집, 거절이 기본 기능으로 들어 있습니다.
- 타입스크립트 판이 따로 있어 두 생태계에서 같은 구조를 씁니다.
워크플로
- 01패키지를 설치합니다.
- 02모델과 도구, 시스템 프롬프트를 넘겨 에이전트를 만듭니다.
- 03필요하면 하위 에이전트와 파일 백엔드를 지정합니다.
- 04맥락 관리와 기억 저장소를 붙입니다.
- 05위험한 도구에는 사람 승인 단계를 겁니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install deepagents | 라이브러리를 설치합니다. |
create_deep_agent(model=..., tools=[...], system_prompt=...) | 에이전트를 만듭니다. |
curl -LsSf https://langch.in/dcode | bash | 터미널용 코딩 에이전트 판을 설치합니다. |
함정
설치 전에 확인하세요
- 패키지가 라이브러리와 코딩 에이전트 판으로 나뉘어 판 번호가 따로 움직입니다. 릴리스 태그만 보고 라이브러리 판을 짐작하면 어긋납니다.
- 하위 에이전트 방식의 이름이 최근에 바뀌었습니다. 오래된 예제의 설정값이 그대로 통하지 않습니다.
- 긴 대화를 요약하고 도구 출력을 디스크로 내립니다. 어떤 기준으로 덜어 내는지 모르면 사라진 맥락을 찾게 됩니다.
- 그래프 런타임 위에 얹힌 구조라 아래 층의 개념을 어느 정도 알아야 문제를 추적할 수 있습니다.
비교
그래프 런타임은 흐름을 직접 그리게 하고 최소 하네스는 뼈대만 줍니다. 이쪽은 그 위에 기본값을 얹어 바로 쓸 수 있게 만든 층입니다. 자유도를 조금 내주는 대신 긴 작업에서 흔히 필요한 요약과 파일, 승인 장치를 처음부터 갖고 시작합니다.
최근 변경
하위 에이전트 방식의 이름이 넘김에서 격리로 바뀌었습니다. 설정값을 그대로 쓰던 코드는 수정이 필요합니다.