Dify

Dify te permet d'enregistrer des APIs externes comme Tools personnalisés que n'importe quel Agent ou workflow peut appeler. Pointe-le simplement sur la spec OpenAPI de Thunderbit.

Ajoute le Tool

1. Tools → Custom → Create custom tool
2. Schema → colle la spec OpenAPI Thunderbit (ou juste la slice /distill ci-dessous)
3. Authentication → API Key dans le Header :
   • Key : Authorization
   • Value : Bearer YOUR_API_KEY

Schéma minimal (juste /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

Utiliser dans un Agent

Dans l'Agent ou le Chatflow Dify, dépose le Tool distill dans le toolset. Exemple de prompt :

"Quand l'utilisateur pose une question sur une URL, appelle distill et réponds en te basant sur le Markdown retourné."

Utiliser dans un Workflow

Pour l'ingestion type RAG : nœud Knowledge ← distill.data.markdown ← input URL du nœud Start. Pour le batch, remplace par /batch/distill et ajoute un nœud Loop qui poll /batch/{jobId} jusqu'à COMPLETED.

Liens connexes

• Référence API
• Base de connaissances RAG
• Flowise