기본 에이전트 만들기
질문에 답하고 도구를 호출할 수 있는 간단한 에이전트를 만드는 것부터 시작하세요. 이 에이전트는 Claude Sonnet 4.5를 언어 모델로 사용하고, 기본 날씨 함수를 도구로 사용하며, 간단한 프롬프트로 동작을 안내합니다.이 예제를 위해서는 Claude (Anthropic) 계정을 설정하고 API 키를 받아야 합니다. 그런 다음 터미널에서
ANTHROPIC_API_KEY 환경 변수를 설정하세요.실제 에이전트 만들기
다음으로, 주요 프로덕션 개념을 보여주는 실용적인 날씨 예보 에이전트를 만들어 보겠습니다:- 상세한 시스템 프롬프트로 더 나은 에이전트 동작 구현
- 도구 생성으로 외부 데이터와 통합
- 모델 구성으로 일관된 응답 제공
- 구조화된 출력으로 예측 가능한 결과 생성
- 대화 메모리로 채팅과 같은 상호작용 구현
- 에이전트 생성 및 실행으로 완전히 작동하는 에이전트 만들기
1
시스템 프롬프트 정의
시스템 프롬프트는 에이전트의 역할과 동작을 정의합니다. 구체적이고 실행 가능하게 작성하세요:
2
도구 생성
Tools는 모델이 정의한 함수를 호출하여 외부 시스템과 상호작용할 수 있게 합니다.
도구는 runtime context에 의존할 수 있으며 agent memory와도 상호작용할 수 있습니다.아래에서
get_user_location 도구가 runtime context를 어떻게 사용하는지 확인하세요:도구는 잘 문서화되어야 합니다: 도구의 이름, 설명, 인자 이름이 모델의 프롬프트의 일부가 됩니다.
LangChain의
@tool decorator는 메타데이터를 추가하고 ToolRuntime 파라미터를 통한 runtime injection을 가능하게 합니다.3
모델 구성
사용 사례에 맞는 올바른 parameters로 language model을 설정하세요:
4
응답 형식 정의
선택적으로, 에이전트 응답이 특정 스키마와 일치해야 하는 경우 구조화된 응답 형식을 정의하세요.
5
메모리 추가
상호작용 간 상태를 유지하기 위해 에이전트에 memory를 추가하세요. 이를 통해 에이전트가 이전 대화와 컨텍스트를 기억할 수 있습니다.
프로덕션 환경에서는 데이터베이스에 저장하는 영구 checkpointer를 사용하세요.
자세한 내용은 Add and manage memory를 참조하세요.
6
에이전트 생성 및 실행
이제 모든 구성 요소로 에이전트를 조립하고 실행하세요!
- 컨텍스트 이해하고 대화 기억하기
- 여러 도구를 지능적으로 사용하기
- 구조화된 응답을 일관된 형식으로 제공하기
- 사용자별 정보를 컨텍스트를 통해 처리하기
- 대화 상태를 상호작용 간 유지하기
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.