Assistants介紹

隨著OpenAI將Assistants助手API對外發(fā)布，我們搭建個人知識庫變的如此簡單。開發(fā)者將自己的應用通過Assistants API與OpenAI對接，就可以讓每一位客戶擁有不一般體驗的個人知識庫。由于Assistants相關API有30+，本文只列舉完成一個最小功能閉環(huán)涉及的接口。關于Assistants的介紹，這里借用官網的一張圖說明

Assistants Demo開發(fā)

以下只是介紹下如何開發(fā)一個簡單的助手Demo，針對每個步驟有詳細說明，感興趣的朋友可以參考自行實現客戶端。

• 1.上傳知識文件(File)，需要注意purpose參數需要設置為assistants，表示該文件用于助手。目前OpenAI官方要求單個文件不能超過512M。支持txt、pdf、docx、pptx、xlsx、csv、xml、json、java、c、python常見文件格式，并要求編碼格式為utf-8、utf-16、ascii其中的一種，詳情請查詢官網助手關于支持的文件類型的描述

curl --location --request POST 'https://gateway.ai.cloudflare.com/v1/2a2*****************60/******/openai/files' \
--header 'Authorization: Bearer sk-123' \
--form 'purpose="assistants"' \
--form 'file=@"C:\\Users\\admin\\Desktop\\三國演義（白話文版）.txt"'

• 2.創(chuàng)建助手(Assistants)，創(chuàng)建助手時需要指定助手名稱、提示詞、設置需要使用的工具、關聯的文件(目前每個助手限制最多20個文件，且單個文件不能超過2000000 tokens，如果文件比較多，建議合并后上傳)、以及使用的模型(本文選擇gpt-4-1106-preview)。本次示例中助手只開啟了工具中的檢索(Retrieval)功能，代碼解釋器(Code interpreter)和函數(Functions)未用到，后面有機會再聊。

curl --location --request POST 'https://gateway.ai.cloudflare.com/v1/2a26****************d560/*****/openai/assistants' \
--header 'Authorization: {{secretKey}}' \
--header 'OpenAI-Beta: assistants=v1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "instructions": "您將擔任XY的高級內容分析師。XY是一位在小說創(chuàng)作領域具有豐富經驗的文學家。你的任務是基于XY上傳的小說，回答用戶問題，并提供深入見解。任務說明：1.當用戶提問時，仔細分析問題并基于XY上傳的小說給出回答;2.如果回答來自于上傳的小說，請?zhí)峁┬≌f的文件名稱;3.如果上傳的小說中沒有能回答用戶問題的參考內容，請直接回答\"我不知道\"。",
    "name": "內容分析師",
    "tools": [
        {
            "type": "retrieval"
        }
    ],
    "file_ids": [
        "file-0CocxG465dfsIUd4MKx0O8iG"
    ],
    "model": "gpt-4-1106-preview"
}'

• 3.創(chuàng)建線程(Thread)，您可以將線程理解為用戶與助手對話的上下文，它會記錄用戶與助手相互發(fā)送的message。

curl --location --request POST 'https://gateway.ai.cloudflare.com/v1/2a26**************d560/*****/openai/threads' \
--header 'Authorization: {{secretKey}}' \
--header 'OpenAI-Beta: assistants=v1' \
--header 'Content-Type: application/json' \
--data-raw ''

• 4.向助手發(fā)送信息(send message)，線程創(chuàng)建好之后，意味著當前用戶與助手對話的上下文已經建立完畢，用戶可以想助手發(fā)送消息了。由于線程會管理用戶與助手之間相互發(fā)送的message，所以每次用戶向助手發(fā)送消息時，只需要發(fā)送最新的message，而不必攜帶用戶發(fā)送的歷史消息，這樣邏輯更簡單，也節(jié)省tokens。

curl --location --request POST 'https://gateway.ai.cloudflare.com/v1/2a2*******************d560/******/openai/threads/thread_mAO9Gqfg4fdfgBVoMxOLXn/messages' \
--header 'OpenAI-Beta: assistants=v1' \
--header 'Authorization: {{secretKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role": "user",
    "content": "你知道赤壁之戰(zhàn)嗎？"
}'

• 5.執(zhí)行人機交互(Run)，消息發(fā)送完畢，是時候讓助手干活了。關于Run的執(zhí)行，里面細節(jié)比較多，后面有機會聊。

curl --location --request POST 'https://gateway.ai.cloudflare.com/v1/2a265********************560/*****/openai/threads/thread_mAO9GqdfgdsfgerVoMxOLXn/runs' \
--header 'Authorization: {{secretKey}}' \
--header 'OpenAI-Beta: assistants=v1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "assistant_id": "asst_F4fnsdfgds42w9yJr2vZieb"
}'

• 6.查詢指定線程(Thread)下特定人機交互(Run)的執(zhí)行狀態(tài)(status)。人機交互(Run)任務提交后，我們需要實時關注任務執(zhí)行狀態(tài)，status狀態(tài)包括：queued、?in_progress、requires_action、cancelling、cancelled、failed、completed、expired。為了使Run狀態(tài)是最新的，你需要定時輪詢Run對象獲取最新的狀態(tài)。需要注意的是，如果Run處于completed狀態(tài)，標識當前人機交互(Run)已經執(zhí)行完成，可以調用消息接口查詢助手返回的內容了。

curl --location --request GET 'https://gateway.ai.cloudflare.com/v1/2a26*******************d560/*****/openai/threads/thread_mAO9Gqmh4356fd7KBVoMxOLXn/runs/run_Nkx07ebg55LmUyJgx9' \
--header 'Authorization: {{secretKey}}' \
--header 'OpenAI-Beta: assistants=v1' \

• 7.查詢指定線程(Thread)的消息列表，返回的消息列表默認按時間降序排列，limit最大支持100。需要說明的是：Thread中可以存儲的message數量沒有限制，但是一旦message的大小超過模型的上下文窗口限制，Thread將嘗試包含盡可能多的適合上下文窗口的message并刪除最舊的message。

curl --location --request GET 'https://gateway.ai.cloudflare.com/v1/2a2*********************d560/******/openai/threads/thread_mAO9Gqm456fdYo7KBVoMxOLXn/messages?limit=20' \
--header 'OpenAI-Beta: assistants=v1' \
--header 'Authorization: {{secretKey}}' \

文章來源地址http://www.zghlxwxcb.cn/news/detail-746957.html

• 8.重復步驟4、5、6、7，即可實現用戶與助手的多輪對話。本文中只介紹了接口調用的時序，至于具體實現有興趣的自己實現客戶端，這里就不提供了。

到了這里，關于使用OpenAI Assistants三分鐘搭建個人知識庫AI助手網站的文章就介紹完了。如果您還想了解更多內容，請在右上角搜索TOY模板網以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持TOY模板網！