🎉 vox.ai 디스코드 커뮤니티가 새로 열렸어요! 참여하기 →
도구 생성
에이전트가 호출할 custom API 도구를 생성합니다. 모델에 노출할 input_schema와 서버가 실행할 API 설정을 함께 정의합니다.
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"input_schema": {},
"api_configuration": {
"url": "<string>",
"method": "GET",
"has_auth_credentials": true,
"timeout_seconds": 30,
"headers": {},
"auth_type": "Basic"
},
"allow_interruption_during_execution": true,
"created_at": 123,
"updated_at": 123,
"description": "<string>",
"speak_during_execution": {
"enabled": false,
"messages": [
"<string>"
]
}
}Documentation Index
Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Body
custom 도구 정의입니다. input_schema는 에이전트 모델에 노출되는 JSON Schema이고, api_configuration은 도구 실행 시 보낼 HTTP 요청을 정의합니다.
도구 생성 요청 (POST /v3/tools).
도구 이름. 영숫자, 하이픈, 언더스코어만 허용. 1~64자.
1 - 64^[a-zA-Z0-9_-]+$도구 입력 파라미터를 정의하는 JSON Schema 객체.
외부 API 호출 설정.
Show child attributes
Show child attributes
도구 설명입니다. null을 허용합니다.
실행 중 사용자에게 재생할 TTS 메시지 설정.
Show child attributes
Show child attributes
도구 실행 중 사용자 발화로 인터럽트를 허용할지 여부입니다. 기본값은 false입니다.
Response
성공 응답
도구 상세 조회/생성/수정 응답 스키마.
도구의 고유 식별자입니다.
도구 이름.
1 - 64^[a-zA-Z0-9_-]+$도구 입력 파라미터를 정의하는 JSON Schema 객체.
외부 API 호출 설정.
Show child attributes
Show child attributes
도구 실행 중 사용자 발화로 인터럽트 허용 여부.
리소스 생성 시각입니다. unix milliseconds 형식입니다.
리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.
도구 설명입니다. 설정하지 않으면 null입니다.
실행 중 TTS 메시지 설정.
Show child attributes
Show child attributes
Was this page helpful?
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"input_schema": {},
"api_configuration": {
"url": "<string>",
"method": "GET",
"has_auth_credentials": true,
"timeout_seconds": 30,
"headers": {},
"auth_type": "Basic"
},
"allow_interruption_during_execution": true,
"created_at": 123,
"updated_at": 123,
"description": "<string>",
"speak_during_execution": {
"enabled": false,
"messages": [
"<string>"
]
}
}