Dify

Dify ti permette di registrare API esterne come Tool custom che qualsiasi Agent o workflow può chiamare. Basta puntarlo allo spec OpenAPI di Thunderbit.

Aggiungi il Tool

1. Tools → Custom → Create custom tool
2. Schema → incolla lo spec OpenAPI Thunderbit (o solo lo slice /distill qui sotto)
3. Authentication → API Key in Header:
   • Key: Authorization
   • Value: Bearer YOUR_API_KEY

Schema minimo (solo /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: OK

Usa in un Agent

Nel Agent o Chatflow di Dify, trascina il Tool distill nel toolset. Esempio di prompt:

"When the user asks about a URL, call distill and answer based on the returned Markdown."

Usa in un Workflow

Per ingestion stile RAG: nodo Knowledge ← distill.data.markdown ← input URL del nodo Start. Per il batch, sostituisci con /batch/distill e aggiungi un nodo Loop che fa polling su /batch/{jobId} finché COMPLETED.

Correlati

• API Reference
• RAG Knowledge Base
• Flowise