에이전트끼리 넘기기 (핸드오프)

내용

📌 넘기기(handoff)란

한 에이전트가 대화를 다른 에이전트에게 통째로 넘깁니다.
넘긴 뒤에는 받은 쪽이 대화를 이어갑니다.

  일반 상담 → (환불 얘기네) → 환불 담당으로 넘김

총괄이 나눠 주는 방식과 다릅니다.
위에서 지시하는 사람 없이, 옆으로 넘어갑니다.

📌 모델 눈에는 도구로 보입니다
이름 규칙이 정해져 있습니다.

  Refund Agent 로 넘기는 도구 → transfer_to_refund_agent
  즉  transfer_to_<에이전트 이름>

📌 손댈 수 있는 것들
handoff() 로 만들고 아래를 바꿀 수 있습니다.

  tool_name_override         도구 이름 바꾸기
  tool_description_override  설명 바꾸기
  on_handoff                 넘어가는 순간 실행할 것
  input_type                 넘길 때 받을 값의 모양
  input_filter               받는 쪽에 넘길 내용 거르기
  is_enabled                 상황에 따라 켜고 끄기

📌 input_filter 가 실무에서 제일 중요합니다
그대로 두면 지금까지의 대화가 다 넘어갑니다.
받는 에이전트가 알 필요 없는 것까지 넘어가면
토큰도 낭비고, 엉뚱한 것에 끌려가기도 합니다.

무엇을 남길지 정해서 넘기세요.

⚠️ 프롬프트에 안내를 넣어야 제대로 넘깁니다
   SDK 가 권장 문구를 따로 줍니다.
   RECOMMENDED_PROMPT_PREFIX 를 앞에 붙이거나
   prompt_with_handoff_instructions() 로 감싸면 됩니다.
   안 넣으면 넘겨야 할 상황에서 안 넘깁니다.

⚠️ 이건 코드로 짜는 것입니다
   ChatGPT 대화창에서 켜는 기능이 아닙니다.
   대화창만 쓰신다면 참고로만 보세요.

궁금한 점: {{INPUT}}