시스템 도구는 에이전트가 일반적인 작업을 실행하는 데 사용할 수 있는 기본 제공 도구입니다. 수정할 수 없습니다.
다른 도구와 마찬가지로 시스템 도구를 사용할 때는 도구를 사용할 시점에 대한 에이전트 요청 사항을 제공하고 도구 인수를 제공하세요.
customize_response
바지인 및 DTMF 매개변수를 사용 중지하는 등 매개변수를 세부적으로 제어하여 에이전트 음성 응답을 생성합니다.
인수:
| 인수 | 필수/선택사항 | 설명 | 기본값 |
|---|---|---|---|
| 콘텐츠 | 필수 | 에이전트 응답의 텍스트 콘텐츠입니다. | |
| enable_dtmf | 선택사항 | 키보드 입력 (DTMF)을 사용 설정할지 여부입니다. | 거짓 |
| dtmf_endpointing_timeout_modes | 선택사항 | 사용자가 응답을 입력하는 대기 시간입니다. '짧음', '중간', '김' 중에서 선택할 수 있습니다. | 'mid' |
| dtmf_finish_digit | 선택사항 | DTMF 수집을 종료하는 DTMF 숫자입니다. 예를 들어 '#'입니다. | 빈 문자열 |
| disable_barge_in | 선택사항 | 상담사가 말할 때 사용자의 끼어들기를 허용하지 않습니다. | 거짓 |
DTMF로 전화번호를 수집하는 예시 안내:
make the tool call customize_response(content="Please type your phone number",
enable_dtmf=True, dtmf_endpointing_timeout_modes='short')
DTMF로 신용카드 번호를 수집하는 예시 안내:
make the tool call customize_response(
content="Using your keypad, please enter your 16-digit credit card number, then press the pound key when you are finished.",
enable_dtmf=True,
dtmf_finish_digit='#',
dtmf_endpointing_timeout_modes='mid')
인터럽트를 허용하면서 약관을 읽는 예시 안내:
make the tool call customize_response(
content="By proceeding, you agree to the terms and condition...",
disable_barge_in=True)
end_session
세션을 종료합니다. 이 도구는 사람인 에이전트에게 에스컬레이션하거나 사용자에게 더 이상 요청이 없는 경우 세션을 종료하기 위해 대화를 종료하는 데 사용됩니다.
문제로 인해 세션이 종료되고 사용자를 에스컬레이션해야 하는 경우 session_escalated 매개변수에 True 값을 제공합니다.
params 인수를 사용하여 최종 응답의 종료 세션 메타데이터에 데이터를 전달합니다.
인수:
| 인수 | 필수/선택사항 | 설명 | 기본값 |
|---|---|---|---|
| reason | 필수 | 세션을 종료한 이유입니다. | |
| session_escalated | 선택사항 | 세션이 상담사에게 에스컬레이션되었는지 여부입니다. | 거짓 |
| params | 선택사항 | 세션 종료 핸들러에 전달할 기타 매개변수입니다. | 없음 |
대화를 종료하기 위한 안내의 예:
If the user has no more questions execute the tool end_session(reason="success")
사용자가 실시간 상담사를 원하는 경우 에스컬레이션하는 방법의 예:
If the user wants to talk to a human, execute the tool
end_session(reason="escalate_to_human", session_escalated=True)
사용자 입력 언어를 확인하는 예시 안내:
If the user speaks a language that is not English or Spanish, escalate by
calling: end_session(
reason='Encountered an unsupported language, escalating to a human agent.',
session_escalated=true).