← vox.aiCONTENT HISTORY
WHAT CHANGED
Update to vox.ai
Snapshot Nov 6, 2026 · 00:14 UTC · version 0.2.22
Collection source: downloaded plugin package.
First saved snapshot
No earlier snapshot is available to establish a change.
Save vox.ai and check future changes in Following.
Up to 3 plugins free · no card required.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"description": "vox.ai 통화 중 외부 도구가 호출되지 않거나 오류·타임아웃·결과 누락이 발생했을 때 실제 call 근거로 원인을 좁힌다.",
"included_files": [],
"name": "troubleshoot-agent-tool",
"skill_md_contents": "---\nname: troubleshoot-agent-tool\ndescription: \"vox.ai 통화 중 외부 도구가 호출되지 않거나 오류·타임아웃·결과 누락이 발생했을 때 실제 call 근거로 원인을 좁힌다.\"\nmetadata:\n product: vox.ai\n layer: architect\n status: stable\n---\n\n# troubleshoot-agent-tool\n\n제품 호출에는 [공통 실행 계약](../../references/execution-contract.md)을 적용한다. 내장/외부의 질문·음성·파일 차이는 [호스트 연결](../../references/host-adapters.md)을 따른다. 도구는 연결된 서버가 제공하는 실제 이름과 스키마를 확인한 뒤 사용한다.\n\n## 증거\n오류가 저장 시점인지 통화 실행 시점인지 구분한다. 실행 문제면 [당시 통화](../inspect-call-evidence/SKILL.md)의 도구 입력·응답·버전·관련 발화를 읽는다. tool 저장 오류면 실제 오류 필드와 `get_tool`의 현재 config(인증값은 마스킹)를 비교한다. 통화별 근거는 `list_calls`/`get_call`로 읽는다.\n\n## 원인별 행동\n| 근거 | 확인/수정 |\n| --- | --- |\n| 호출 자체가 없음 | Manual/agent 연결, 해당 조건 도달, 도구 설명과 입력 확보 여부 |\n| schema 오류 | 현재 저장 형식과 공개 스키마 비교; 같은 payload 반복 금지 |\n| 외부 4xx/5xx | 실제 method·인증 경로·입력과 외부 계약 대조; 무조건 Manual 탓으로 돌리지 않음 |\n| timeout/결과 불명 | 외부 실행 성공 여부와 지원 결과 조회 확인; 부작용 재요청 금지 |\n| 인증 오류(401/403) | 도구 인증 설정 확인; 마스킹된 값을 되돌려 쓰지 않고 새 값은 사용자가 직접 제공 |\n| 응답 성공이나 발화/저장 오해 | 반환값 사용·본문 지시·추출 설정의 연결 검토 |\n\n고객 시스템 장애면 확인한 요청과 오류를 필요한 범위로 정리한다. 비밀키·개인정보는 보고서에 노출하지 않는다. 동일한 가설·요청으로 실패만 반복하지 않고 새 근거가 없으면 미확인 원인과 필요한 진단 정보를 남긴다.\n\n수정할 곳이 확인되면 [도구 연결](../connect-agent-tools/SKILL.md), [본문 편집](../edit-manual-safely/SKILL.md), [결과 설정](../configure-call-results/SKILL.md) 중 해당 작업만 수행한다. 시험 조건과 실제 결과로 수정 효과를 확인한다.\n"
}SHA-256 of public snapshot: 2bbfe4b009cc8c0e5372cdd4674070026c88aad8c280a08142b04a1f4740a641