原文：https://cloud.tencent.com/developer/article/2456502
知識庫是一系列文檔的集合结序。一個知識庫下可以包含多個文檔障斋。注意，目前騰訊元器的智能體調(diào)用鏈路邏輯上徐鹤，如果智能體只關聯(lián)了知識庫垃环，沒有關聯(lián)插件、工作流的情況下返敬，智能體每次問答都一定會參考知識庫遂庄，不會經(jīng)過function call做意圖判斷。
工作流是一種“流程圖”式的低代碼編輯工具救赐，可以用來做一個“高級版”插件涧团。在工作流里，可以任意編排插件经磅、知識庫泌绣、大模型節(jié)點的工作順序和調(diào)用傳參，從而精確控制智能體中部分任務的運行邏輯预厌。大模型在接收到用戶問題時阿迈，如果判斷該問題需要調(diào)用工作流，則會從用戶問題里提取關鍵信息轧叽，作為工作流的入?yún)庸ぷ髁髅绮住Ｖ蟾鶕?jù)工作流運行后返回的參數(shù)刊棕，輔助回答用戶的問題。
本文以蝴蝶蘭飼養(yǎng)助手為例待逞，上傳飼養(yǎng)知識word文檔到知識庫甥角，創(chuàng)建自定義的工作流，最后使用智能體調(diào)用工作流识樱。附API方式調(diào)用智能體示例代碼嗤无。
首先創(chuàng)建知識庫
進入知識庫頁面https://yuanqi.tencent.com/my-creation/knowledge，創(chuàng)建并上傳word文檔到知識庫怜庸，內(nèi)容如下：
蝴蝶蘭当犯，作為高雅而珍貴的室內(nèi)觀賞花卉，其栽培過程對環(huán)境條件有著嚴格的要求割疾。為了確保蝴蝶蘭能夠茁壯成長并綻放出絢爛的花朵嚎卫，我們需要細致入微地調(diào)控其生長環(huán)境，特別是溫度宏榕、濕度拓诸、光照以及二氧化碳濃度這四個關鍵因素。
首先担扑，溫度是蝴蝶蘭生長的重要基石恰响。最適宜的生長溫度范圍通常在20-28攝氏度之間，而最理想的溫度則是23-25攝氏度涌献。過高或過低的溫度都會影響蝴蝶蘭的正常生理活動，甚至導致生長停滯或死亡首有。因此燕垃，在栽培過程中，我們需要密切關注室內(nèi)溫度的變化井联，并采取相應的加熱或降溫措施卜壕。
其次，濕度是蝴蝶蘭生長不可忽視的一環(huán)烙常。這種花卉喜歡濕潤的環(huán)境轴捎，相對濕度應保持在60%-80%之間。在干燥的季節(jié)或地區(qū)蚕脏，我們需要通過噴霧侦副、加濕器等方式來增加空氣濕度，以滿足蝴蝶蘭的生長需求驼鞭。
再者秦驯，光照對蝴蝶蘭的生長同樣至關重要。它們需要充足的光照來進行光合作用挣棕，但同時又不能直接暴露在強烈的陽光下译隘。因此亲桥，我們需要將蝴蝶蘭放置在光線明亮但又不直射的位置，如靠近窗戶的散光處固耘。在冬季或光照不足的情況下题篷，可以適當增加光照時長或使用植物燈來補充光照。蝴蝶蘭雖然需要光照以進行光合作用厅目，但它們對強光卻相當敏感悼凑。強光的標準可以大致定義為超過蝴蝶蘭葉片所能承受的最大光照強度，這通常會導致葉片表面溫度升高璧瞬、水分蒸發(fā)過快户辫，進而引發(fā)葉片灼傷、枯萎等問題嗤锉。具體來說渔欢，蝴蝶蘭所需的光照強度應在25000至40000勒克斯之間。在自然光條件下瘟忱，這相當于早晨或傍晚柔和的陽光奥额，或者是透過窗簾等遮蔽物的散射光。在夏季或陽光強烈的地區(qū)访诱，應避免將蝴蝶蘭直接暴露在中午的直射陽光下垫挨，可通過使用遮陽網(wǎng)、調(diào)整擺放位置或設置室內(nèi)遮光設施來降低光照強度触菜。
最后九榔，二氧化碳濃度雖然不如前三者直觀，但也是影響蝴蝶蘭生長的一個重要因素涡相。適當?shù)耐L換氣有助于保持室內(nèi)空氣的清新和二氧化碳濃度的穩(wěn)定哲泊。在密閉的室內(nèi)環(huán)境中，二氧化碳濃度可能會逐漸升高催蝗，從而影響蝴蝶蘭的光合作用和呼吸作用切威。因此，我們需要定期開窗通風丙号，保持室內(nèi)空氣的流通和新鮮先朦。二氧化碳是植物進行光合作用的重要原料之一，對于蝴蝶蘭來說也不例外犬缨。然而喳魏，與許多其他植物相比，蝴蝶蘭對二氧化碳濃度的要求并不特別高遍尺。在一般情況下截酷，空氣中的二氧化碳濃度（約為400ppm）已經(jīng)足夠支持蝴蝶蘭的正常生長。但在溫室或室內(nèi)栽培環(huán)境中，為了促進蝴蝶蘭的生長和開花迂苛，可以適當提高二氧化碳濃度三热。據(jù)研究和實踐經(jīng)驗，蝴蝶蘭在二氧化碳濃度為600至800ppm的環(huán)境下生長更佳三幻。這可以通過定期通風換氣就漾、使用二氧化碳發(fā)生器或增加室內(nèi)綠色植物數(shù)量等方式來實現(xiàn)。但需要注意的是念搬，過高的二氧化碳濃度也可能對蝴蝶蘭產(chǎn)生不利影響抑堡，因此應根據(jù)實際情況進行調(diào)整。
綜上所述朗徊，飼養(yǎng)蝴蝶蘭需要我們在溫度首妖、濕度、光照和二氧化碳濃度等方面做出全面的考慮和精心的調(diào)控爷恳。只有這樣有缆，我們才能為蝴蝶蘭提供一個適宜的生長環(huán)境，讓它們健康茁壯地成長并綻放出最美麗的花朵温亲。
其次棚壁，創(chuàng)建工作流并使用上面的知識庫
工作流概覽：
工作流詳解：
先接收用戶問題，然后經(jīng)過大模型節(jié)點判斷栈虚。大模型的提示詞：
判斷用戶問題{{STORY }}是否詢問蝴蝶蘭相關問題袖外，如果是返回“是”，否則返回“否”魂务。
示例：
如用戶問題是：“蝴蝶蘭適宜溫度”曼验，返回“是”。
如用戶問題是：“今天北京溫度头镊？”蚣驼，返回“否”。
接下來使用分支節(jié)點判斷大模型返回“是”還是“否”相艇。
如果返回“是”，則調(diào)用知識庫節(jié)點纯陨，注意知識庫選擇剛才創(chuàng)建的“溫室養(yǎng)花”坛芽。
最后在結(jié)束節(jié)點進行輸出。
接下來調(diào)試工作流翼抠，調(diào)試通過后咙轩，可以發(fā)布該工作流。
發(fā)布需要審核阴颖，請等待幾分鐘活喊，發(fā)布成功顯示“已發(fā)布”。
最后我們創(chuàng)建智能體
智能體的設置如下：
注意：我們在工作流區(qū)域選擇了自定義工作流“花卉飼養(yǎng)”量愧。
測試通過后钾菊，點擊右上角的“發(fā)布”按鈕來發(fā)布智能體帅矗。
API方式調(diào)用智能體
參考如下路徑學習如何調(diào)用API：
注意該頁面的智能體id、token下面代碼會使用到煞烫。
代碼示例：
#注意先安裝sdk浑此，pip install tencentcloud-sdk-python -i https://pypi.tuna.tsinghua.edu.cn/simple some-package
import requests
import json
# 定義 API 的 URL
url = 'https://open.hunyuan.tencent.com/openapi/v1/agent/chat/completions'
# 定義請求頭
# Authorization的值在“我的智能體”->已發(fā)布的智能體上點擊“...”按鈕，點擊“調(diào)用API”滞详，可以找到您的API調(diào)用token
headers = {
'X-Source': 'openapi',
'Content-Type': 'application/json',
'Authorization': 'Bearer OVLIkRPhjTM*************lC2dDlHl6g'
}
# 定義請求體
# 智能體id即assistant_id的值在“我的智能體”->已發(fā)布的智能體上點擊“...”按鈕凛俱，點擊“調(diào)用API”，可以找到您的assistant_id
"assistant_id": "av3pwWStovQ3",
"user_id": "username",
"stream": False,
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "蝴蝶蘭的適宜溫度料饥？"
}
]
}
]
}
# 將請求體轉(zhuǎn)換為 JSON 格式的字符串
json_data = json.dumps(data)
# 發(fā)送 POST 請求
response = requests.post(url, headers=headers, json=data) # 使用 json 參數(shù)自動設置正確的 Content-Type
# 打印響應內(nèi)容
print(response.text)
至此我們完成了知識庫蒲犬、工作流、智能體的創(chuàng)建岸啡，并通過API的方式調(diào)用了智能體應用原叮。
