Date occhi ai vostri agent Dify
Dify collega modelli, memoria e logica. Non legge un file Word, non renderizza onestamente una pagina in JavaScript e non vi avverte quando una richiesta è tornata come muro anti-bot. Questo plugin aggiunge sei tool che lo fanno, e ogni lettura di pagina porta un punteggio render_quality: una lettura fallita diventa visibile nel workflow invece di essere riassunta in silenzio.
Cosa Dify non sa fare da solo
Dify include un nodo HTTP Request e alcuni tool integrati. Quattro cose restano comunque a voi, e il plugin le copre tutte.
Qualcuno carica un file Word o PDF
Convert File to Markdown accetta direttamente un file Dify e restituisce testo pulito, pronto per un modello o una knowledge base.
La pagina si renderizza in JavaScript
Perceive URL avvia un browser vero e restituisce la pagina stabilizzata, non il guscio vuoto che recupera un nodo HTTP.
Costruire a mano auth e multipart in un nodo HTTP
Una sola credenziale, inserita una volta. Ogni tool invia la chiave e interpreta la risposta al posto vostro.
Non sapere se la lettura è riuscita
render_quality da 0.0 a 1.0 a ogni lettura, così un ramo condizionale può riprovare o fermarsi invece di passare un banner sui cookie a un modello.
Sei tool, una credenziale
Ogni tool compare nel selettore di Dify e funziona sia negli agent sia nei workflow. Chiamano la stessa API REST di CLI, SDK e server MCP, quindi quota del piano e rate limit valgono esattamente come altrove.
Perceive URL
Renderizza una pagina in markdown, HTML, screenshot, PDF, link, immagini o dati strutturati, con il punteggio di qualità allegato.
POST /v2/perceiveWeb Search
Cerca su web, notizie, immagini, accademico, brevetti o mappe e restituisce risultati ordinati su cui agisce il nodo successivo.
POST /v2/lookupDiscover URLs
Elenca un sito da sitemap, crawl o entrambi, con pattern di inclusione ed esclusione, prima di spendere rendering su pagine che non volete.
POST /v2/discoverExtract Structured
Passate uno schema JSON o una mappa piatta di campi e ricevete dati tipizzati per URL, da un elenco esplicito o da un sito che l’API esplora per voi.
POST /v2/distillConvert File to Markdown
Accetta un file Dify, non un URL, così un file caricato in chat o prodotto da un nodo precedente si converte sul posto.
POST /v1/convert/anything-to-markdownConvert File to PDF
Lo stesso input file, convertito in PDF quando un workflow deve restituire un documento vero a una persona.
POST /v1/convert/anything-to-pdf
Installare, poi incollare una chiave
Il plugin non contiene alcuna chiave e non chiama nulla al di fuori dell’API EnConvert. Ognuno fornisce la propria chiave privata quando aggiunge il tool.
Installare da GitHub
In Dify aprite Plugin, scegliete Installa plugin, selezionate GitHub e incollate l’URL del repository. Scegliete l’ultima versione e verificate i permessi.
Creare una chiave privata
Generate una chiave nella dashboard EnConvert. Le chiavi private iniziano con sk_. Quelle pubbliche pk_ servono ai widget del browser e qui vengono rifiutate.
Autorizzare il tool
Incollate la chiave nel campo credenziale del plugin. La connessione la valida con una chiamata whoami, così una chiave sbagliata fallisce in quel momento e non durante un’esecuzione.
Aggiungere un tool a un agent o workflow
I sei tool compaiono nel selettore. Collegatene uno a un agent come tool richiamabile, oppure inseritelo in un workflow come nodo.
Su un Dify self-hosted con verifica della firma attiva, un plugin installato fuori dal Marketplace viene rifiutato con un errore di firma. Impostate FORCE_VERIFYING_SIGNATURE=false in docker/.env e riavviate i container, oppure attendete la scheda sul Marketplace.
Quattro workflow che valgono la pena
Ognuno sta in pochi nodi. Il plugin copre la parte per cui Dify non ha risposta.
Costruire una knowledge base da un sito
- Discover URLs
- Perceive URL
Discover elenca il sito, perceive renderizza ogni pagina in markdown, e il risultato alimenta una knowledge base di Dify.
Un agent che si documenta prima di rispondere
- Web Search
- Perceive URL
La ricerca trova le fonti, perceive legge le più promettenti, e l’agent risponde da pagine che ha letto davvero.
Trasformare un documento caricato in una risposta
- Convert File to Markdown
Qualcuno lascia un PDF o un Word in chat, convert restituisce markdown, e il modello lavora su testo vero.
Sorvegliare le pagine dei concorrenti
- Extract Structured
Extract estrae periodicamente gli stessi campi tipizzati, così un cambio di prezzo o di formulazione diventa un valore confrontabile.
Domande frequenti
Aggiungete i tool al vostro prossimo workflow
Installate dalla release, incollate una chiave, e i sei tool compaiono nel selettore per ogni agent e workflow dello spazio di lavoro.