角色对话 API
角色对话 API——Convai 与 Roblox 集成的代码示例。
以下这段代码是成功调用 Convai 服务器并在与角色的对话中获取响应所必需的最关键部分。
function my_functions.callConvai(msg, sessionID, apiKey, charID)
local httpSrv = game:GetService("HttpService")
local baseUrl = "https://api.convai.com/character/getResponse"
local gpt_response
local function request()
-- 如果以下值未正确设置,我们将限制不必要的调用
if apiKey == "" then
print("请提供有效的 API 密钥")
返回
end
if charID == "" then
print("请输入有效的角色 ID")
返回
end
-- REST API 调用
local response = httpSrv:RequestAsync({
Url = baseUrl,
Method = "POST",
Headers = {
-- 这是在 Roblox 中发送 form-data 的最便捷方式
["Content-Type"] = "application/x-www-form-urlencoded",
["CONVAI-API-KEY"] = apiKey
},
Body = string.format([[&userText=%s&sessionID=%s&charID=%s&voiceResponse=%s]], msg, sessionID, charID, 'False')
})
-- 检查响应表
if response.Success then
print("状态码:", response.StatusCode, response.StatusMessage)
print("响应正文:\n", response.Body)
local data = httpSrv:JSONDecode(response.Body)
print("响应文本:", data.text)
print("响应会话 ID:", data.sessionID)
gpt_response = response.Body --data.text
else
print("请求失败:", response.StatusCode, response.StatusMessage)
end
end
-- 将函数包装在 'pcall' 中,以防请求失败时脚本中断
local success, message = pcall(request)
--print("状态码:", message)
if gpt_response == nil then
gpt_response = httpSrv:JSONEncode({sessionID = sessionID, text = "抱歉,我现在无法聊天。"})
end
return gpt_response
end
上面的函数在演示游戏的聊天框实现中被调用。下面是各部分作用的概览:
该函数接受 消息 我们从用户那里获取的消息。我们将其与 sessionID 和 characterID 一起发送。 我们还传入 API 密钥 我们之前设置好的值。
HttpService 允许从游戏服务器发送 HTTP 请求。 详情.
现在来看代码中最重要的部分:
虽然 身体 请求的这部分看起来像一个复杂的字符串,但实际上很简单。将其拆解为简单组成部分后,可以表示为:
其余部分只是简单的响应处理代码。由于我们收到的响应是 JSON 数据,因此必须在客户端对其进行解码以读取其内容:
以上就是我们关于 /getResponse API 的讨论。
最后更新于
这有帮助吗?