Kako uporabljati Dify: Praktični vodnik za hitro izgradnjo aplikacij in agentov z umetno inteligenco
Če ste si kdaj želeli izdelati klepetalnega robota z umetno inteligenco, ki je pripravljen za uporabo v produkciji, sistem za vprašanja in odgovore s povečano možnostjo pridobivanja (retrieval-augmented QA system) ali avtomatiziranega agenta, ne da bi se spopadali s kompleksno kodo, je Dify ustvarjen za vas. Združuje vizualni graditelj poteka dela, upravljanje pozivov, RAG (retrieval-augmented generation) in integracije orodij v eno poenostavljeno platformo. V tem praktičnem, na rešitve usmerjenem vodniku boste natančno spoznali, kako uporabljati Dify – od prve prijave do uvedbe dovršene aplikacije z umetno inteligenco.
Omeniti velja: Dify se pozicionira kot vodilna platforma za razvoj agentne umetne inteligence z delovnimi tokovi »povleci in spusti« ter predlogami aplikacij, ki dramatično pospešijo čas do vrednosti. Če imate raje praktičen sprehod skozi postopek, so na voljo dobri vadnice, primerne za začetnike, ki prikazujejo celovite gradnje za klepetalnice in asistente s podatkovno bazo, poleg tega pa še vodniki, ki jih ureja skupnost, za obvladovanje osnovnih blokov, kot so vozlišča HTTP in obravnavanje JSON. Za strukturirano izkušnjo predstavitvenega projekta je na voljo tudi podrobna vadnica.
V tem vodniku bomo obravnavali:
- Kaj je Dify in kje blesti
- Nastavitev vašega delovnega prostora in ključev
- Izdelava vaše prve aplikacije (klepetalni robot in RAG asistent)
- Vizualni poteki dela, orodja in povezovalniki
- Agenti in večstopenjsko sklepanje
- Evalvacija, opazovanje in iteracija
- Najboljše prakse uvajanja in delovni tokovi ekipe
Vključili bomo tudi praktične nasvete, pogoste pasti in vzorce, ki prihranijo čas – tako da boste lahko hitreje in samozavestneje izvedli prenos.
Kaj je Dify in zakaj ga uporabljati?
Dify je platforma z malo/brez kode za sestavljanje aplikacij z umetno inteligenco prek vizualnega platna z vgrajeno orkestracijo pozivov, obravnavanjem stanja, RAG in zmogljivostmi agentov. Dramatično zmanjša delo s cevmi in vam pomaga:
- Izdelati klepetalnice, asistente in večstopenjske avtomatizacije
- Izvajati Retrieval-Augmented Generation (RAG) z lastno bazo znanja
- Integrirati orodja (spletno iskanje, API-ji, baze podatkov) brez kode po meri
- Iterirati pozive, slediti uspešnosti in opazovati sledi od začetka do konca
Vizualni poteki dela in predloge aplikacij Dify so še posebej privlačni za ekipe, ki morajo hitro izdelati prototipe in se razvijati proti produkciji. Vadnice in predstavitve tretjih oseb vam lahko pomagajo, da hitro preidete od ničle do delujoče aplikacije, pogosto pa se uporablja tudi za agentne vzorce s pridobivanjem podatkov. Integracije opazovanja so na voljo tudi, ko ste pripravljeni na ocenjevanje in skaliranje.
Hiter začetek: račun, modeli in ključi
- Ustvarite svoj delovni prostor Dify
- Prijavite se in ustvarite nov delovni prostor.
- Izberite oblak (najhitreje) ali se pripravite na samostojno gostovanje pozneje, če potrebujete popoln nadzor.
- Dodajte ponudnike modelov
- V nastavitvah se povežite z želenimi LLM-ji (npr. OpenAI, Anthropic itd.).
- Varno dodajte ključe API. Preizkusite z majhnimi pozivi, da potrdite povezljivost.
- Organizirajte svoj projekt
- Ustvarite novo aplikacijo ali potek dela. Jasno jo poimenujte (npr. »RAG za podporo strankam« ali »Agent za kvalifikacijo potencialnih strank«).
- Odločite se za prvo stvaritev: klepetalnica, notranje orodje ali agent.
Nasvet: Začnite z osnovnim modelom za hitro iteracijo, nato pa kasneje zamenjajte z naprednimi modeli.
Izdelajte svojo prvo klepetalno aplikacijo v nekaj minutah
Tukaj je preprost način za izgradnjo koristnega klepetalnega asistenta.
- V galeriji aplikacij izberite predlogo »Klepet«. To zagotavlja sporočilno ogrodje izven škatle.
- Pripravite svoj sistemski poziv
- Določite vlogo, ton, meje in obliko izhodnih podatkov. Primer:
»Ste jedrnat, prijazen pomočnik za izdelke. Vedno navedite vire, uporabite točke za korake in postavite eno pojasnilno vprašanje, če je zahteva uporabnika nejasna.«
- Dodajte primere obratov (spodbujanje z nekaj posnetki)
- Pokažite vzorčne pare vprašanj in odgovorov, da spodbudite dosledno vedenje.
- Naj bodo kratki in reprezentativni.
- Uporabite vgrajen preizkuševalnik klepeta za preizkušanje resničnih poizvedb.
- Prilagodite sistemski poziv za slog in temperaturo za ustvarjalnost.
- Po potrebi določite zaporedja zaustavitve, največje število žetonov in filtre vsebine.
- Omogočite povezavo za skupno rabo aplikacije ali jo vdelajte prek pripomočka.
Učenje z delom je najhitrejše – video posnetki vam lahko pomagajo vizualizirati vsak klik.
Pretvorite ga v RAG asistenta (klepet, ki se zaveda znanja)
RAG omogoča vašemu asistentu, da odgovarja z vašimi zasebnimi dokumenti, pogostimi vprašanji ali vsebino wiki.
- Ustvarite nabor podatkov (bazo znanja)
- Naložite datoteke PDF, markdown ali se povežite z virom podatkov.
- Dify bo razdelil, vdelal in indeksiral vašo vsebino.
- Prilagodite razdeljevanje in vdelavo
- Izberite model vdelave in velikosti delov. Večji deli ohranjajo kontekst; manjši deli izboljšajo zrnatost. Začnite s 400–800 žetoni.
- Konfigurirajte pridobivanje
- Izberite top-k rezultate (npr. 4–8), prag relevantnosti in izbirno prerazvrščanje.
- Dodajte filtre (npr. po oznaki ali vrsti dokumenta) za natančnost.
- Povežite pridobivanje v aplikacijo
- Uporabite platno poteka dela ali stikalo RAG aplikacije, da vstavite pridobljeno vsebino v poziv. V končno predlogo odgovora vključite citate.
- Preizkusite z resničnimi vprašanji
- Preizkusite preproste in zapletene poizvedbe. Preverite citate, oblikovanje in zakasnitev.
Če uporabljate vektorsko bazo podatkov, kot je Milvus, so na voljo podrobni vodniki za integracijo Dify za robustne RAG cevovode.
Vizualni poteki dela: avtomatizirajte večstopenjsko logiko
Difyjevo platno vam omogoča veriženje korakov, razvejanje logike in klicanje orodij.
Pogosti bloki:
- Vhod/izhod: določite shemo za dohodne uporabniške podatke in končni odgovor.
- Vozlišče LLM: oblikujte pozive, nastavite modele, nadzirajte temperaturo.
- Vozlišče za pridobivanje: poizvedujte po svojih naborih podatkov.
- Vozlišče HTTP: kličite zunanje API-je (iskanje, CRM, notranje storitve).
- Vozlišče kode: izvajajte lahke transformacije, razčlenjevanje ali validacijo.
- Pogoj/veja: usmerjajte poti glede na namen uporabnika ali podatke.
Primer: Asistent za spletno raziskovanje
- Zaznavanje namena → Če je »raziskava«, pokličite vozlišče HTTP za iskanje → Povzemite rezultate z LLM → Vrnite ugotovitve v točkah z viri.
Za konkretne nasvete o povezovanju vozlišč HTTP in razčlenjevanju odzivov JSON so uporabne vadnice skupnosti.
Agenti: Uporaba orodij, večstopenjsko sklepanje
Agenti v Dify združujejo načrtovanje, izbiro orodij in iterativno sklepanje za dosego ciljev.
Kdaj uporabiti agente:
- Naloge potrebujejo večstopenjske načrte (»raziskava → primerjava → povzetek«).
- Asistent mora poklicati orodja: spletno iskanje, baze podatkov, kalkulatorje, notranje API-je.
- Želite, da model dinamično odloča o naslednjih dejanjih.
Izdelajte agenta:
- Določite cilj in omejitve v sistemskem pozivu.
- Registrirajte orodja (HTTP, iskanje, pridobivanje podatkov, funkcije po meri).
- Omogočite načrtovanje: dovolite modelu, da predlaga korake in kritizira svoje delo.
- Nastavite največje število korakov, časovne omejitve in proračune orodij.
- Preizkusite z različnimi nalogami in opazujte sledi, da diagnosticirate zanke.
Če vaša uporaba zahteva natančno pridobivanje spletnih podatkov, lahko Dify povežete s specializiranimi podatkovnimi vtičniki, da obogatite zmogljivosti agenta.
Povezovalniki in orodja: Vključite svoj nabor orodij
Dify se integrira z zunanjimi storitvami prek povezovalnikov in vozlišč HTTP:
- Spletno iskanje, strganje ali API-ji znanja
- CRM-ji in službe za pomoč uporabnikom (npr. Salesforce, Zendesk)
- Notranje končne točke REST/GraphQL
- Vektorske shrambe in podatkovna skladišča
Najboljše prakse:
- Normalizirajte odzive v JSON in preverite sheme.
- Ohranite opise orodij jedrnate, da bo model vedel, kdaj jih uporabiti.
- Dodajte omejitve hitrosti in poskuse.
Inženiring pozivov v Dify
Naj bodo pozivi modularni in preizkušljivi:
- Uporabite spremenljivke za vnos uporabnika, pridobljeno vsebino in izhode orodij.
- Standardizirajte obliko izhodnih podatkov z JSON ali točkovnimi seznami za nadaljnje razčlenjevanje.
- Zagotovite navodila po korakih (npr. »Razmišljajte v oštevilčenih korakih«), da zmanjšate napake.
- V sistemski poziv vključite politike zavrnitve in vodnike za slog.
Iteracijska zanka:
- Dodajte testni niz reprezentativnih pozivov.
- Izvedite ocenjevanja serij in primerjajte nastavitve modela.
- Zabeležite primere neuspeha in ustvarite nove primere ali veje.
Opazovanje, testiranje in optimizacija
Ko preidete iz prototipa v pilotno fazo, sta opazovanje in sledenje pomembna. Dodate lahko sledenje, da si ogledate uporabo žetonov, zakasnitve in odločitve po korakih za odpravljanje napak in izboljšanje kakovosti.
Ključni pregledi pred lansiranjem:
- Stopnja halucinacij z in brez RAG
- Proračun za zakasnitev na zahtevo in na klic orodja
- Mejni primeri: prazen vnos, dolg vnos, poizvedbe, ki niso povezane s temo
Uvajanje uporabnikom
Dify podpira več poti uvajanja:
- Delite gostovan uporabniški vmesnik za klepet za notranje testiranje
- Vdelajte pripomoček na svojo spletno stran ali izdelek
- Izpostavite končno točko API za klic vaše aplikacije
Operativni nasveti:
- Dodajte analitiko: seje, CSAT, stopnje povratnih informacij
- Predpomnite pogoste odgovore in vnaprej pridobite pridobivanje
- Nastavite opozorila za časovne omejitve in napake modela navzgor
Sodelovanje in upravljanje ekipe
Ko vaša aplikacija raste:
- Uporabite kontrole dostopa na podlagi vlog in ločene dev/staging/prod
- Različice pozivov/potekov dela; označite izdaje
- Ustvarite priročnik za incidente in izpade orodij
- Dokumentirajte pogodbe o orodjih (vhodi/izhodi) in SLA-je
Napredni vzorci, ki jih lahko preizkusite naslednje
- Klic funkcije s strogimi shemami JSON za strukturirane izhode
- Hibridno iskanje (BM25 + vdelave) za boljši priklic
- Večvektorski RAG (naslov, telo, vdelave metapodatkov)
- Prerazvrščanje za izboljšanje natančnosti izrezkov
- Zanke samorefleksije za zapletene naloge
- Zaščitne ograje z validacijo regex ali sheme JSON
Odpravljanje težav: Pogoste pasti in popravki
- Agent se ponavlja ali traja predolgo
- Zmanjšajte največje število korakov, poostrite opise orodij, dodajte pogoje zaustavitve.
- Nepomembni izrezki za pridobivanje
- Prilagodite razdeljevanje, dodajte filtre metapodatkov, poskusite prerazvrstiti, prilagodite top-k.
- Neurejeni ali nedosledni izhodi
- Uveljavite shemo JSON, dodajte primere, zmanjšajte temperaturo.
- Predpomnite pridobivanje, vzporedno kličite orodja, preklopite na hitrejše modele.
- Okrepite sistemske omejitve, vedno navedite vire, dajte prednost korakom RAG in preverjanja.
Mimogrede: pospešitev potekov dela z vsebino
Če je vaš cilj ideja za vsebino, priprava in sinteza raziskav, je vredno omeniti, da se asistenti, ustvarjeni z Dify, lepo ujemajo z orodji za produktivnost, kot je Sider.AI, za vsakodnevno pisanje in povzemanje. Sider lahko sedi ob vašem brskalniku in vam pomaga hitro pripraviti, prevesti in analizirati vsebino; ko ga kombinirate z ozadjem RAG, ki ga poganja Dify, dobite natančen kontekst domene in gladko izkušnjo avtorstva (https://sider.ai/). Ključni zaključki
- Začnite preprosto s predlogo za klepet, nato pa dodajte RAG in orodja.
- Uporabite platno poteka dela za vizualizacijo logike in izogibanje krhki kodi.
- Obravnavajte pozive kot kodo: različice, preizkušanje in ocenjevanje.
- Opazujte vse – sledi, stroške, zakasnitve – za samozavestno skaliranje.
- Agenti so močni, vendar jih zaščitne ograje in proračuni ohranjajo zanesljive.
Dodatni viri
- Pregled in pozicioniranje Dify.
- Video vadnica, primerna za začetnike, za izgradnjo aplikacije z umetno inteligenco.
- Vodnik skupnosti za vozlišča HTTP in obravnavanje JSON.
- Strukturirana vadnica s predstavitvenim projektom.
- Izgradnja agentov z vtičniki za pridobivanje spletnih podatkov.
- Opazovanje in sledenje za aplikacije Dify.
- RAG z Dify in Milvus vodnikom.
Pogosta vprašanja
V1: Za kaj se uporablja Dify?
Dify je platforma za izgradnjo aplikacij in agentov z umetno inteligenco z uporabo vizualnih potekov dela, orkestracije pozivov in RAG. Ekipam pomaga hitro ustvariti klepetalnice, asistente znanja in avtomatizacije.
V2: Kako ustvarim klepetalnega robota RAG v Dify?
Ustvarite nabor podatkov, konfigurirajte vdelave in pridobivanje, nato pa vstavite pridobljeno vsebino v svoj poziv prek poteka dela. Preizkusite top-k, velikosti delov in prerazvrščanje, da optimizirate natančnost.
V3: Ali se lahko Dify poveže z mojimi API-ji in orodji?
Da. Uporabite vozlišča HTTP in povezovalnike za klic spletnih storitev, baz podatkov in API-jev za iskanje. Odgovore hranite v JSON in določite jasne opise orodij, da jih agent pravilno uporablja.
V4: Kako preprečim, da se moj agent ponavlja?
Zmanjšajte največje število korakov, dodajte merila za prekinitev in poostrite navodila za orodje. Opazovanje in sledenje pomagata ugotoviti, kje se pojavi zanka, da lahko prilagodite pozive in logiko orodja.
V5: Kakšen je najboljši način za oceno mojega poteka dela Dify?
Ustvarite testni niz, izvedite ocenjevanja serij in preglejte sledi za zakasnitev in stroške. Sledite halucinacijam, uveljavite strukturirane izhode in ponavljajte pozive s primeri.
