Tool 호출 결과 이벤트 (Agent → 콜브릿지 통화시스템) Agent가 외부 Tool을 호출한 결과를 전달하는 이벤트입니다.
1. API 개요
Tool 호출 로그 전송 (Agent → 콜브릿지 통화시스템)
Tool 호출 로그 이벤트Agent가 대화 중 외부 Tool을 호출한 내역과 결과를 전달하는 이벤트입니다.
Agent가 Tool을 호출하면 해당 호출 정보가 WebSocket 이벤트로 콜브릿지 통화시스템에 전달됩니다.
이 이벤트는 다음 용도로 활용될 수 있습니다.
•
Tool 호출 이력 추적
•
상담 화면 실시간 표시
•
Agent 동작 모니터링 및 디버깅
•
상담 분석 및 QA
Plaintext 설명
Tool 호출 로그 이벤트는 Agent가 외부 Tool을 호출하고 결과를 받았을 때 발생합니다.
Agent 대화가 진행되는 동안 Tool 호출이 발생하면 호출 단위로 전달되며
각 호출은 Tool 이름, 호출 ID, 요청 파라미터, 호출 결과 정보와 함께 전달됩니다.
2. 사전 조건 / 권한
•
콜브릿지 계정 필수
•
WebSocket 음성 세션 연결 상태
3. API 정보
Method / Endpoint
wss {wss 또는 ws}://{상담콜내 연동정보 입력한 주소}
4. Request
Request Body
이름 | 타입 | 필수 | 기본값 | 설명 |
type | string | O | tool_log | 이벤트 타입 |
Request Body
tool_log
이름 | 타입 | 필수 | 기본값 | 설명 |
tool_name | string | O | - | Tool 호출 이름 |
tool_call_id | string | O | - | Agent 연결 ID |
parameters | Object | O | - | Tool 호출 시 전달한 파라미터 |
tool_result | String | O | - | Tool 호출 결과 (예: success, fail) |
Request Example
{
"type": "tool_log",
"tool_log": {
"tool_name": "get_weather",
"tool_call_id": "call_abc123",
"parameters": {
"location": "seoul",
"weather": "sunny"
},
"tool_result": "success"
}
}
JavaScript
복사
5. 이벤트 전송 타이밍
상황 | 이벤트 발생 |
Agent Tool 호출 완료 | tool_log 이벤트 전송 |
이 이벤트는 Agent가 Tool을 호출하고 결과를 수신할 때마다 전송됩니다.