Dify

Dify permite registrar APIs externas como Custom Tools que qualquer Agent ou workflow pode chamar. Basta apontá-lo para a especificação OpenAPI da Thunderbit.

Adicione a Tool

1. Tools → Custom → Create custom tool
2. Schema → cole a especificação OpenAPI da Thunderbit (ou apenas o trecho /distill abaixo)
3. Authentication → API Key no Header:
   • Key: Authorization
   • Value: Bearer YOUR_API_KEY

Schema mínimo (apenas /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

Use em um Agent

No Agent ou Chatflow do Dify, coloque a Tool distill no toolset. Exemplo de prompt:

"Quando o usuário perguntar sobre uma URL, chame distill e responda com base no Markdown retornado."

Use em um Workflow

Para ingestão estilo RAG: nó Knowledge ← distill.data.markdown ← input de URL no nó Start. Para batch, troque por /batch/distill e adicione um nó Loop que faz polling em /batch/{jobId} até COMPLETED.

Relacionados

• Referência da API
• Base de Conhecimento RAG
• Flowise