invoke란
직역하면 "호출하다", "실행하다"라는 의미이다.
LLM에서는 AI 모델에게 질문을 하고 응답을 받는 메서드를 의미한다.
invoke는 AI와 대화하는 "말 걸기" 버튼이라고 생각하면 된다
이렇게 하면 AI가 "안녕하세요"라는 인사에 대답을 해준다.
기본 형태
일관된 인터페이스
- invoke 라는 이름의 메서드를 반드시 가져야 함
- 입력은 반드시 딕셔너리 형태
- 출력도 반드시 딕셔너리 형태
- 가장 단순한 형태의 입력 → 처리 → 출력 구조
체이닝
- 각 invoke는 독립적으로 동작
- 한 invoke의 출력이 다음 invoke의 입력으로 사용
- 모든 중간 결과도 딕셔너리 형태를 유지
- 채인 내의 각 단계는 서로의 내부 구현을 알 필요가 없음
에러 처리
- 모든 상황에서 반드시 딕셔너리를 반환
- 에러 상황에서도 예외를 발생시키지 않음
- 성공 / 실패 여부를 명확히 표시
- 에러 메시지를 포함한 일관된 응답 구조 유지
확장성
- 기본 기능을 유지하면서 추가 기능 확장 가능
- 선택적 파라미터를 통한 유연한 동작 지원
- 디버그 모드 같은 개발 지원 기능 추가 가능
- 설정을 통한 동작 변경 가능
invoke의 특징
- 항상 딕셔너리(dict) 형태의 입력을 받음
- 입력을 처리하여 결과를 생성
- 결과도 항상 딕셔너리 형태로 반환
- 메서드 이름은 항상 'invoke'를 사용
- 일관된 인터페이스 : 입 / 출력이 항상 dict 형태
- 독립적 실행 : 각 invoke는 독립적으로 동작 가능
- 체이닝 가능 : 여러 invoke를 연결해서 사용 가능
- 상태 비의존성 : 이전 호출의 결과에 영향을 받지 않음
- 단독 사용 : 하나의 invoke로 작업 처리
- 체인 사용 : 여러 invoke를 순차적으로 연결
- 병렬 사용 : 여러 invoke를 동시에 실행 가능
필요한 이유
invoke를 사용하지 않은 경우
invoke를 사용한 경우
주의사항
- 입력값 검증을 항상 먼저 수행
- 원본 데이터 변경 주의
- 필수값 체크 철저히
- 일관된 반환 형식 유지
- 에러 처리 형식 통일
팁
- 디버그 모드 지원으로 개발 편의성 제공
- 상세한 로깅으로 문제 추적 용이
- dict.get() 메서드로 안전한 기본값 처리
- 처리 단계별 결과 추적으로 디버깅 용이
- 풍부한 메타데이터 제공으로 활용성 증가
- 디버그 모드일 때 더 상세한 에러 정보 제공
성문이