Userdoc是一個(gè)AI輔助服務(wù)，可以幫助創(chuàng)建軟件需求文檔。在最近舉行的AI工程師峰會(huì)上，筆者與Userdoc的創(chuàng)始人Chris Rickard進(jìn)行了交流。

譯自 AI for Dev Tools: Create Software Requirements with Userdoc 。

AI編碼工具現(xiàn)已成為軟件開發(fā)的標(biāo)準(zhǔn)配置，但生成式AI的應(yīng)用也在向開發(fā)流程的其他方面擴(kuò)散。Userdoc是一個(gè)初創(chuàng)公司，他們開發(fā)了一個(gè)AI輔助服務(wù)，用于定義軟件需求。在上周于舊金山舉行的AI工程師峰會(huì)上，筆者與Userdoc的聯(lián)合創(chuàng)始人兼首席開發(fā)者Chris Rickard進(jìn)行了交流，探討他創(chuàng)建Userdoc的初衷，以及它將如何幫助開發(fā)者。

在一個(gè)新項(xiàng)目中，確定軟件將要實(shí)現(xiàn)的功能以滿足一個(gè)或多個(gè)“用戶角色(personas)”的需求，通常是第一步。

“構(gòu)建優(yōu)秀軟件的關(guān)鍵之一，是定義準(zhǔn)確的需求，以確保開發(fā)的方向正確。”Rickard表示，“我很感興趣AI如何促進(jìn)這個(gè)過程，幫助發(fā)現(xiàn)可能導(dǎo)致漏洞的問題所在；更糟的是，發(fā)現(xiàn)巨大的系統(tǒng)功能其實(shí)并未解決原始問題，或者根本就不需要?！?/p>

Userdoc

Userdoc允許用戶先輸入業(yè)務(wù)相關(guān)的背景信息，作為AI理解需求的上下文。Rickard向我演示了一個(gè)例子，一個(gè)雜貨配送企業(yè)使用Userdoc為配送員定義需求。在這樣的場(chǎng)景下，AI可以對(duì)開發(fā)者構(gòu)建系統(tǒng)提供一定的“監(jiān)督”作用。

“在這個(gè)例子里，人工智能就像一個(gè)業(yè)務(wù)分析師，”Rickard說，“它理解相關(guān)變更的其他影響。”

直接用ChatGPT定義需求有何不同?

這一切聽起來不錯(cuò)，但是相比直接使用ChatGPT，Userdoc的AI生成軟件需求有什么不同呢?

Rickard回答說，ChatGPT存在“編造信息”的風(fēng)險(xiǎn)。他補(bǔ)充說，Userdoc使用GPT-4作為底層技術(shù)，但是業(yè)務(wù)背景才是關(guān)鍵。

“所以，當(dāng)我們與GPT-4交互時(shí)，”他說，“我們提供系統(tǒng)的所有其他相關(guān)信息作為上下文。”

他承認(rèn)，ChatGPT也可以實(shí)現(xiàn)類似的功能，但需要構(gòu)建一個(gè)“巨大的提示”，才能得到與Userdoc類似的響應(yīng)。

每個(gè)Userdoc項(xiàng)目通常包含一系列“用戶故事”，這些故事對(duì)應(yīng)軟件中的各項(xiàng)功能。如果一個(gè)系統(tǒng)有成百上千的功能，事情就會(huì)變得非常復(fù)雜，這正是Userdoc試圖解決的痛點(diǎn)之一。

“我們這里試圖解決的一個(gè)大問題是，”Rickard說，“當(dāng)一個(gè)系統(tǒng)擁有繁雜的功能時(shí)，[開發(fā)人員]需要考慮和記憶很多細(xì)節(jié)；軟件成本和進(jìn)度超支的一個(gè)重要原因，是人們?cè)谇捌跊]有把這些小細(xì)節(jié)想清楚?！?/p>

Userdoc的使用

創(chuàng)建一個(gè)新的Userdoc項(xiàng)目，需要通過向?qū)л斎胗脩粜畔⒑透鞣N需求目標(biāo)。這個(gè)設(shè)置工作通常由產(chǎn)品負(fù)責(zé)人、產(chǎn)品經(jīng)理和業(yè)務(wù)分析師完成，之后項(xiàng)目移交給開發(fā)團(tuán)隊(duì)。但Rickard表示，Userdoc也可以直接幫助開發(fā)者。

“一旦特征和需求確定后，[...]可以和項(xiàng)目管理工具集成。它可以連接到Jira、Azure DevOps等，與工作項(xiàng)的待辦、進(jìn)行中、已完成狀態(tài)保持同步，這樣就能隨時(shí)查看每個(gè)功能的詳細(xì)信息?！?/p>

Userdoc 向?qū)?/span>

Rickard指出，在某些情況下，開發(fā)人員也參與需求的確定。所以開發(fā)者如何使用Userdoc，需要根據(jù)具體業(yè)務(wù)需求來決定。在返回項(xiàng)目后，它也是一個(gè)很好的參考。

“我們與許多有大量并行項(xiàng)目的機(jī)構(gòu)合作，”他說，“開發(fā)人員和設(shè)計(jì)師在項(xiàng)目后期返回時(shí)，就可以通過Userdoc快速了解當(dāng)前需實(shí)現(xiàn)的功能?！?/p>

Rickard還說，Userdoc中的信息也可以成為系統(tǒng)的“活文檔”。

“如果一開始就用相當(dāng)詳細(xì)的需求，并持續(xù)更新，作為業(yè)務(wù)可以參考的唯一版本，那么它就成為了[軟件系統(tǒng)]的準(zhǔn)確信息來源?！?/p>

考慮 LangChain

既然我們?cè)贏I工程師峰會(huì)上交流，我想了解Rickard是否有使用AI工程界當(dāng)前熱門的工具。由于Userdoc使用GPT-4，我問他是否將LangChain作為與OpenAI模型通信的中間層？

“我在Userdoc第一個(gè)原型中確實(shí)用了LangChain幾周，”他說，“但后來想更清楚背后運(yùn)行的細(xì)節(jié)，這對(duì)我理解其中的區(qū)別很有幫助。LangChain無疑很強(qiáng)大，但是它的優(yōu)勢(shì)在于提供了處理某些任務(wù)的便捷方法，如將文檔分塊，將其發(fā)送給LLM，并提出問題。我同時(shí)學(xué)習(xí)LLM和LangChain時(shí)，很難區(qū)分兩者的邊界。所以我自己編寫了一套與GPT-4交互的組件。”

Userdoc的擴(kuò)展

如果Userdoc隨時(shí)間沉淀可以成為軟件文檔的源頭，那么它是否也可以用來為客戶提供幫助聊天機(jī)器人(例如，為那個(gè)雜貨配送服務(wù))？

“答案是肯定的，”Rickard說，“主要考量是內(nèi)部知識(shí)和外部公開的區(qū)分，以及人們的信息安全意愿?！?/p>

他指出，Userdoc目前是自舉的，如果擴(kuò)充團(tuán)隊(duì)，他更希望從事軟件合規(guī)方面的工作。所以他情愿朝這個(gè)方向發(fā)展，而不是重復(fù)做網(wǎng)站和App的客戶聊天機(jī)器人。

“我非常認(rèn)同這個(gè)理念，確保軟件開發(fā)真正實(shí)現(xiàn)業(yè)務(wù)最初同意的需求，”他解釋說，“開發(fā)者現(xiàn)在可以使用各種自動(dòng)化測(cè)試，我希望AI可以增強(qiáng)這個(gè)驗(yàn)證過程?！?/p>