Добици:
- Бити у стању да безбедно користи вештачку интелигенцију у изради белог папира, НатСпец-а, технички једноставног превода и откривања ризика и разумевања да је ово најпродуктивнија област.
- Могућност верификације сваке техничке тврдње са стварним кодом и уклањање претеривања и језика гаранције како би се избегао ризик од нетачне документације
- Способност искреног прихватања ризика, упозорење 'не финансијски савет' и доследност кода документације
Документација у Веб3 није луксуз, већ ствар сигурности и поверења. Интеракцијом са паметним уговором, корисник ризикује свој прави новац; Ако не разуме шта ради, отворен је за превару. Ревизор не може безбедно да прегледа код који није добро документован. У овој јединици покривамо област у којој је АИ најпоузданија и најефикаснија: документација и техничко писање. Од беле књиге до коментара у коду, од корисничког водича до откривања ризика, вештачка интелигенција је овде прави множилац силе — све док се прецизност хумано прати.
Врсте Веб3 документације
- Вхитепапер / литепапер: Основни документ који описује визију, механизам и токеномију пројекта.
- Техничка документација: Уговорни интерфејси, водич за интеграцију за програмере.
- НатСпец (Спецификација природног језика Етхереум — Стандардни формат коментара у коду у Солидити-у који описује шта функције раде): Документација уграђена у код, коју читају и људи и алат.
- Упутство за употребу: Обичан текст који крајњем кориснику говори „како да користи, који ризици постоје“.
- Одрицање од одговорности: Законски и етички обавезна упозорења.
Чест проблем код ових типова: програмери не воле да пишу и често то остављају за последњи тренутак. АИ попуњава управо ову празнину.
Зашто је документација најбезбеднија област вештачке интелигенције
Цена грешке у документацији је нижа него у ревизији: једна нетачна реченица се исправља, новац не лети (директно). Поред тога, вештачка интелигенција је природно јака у производњи језика. Дакле, АИ је овде и ефикасан и релативно сигуран. Али остају два критична ризика:
- Лажна техничка тврдња: АИ може погрешно представити шта код ради; Ово обмањује корисника и може постати безбедносна рањивост (осим ако не пише „ова функција штити ваша средства“, а не).
- Хипербола/маркетиншки језик: АИ може произвести језик који чини да пројекат изгледа безбедно или профитабилно; Ово је и етички и правни проблем.
Опрез: Документација описује код; То није сам код. Свака техничка тврдња коју АИ запише („ово се дешава“, „које одржава“) мора бити верификована у односу на стварни код. Нетачна документација може бити опаснија од исправног кода јер корисник верује документацији.
Слојеви коришћења АИ у документацији
1. НатСпец генерација. АИ чита постојећу функцију и прави НатСпец интерпретацију: шта ради, који су њени параметри, шта враћа. Ово поједностављује преглед и одржавање.
2. Техничко-једноставан превод. АИ преводи сложени механизам на језик који крајњи корисник може да разуме — једну од највећих потреба Веб3.
3. Преглед и структура Беле књиге. АИ производи скелет и делове беле књиге; Тачност садржаја је људска.
4. Вишејезичност и прилагођавање нивоа. АИ може да произведе исти садржај, технички и једноставан, и на турском и на енглеском.
Слаби промпт / Јаки промпт
Слабо обавештење:
Напишите белу књигу за овај пројекат.
АИ прави преувеличану, вероватно лажну и маркетиншки испуњену копију без познавања стварног механизма.
Снажан упит:
Ваша улога: Веб3 технички писац. Испод је ПРАВИ механизам, токеномика и код пројекта. Напишите нацрт беле књиге искључиво на основу ових информација. Правила: - Не претерујте, НЕ користите фразе као што су "загарантован профит", "потпуно безбедан" итд. - Засновајте сваку техничку тврдњу на механизму који дајем; Немојте додавати измишљотине.- Додајте одељак „Ризици“ који јасно наводи ризике.- Додајте упозорење „Ово није финансијски савет“. Означите све информације у које нисте сигурни или које ја немам као [ТО БЕ ФИЛЛЕД].
Четири шаблона за копирање
1) НатСпец генерација:
Напишите стандардне НатСпец коментаре на следећу функцију: @нотице (шта ради, обично), @дев (техничка напомена), @парам и @ретурн. Напишите само оно што код СТВАРНО ради; Додавање понашања које није у коду. Означите ефекат за који нисте сигурни.
2) Технички-једноставан превод:
Објасните овај механизам на једноставном турском језику који корисник почетник може да разуме: шта ради, шта корисник треба да уради, КОЈИ РИЗИЦИ постоје? Претеривање; нема гаранције сигурности. Не скривајте ризике, извуците их у први план.
3) Одељак за ризик/упозорење:
Напишите искрен одељак „Ризици и упозорења“ за овај пројекат: ризик паметног уговора, тржишни ризик, ризик ликвидности, регулаторна неизвесност, кључни губитак. Објасните сваки ризик једноставним језиком. Не потцењујте ризике; завршити са „ово није финансијски савет“.
4) Провера доследности кода документације:
Испод је функција и њена доступна документација. Означите места где је документ у супротности или изоставља СТВАРНО понашање кода. Доношење коначне одлуке; Пошаљите га на "верификацију програмера".
Три мини кофера (у бројевима)
Случај 1 — НатСпец је појачао инспекцију. Један тим је доставио уговор са 25 функција на разматрање без коментара; Ревизор је тражио додатно време да разуме логику. Тим је направио НатСпец нацрте са АИ и сваки потврдио кодом; Припрема ревизије је скраћена за скоро 1 дан. Поука: добра документација смањује трошкове ревизије.
Случај 2 — Лажна тврдња ухваћена. У корисничком приручнику који је ИЗ произвео је наведено да „ваша средства могу бити повучена у било ком тренутку“; док је уговор био закључан од 7 дана. Технички преглед је ово открио. Да је објављен, корисници би били у заблуди и били би жртве. Поука: свака техничка тврдња је потврђена кодом.
Случај 3 — Претеривање је разјашњено. У првом нацрту беле књиге, АИ је користио изразе као што су „висок принос без ризика“. Тим је ово уклонио и додао одељак о поштеном ризику. Ово је заштитило пројекат и етички и правно. Поука: маркетиншка пристрасност АИ мора бити ревидирана.
Етичко оптерећење документације
Веб3 документација се чита у контексту у којем корисник ризикује свој новац. дакле:
- Искреност: Ризици се не могу сакрити и не могу се дати преувеличана обећања.
- Тачност: Техничке тврдње морају одговарати коду; „Документ тако каже“ није одбрана, већ лажно представљање.
- Приступачност: Писање на језику који корисник заиста разуме је безбедносна мера; Документ који се не разуме је позив на превару.
- Одрицање од одговорности: Треба јасно рећи да то није финансијски савет и регулаторна несигурност.
Савет: Тест искрености Веб3 документа: „Ако корисник уложи новац у поверење само овом документу, да ли ће се осећати превареним када се суочи са истином?“ Увек нека АИ истакне део ризика, а не да га закопа на крају.
Уобичајене грешке
- Не потврђује техничку тврдњу са кодом. Погрешан документ обмањује корисника.
- Одбацивање хипер/маркетиншког језика. Етички и правни ризик.
- Минимизирање или скривање ризика. Кршење поверења.
- Штампање белог папира без давања правог механизма АИ. Производи измишљотине.
- Игнорисање упозорења „није финансијски савет“. Правна обавеза.
- Не усклађивање документације са кодом. Када се шифра промени, документ постаје погрешан.
Укратко
- Документација је питање сигурности и поверења у Веб3; То је најпродуктивније поље АИ.
- Цена грешке је релативно ниска, али лажне техничке тврдње и претеривање представљају озбиљан ризик.
- Свака техничка тврдња мора бити потврђена правим кодом; Документ не замењује шифру.
- Ризици треба да буду написани искрено и истакнуто; Претеривање и језик гаранције треба уклонити.
- „То није финансијски савет“ и регулаторна упозорења су обавезна.
Задатак апликације
Набавите функцију паметног уговора. Дајте АИ промпт „Генерате НатСпец“ и упоредите генерисану интерпретацију ред по ред са стварним понашањем кода — има ли неслагања? Затим направите „технички обичан превод“ и „одељак о ризику/упозорењу“ за исту функцију. Пронађите и исправите најмање једну изјаву АИ која је преувеличана или је у супротности са кодом.
контролна листа
- [ ] Потврдио сам сваку техничку тврдњу стварним кодом.
- [ ] Уклонио сам претеривања/гаранције.
- [ ] Написао сам ризике искрено и истичући их.
- [ ] Дао сам АИ прави механизам; Нисам му дозволио да то измисли.
- [ ] Додао сам упозорење „Ово није финансијски савет“.
- [ ] Написао сам НатСпец у потпуности за возило и контролу.
- [ ] Планирао сам да задржим документацију у синхронизацији са кодом.