에이전트 디버깅
프리뷰 채팅의 디버그 모드는 상담원이 어떻게 사고하고, 정보를 처리하며, 응답을 생성하는지 이해하는 데 도움이 됩니다. 출력 결과가 왜 그런지 추측하는 대신, 디버거는 에이전트의 내부 실행 과정을 단계별로 명확하게 보여줍니다. 새로운 동작을 검증하든 예상치 못한 결과를 해결하든, 디버거를 사용하면 신속하고 정확한 문제 해결이 가능합니다. 디버거는 에이전트의 동작을 세밀하게 조정하고, 안정적이고 수준 높은 사용자 경험을 구축하는 데 필요한 명확성과 제어 기능을 제공합니다.
디버거를 사용하면 다음을 수행할 수 있습니다:
에이전트가 사용자 입력을 어떻게 해석하는지 파악하기
정보가 도구, 메모리, 그리고 협력자들을 통해 어떻게 이동하는지 살펴보세요
특정 응답의 근거를 파악하라
구성 또는 논리상의 문제를 신속하게 파악하고 해결합니다
디버거 시작하기
에이전트 디버깅을 시작하려면:
미리보기 채팅 창에서 메뉴를 열고 ‘디버깅 활성화’를 선택하세요.
대화를 실행한 후, 채팅 결과 아래에 있는 ‘디버그’를 클릭하면 상담원 디버그 페이지가 열립니다.
디버그 인터페이스에는 두 가지 주요 구성 요소가 있습니다:
컴포넌트 |
설명 |
|---|---|
에이전트 구조 |
에이전트가 어떻게 구성되는지와 그 구성 요소들이 어떻게 연관되어 있는지를 보여주는 시각적 지도 |
이행 일정 |
요청부터 응답까지 에이전트의 추론 과정을 단계별로 살펴보기 |
에이전트 구조
에이전트 구조도는 에이전트가 어떻게 구성되어 있는지, 그리고 각 구성 요소들이 어떻게 연결되어 있는지 이해하는 데 도움이 되는 시각적 도식입니다. 여기에는 다음과 같은 혜택이 포함됩니다.
대리인이 사용할 수 있는 도구
에이전트가 활용할 수 있는 협력자
구성 요소 간의 연결 및 관계
이행 일정
이 타임라인은 사용자의 초기 요청부터 생성된 응답에 이르기까지 에이전트의 추론 과정을 단계별로 보여줍니다. 이 보기를 사용하면 다음을 수행할 수 있습니다:
실행 흐름을 단계별로 따라가 보세요
특정 단계로 바로 이동하기
실행 타임라인 상단의 탐색 컨트롤을 사용하여 실행 타임라인을 앞뒤로 이동할 수 있습니다.
통제 |
조치 |
|---|---|
선택된 노드 강조 표시 |
실행에 포함된 노드를 강조 표시하려면 클릭하세요. |
사용하지 않는 노드 숨기기 |
이 버튼을 클릭하면 추론에 관련된 노드만 표시됩니다. |
범례 |
각 노드 유형의 의미와 기능에 대한 자세한 내용을 보려면 클릭하세요 |
각 단계에는 다음과 같은 참고 정보가 포함되어 있습니다:
정보 유형 |
세부사항 |
|---|---|
변수 |
요약, 입력, 출력, 노드 로그 |
노드 메타데이터 |
소개, 협력사, 도구, 가이드라인, LLM 모델 |
변수
변수는 실행 중에 워크플로우를 통과하는 데이터를 저장하고 표시합니다. 이들은 노드 간에 어떤 정보가 전달되고, 그 정보가 어떻게 변환되는지 이해하는 데 도움을 줍니다.
변수 유형 |
설명 |
|---|---|
요약 |
워크플로우에서 지금까지 생성된 모든 변수에 대한 개요. 각 노드를 일일이 살펴볼 필요 없이 워크플로 상태를 빠르게 파악하는 데 유용합니다. |
입력 |
노드로 입력되는 데이터. 이전 노드의 출력, 사용자가 제공한 정적 입력 또는 시스템에서 생성된 컨텍스트를 포함할 수 있습니다. |
출력 |
노드가 실행 후 생성한 데이터. 처리 대상은 텍스트, API 응답, 구조화된 객체 또는 변환된 변수일 수 있습니다. |
노드 로그 |
디버깅 및 검토를 위한 실행 로그. 원시 입력 또는 출력 데이터, 실행 성공 또는 실패 상태, 런타임 오류 및 성능 데이터가 포함될 수 있습니다. |
노드 메타데이터
노드 메타데이터는 각 노드에 대한 설명 및 구성 관련 정보를 제공합니다.
메타데이터 필드 |
설명 |
|---|---|
정보 |
해당 노드가 수행하는 작업, 즉 그 목적, 기능 및 워크플로우 내에서의 역할을 간략히 설명한 내용입니다. |
도구 |
해당 노드가 사용하는 API, 커넥터, 모델, 플러그인 등 외부 도구 또는 통합 기능을 나열합니다. |
가이드라인 |
논리 구조와 출력 품질의 일관성을 유지하는 데 도움이 되는 프롬프트 지침, 서식 규칙, 행동 제약 조건과 같은 노드별 지침이나 규칙. |
LLM 모델 |
이 노드에 적용된 언어 모델을 나타냅니다. 이는 추적성을 확보하고 성능, 비용 및 기능을 이해하는 데 도움이 됩니다. |
디버깅 워크플로
워크플로우 디버깅이란 워크플로우의 실행 과정을 체계적으로 검토하여 논리, 성능 또는 출력에 영향을 미치는 문제를 파악하고, 이해하며, 해결하는 과정을 말합니다.
입력 내용을 확인하십시오
디버거는 에이전트가 사용자의 메시지에서 정확히 무엇을 파악했는지 기록하므로, 올바른 시나리오가 테스트되고 있는지 확인하는 데 도움이 됩니다.
실행 경로를 따라가세요
실행을 진행해 나가면서:
에이전트 맵에서 해당 노드가 강조 표시됩니다.
메모리가 요청에 어떤 영향을 미쳤는지 확인할 수 있습니다.
에이전트가 어떻게 추론을 도출했는지 파악할 수 있습니다.
협력자의 행동 점검
담당자가 업무를 협력자에게 이관하는 경우, 다음 사항을 확인할 수 있습니다:
요청을 어떻게 해석했는지
그 도구와 지침이 그 조직의 행동 양식을 어떻게 형성했는가
다른 구성 요소에 추가적인 작업을 위임했는지
도구 활동 확인
디버거는 실제로 어떤 도구가 사용되었는지 보여줍니다. 이 기능은 다음과 같은 이점을 제공합니다:
예상된 도구가 실행되었는지 확인하십시오
작동되었어야 했지만 작동하지 않은 도구를 파악하십시오
구성 문제로 인해 발생하는 예기치 않은 논리 경로를 탐지합니다
근본 원인을 파악하십시오
메타데이터, 지침 및 실행 내역을 검토하면 다음과 같은 문제를 파악할 수 있습니다:
부적절한 협력자 지침
공구 트리거 정렬 불량
의도한 동작을 반영하지 않는 논리 경로
문제를 파악한 후에는 설정을 업데이트하고 즉시 다시 테스트할 수 있습니다.