통합
Dify
OpenAPI 스키마를 가져와 Thunderbit를 Dify의 커스텀 도구로 추가
Dify 는 외부 API 를 어떤 Agent 나 워크플로에서나 호출 가능한 커스텀 도구 로 등록할 수 있게 해 줍니다. Thunderbit 의 OpenAPI 스펙을 가리키기만 하면 됩니다.
도구 추가
- Tools → Custom → Create custom tool
- Schema → Thunderbit OpenAPI 스펙 을 붙여넣거나, 아래
/distill슬라이스만 붙여넣기 - Authentication → Header 의 API Key:
- Key:
Authorization - Value:
Bearer YOUR_API_KEY
- Key:
미니멀 스키마 (/distill 만)
openapi: 3.0.0
info: { title: Thunderbit, version: "1" }
servers:
- url: https://openapi.thunderbit.com/openapi/v1
paths:
/distill:
post:
operationId: distill
summary: Fetch a URL and return clean Markdown
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [url]
properties:
url: { type: string, format: uri }
renderMode: { type: string, enum: [basic, advanced], default: basic }
responses:
"200":
description: OKAgent 에서 사용
Dify 의 Agent 또는 Chatflow 에서 distill Tool 을 toolset 에 끌어다 놓으세요. 프롬프트 예시:
"사용자가 URL 에 대해 물으면
distill을 호출하고 반환된 Markdown 을 근거로 답하라."
워크플로에서 사용
RAG 스타일 수집의 경우 Knowledge 노드 ← distill.data.markdown ← Start 노드 URL 입력. 배치라면 /batch/distill 로 교체하고 COMPLETED 까지 /batch/{jobId} 를 폴링하는 Loop 노드를 추가하세요.