실행 결과와 상태

에이전트의 실행 결과에는 최종 답변 외에도 핸드오프 후 어느 에이전트가 제어권을 갖는지 확인하고 다음 턴에서 대화를 이어가는 데 필요한 정보가 담깁니다. 검토를 위해 실행이 일시 중지되면 결과에 포함된 스냅샷으로 실행을 재개할 수 있습니다.

필요한 결과 속성 선택하기

대부분의 애플리케이션에는 다음 몇 가지 결과 속성이면 충분합니다.

이 가이드에서는 위 항목부터 익히세요. 더 세부적인 실행 항목, 모델의 원본 응답, 상세 진단 정보는 SDK 문서와 레퍼런스에서 다룹니다.

다음 턴에 전달할 정보

대화를 이어가는 방식에 맞춰 실행 결과를 사용하세요.

• 애플리케이션이 전체 대화 기록을 로컬에서 관리한다면 history in TypeScript or to_input_list() in Python 값을 재사용하세요.
• 세션을 사용한다면 매번 같은 세션을 전달하세요. SDK가 대화 기록을 불러오고 저장합니다.
• 서버에서 대화의 연속성을 관리한다면 전체 대화 기록을 다시 보내는 대신 새 사용자 입력만 전달하고 저장된 ID를 재사용하세요.
• 핸드오프로 제어권을 넘겨받은 전문 에이전트가 다음 턴도 맡아야 한다면 lastAgent in TypeScript or last_agent in Python 값을 재사용하세요.

실행이 중단되면 최종 답변 대신 상태 반환

승인 플로우는 실행이 끝나기 전에 의도적으로 중간 결과를 반환하는 대표적인 경우입니다.

• finalOutput in TypeScript or final_output in Python 값은 실행이 아직 끝나지 않았으므로 비어 있을 수 있습니다.
• interruptions에는 승인 여부를 결정해야 하는 도구 호출이 표시됩니다.
• state in TypeScript or to_state() in Python 값은 저장된 스냅샷입니다. 해당 항목을 승인하거나 거부한 후 이 스냅샷을 런타임에 다시 전달하세요.

현재 요청에서 바로 검토하지 않고 나중에 검토할 수도 있다면 이 상태를 직렬화하세요.

상세 실행 항목과 진단 정보

SDK는 위의 주요 결과 속성보다 더 자세한 정보가 필요한 애플리케이션을 위해 상세 실행 항목과 진단 정보도 제공합니다. 여기에는 항목별 도구 호출 및 핸드오프 기록, 모델의 원본 응답, 가드레일 결과, 사용량 세부 정보가 포함됩니다.

이 정보는 감사, 사용자 지정 인터페이스 구현, 심층 디버깅에 유용합니다. 대부분의 개발자는 이 사이트에서 기본적인 결과 처리 방법을 익힌 뒤 필요할 때 살펴보면 됩니다.

다음 단계

어떤 결과 속성이 필요한지 파악했다면 다음 가이드에서 해당 결과가 어떻게 생성되는지, 어떻게 살펴볼 수 있는지 알아보세요.