API DocsTools
툴
파이썬 툴, OpenAPI 통합, MCP 서버를 포함한 툴 관리
개요
툴 엔드포인트는 인라인 파이썬 툴, OpenAPI 서버 통합, MCP(Model Context Protocol) 서버 연결을 관리합니다. 툴을 통해 모델은 함수를 실행하고 외부 API를 호출할 수 있습니다. 모든 엔드포인트는 인증이 필요합니다.
기본 URL:
툴 관리
GET /api/v1/tools
사용 가능한 모든 툴 목록을 가져옵니다.
GETAuth required
모든 툴 목록을 가져옵니다.
응답 200
json
[
{
"id": "tool-uuid",
"name": "web_search",
"type": "api",
"description": "Search the web",
"enabled": true
}
]POST /api/v1/tools/create
새 툴을 생성합니다 (관리자 전용).
POSTAuth required
새 툴을 등록합니다.
요청 본문
json
{
"name": "custom_api",
"type": "openapi",
"description": "Call custom API endpoint",
"config": {
"openapi_url": "https://api.example.com/openapi.json",
"api_key": "sk-..."
}
}응답 200
json
{
"id": "tool-uuid",
"name": "custom_api",
"type": "openapi",
"created_at": 1700000000
}오류
| 상태 코드 | 설명 |
|---|---|
400 | 유효하지 않은 툴 설정 |
403 | 관리자 권한 필요 |
GET /api/v1/tools/{id}
툴 세부 정보를 가져옵니다.
GETAuth required
ID로 툴 설정을 가져옵니다.
응답 200
json
{
"id": "tool-uuid",
"name": "web_search",
"type": "api",
"description": "Search the web",
"config": {...}
}오류
| 상태 코드 | 설명 |
|---|---|
404 | 툴을 찾을 수 없음 |
POST /api/v1/tools/{id}/update
툴 설정을 업데이트합니다 (관리자 전용).
POSTAuth required
툴 설정을 업데이트합니다.
요청 본문
json
{
"config": {
"api_key": "sk-new-key",
"enabled": true
}
}응답 200
json
{
"id": "tool-uuid",
"config": {...}
}DELETE /api/v1/tools/{id}
툴을 삭제합니다 (관리자 전용).
DELETEAuth required
툴을 제거합니다.
응답 200
json
true툴 유형
파이썬 툴
모델이 실행할 수 있는 인라인 파이썬 함수.
OpenAPI 툴
OpenAPI 스키마를 통해 노출된 외부 API.
MCP 툴
Model Context Protocol 서버 통합.