Unfiltered AI สำหรับบทสนทนา NPC เกมและนิยายเชิงโต้ตอบ
รักษาอำนาจของเกมไว้ในเอนจิน: บันทึกสถานะของ NPC แต่ละตัว ตรวจสอบการเรียกใช้เครื่องมือที่เสนอ และรักษาการเปลี่ยนผ่านของเรื่องราวที่อนุญาต คู่มือนี้ใช้กฎเหล่านั้นกับบทสนทนาที่สร้างขึ้นมา และแสดงวิธีประมาณการต้นทุนโทเคน

อัปเดตUnfiltered AI
จุดสำคัญ
- ผู้ให้บริการอนุมานแบบเฉพาะเช่น Unfiltered AI นำเสนอพฤติกรรมที่ไม่มีการเซ็นเซอร์ที่สม่ำเสมอบนโมเดลเดียว โดยหลีกเลี่ยงความสุ่มของการจัดเส้นทางโดยตัวรวม
- Aggregators เช่น OpenRouter ให้การเข้าถึงโมเดลหลายตัวแต่อาจมีความแตกต่างในวิธีการใช้ content filters อย่างเข้มงวดขึ้นอยู่กับเวอร์ชันโมเดลเฉพาะ
- Unfiltered AI ใช้โมเดลแบบเปิดน้ำหนักบนฮาร์ดแวร์เฉพาะ โดยมีหน้าต่างบริบท 100k โทเคน ราคาอยู่ที่ $0.15/$0.50 ต่อหนึ่งล้านโทเคน
- สำหรับการรักษาความสอดคล้องของ NSFW หรือ roleplay ที่เข้มงวด API LLM uncensored เฉพาะทางกำจัดความจำเป็นในการปรับแต่ง prompt ที่ซับซ้อนเพื่อข้าม filters ทั่วไป
ลูปของเกม เขียนด้วยคำพูด
จดจำแผนภาพนี้ไว้: บรรทัดของผู้เล่น เข้าสู่ engine เครื่องมือจะสร้างพรอมต์จากสามส่วน: คำสั่งคงที่, บันทึกสถานะ ปัจจุบันของ NPC และบทสนทนาล่าสุด พรอมต์จะถูกส่งไปยังโมเดล โมเดลจะตอบกลับด้วย text พร้อม การเรียกใช้ฟังก์ชัน หรือทั้งสองอย่าง ข้อความจะแสดงบนหน้าจอ การเรียกใช้ฟังก์ชันจะถูกส่งกลับไปยังเครื่องมือ ซึ่งทำการตรวจสอบ เปลี่ยนแปลงบันทึกสถานะ และส่งสตริงผลลัพธ์สั้นๆ เพื่อให้โมเดลสามารถจบประโยคได้ จากนั้นวงจรจะรอผู้เล่น
คุณสมบัติสำคัญคือ เครื่องมือคือแหล่งความจริงเพียงแหล่งเดียว โมเดลเสนอ; เครื่องมือตัดสินใจ หากโมเดลบอกว่าตัวละครมอบกุญแจแต่ไม่ได้เรียกใช้ฟังก์ชัน กุญแจจะยังคงอยู่ในกระเป๋า การแยกส่วนนี้ทำให้บทสนทนาที่สร้างขึ้นปลอดภัยต่อการเชื่อมต่อกับเกมที่มีกฎเกณฑ์ ทุกอย่างด้านล่างเป็นผลสืบเนื่องมาจากสิ่งนี้
คำขอทั้งหมดใช้ endpoint chat-completions มาตรฐานที่ https://api.unfilteredaiapi.com/v1 พร้อม model id uncensored เครื่องมือใช้รูปแบบการเรียกใช้ฟังก์ชันของ OpenAI ดังนั้นโค้ดเดียวกันจึงใช้งานได้กับไลบรารีทางการ
ขอบเขตและหมายเหตุเฉพาะผู้ใหญ่
นิยายเชิงโต้ตอบสำหรับผู้ใหญ่เป็นกรณีการใช้งานที่ถูกต้อง บริการไม่ปฏิเสธเนื้อหาสำหรับผู้ใหญ่ที่ถูกต้องตามกฎหมาย ธีมมืด หรือหัวข้อที่ถกเถียงได้ในนิยาย มุ่งเน้นสำหรับผู้ใหญ่ที่มีอายุ 18 ปีขึ้นไป และเกมของคุณควรระบุเช่นนั้นในหน้าร้านค้าและจำกัดการเข้าถึงตามนั้น
บรรทัดหนึ่งคงที่: เนื้อหาทางเพศที่เกี่ยวข้องกับเด็กจะถูกบล็อกด้วยสถานะ 403 เสมอ ทั้งในนิยายและบทบาทสมมติ ออกแบบสำหรับสิ่งนั้นโดยเฉพาะ กำหนดอายุผู้ใหญ่ให้กับทุกตัวละครในบันทึกสถานะ และทำให้เครื่องมือจัดการสถานะ 403 ได้อย่างเรียบร้อยโดยจบการแลกเปลี่ยนแทนที่จะลองใหม่
สถานะ NPC แบบมีโครงสร้าง
คำอธิบายตัวละครแบบ free-form เลื่อนลอย บันทึกโครงสร้างแบบกะทัดรัดไม่เลื่อนลอย เก็บให้เล็ก ใส่ใน system message ทุกครั้ง และระบุว่าเป็นอำนาจสูงสุดเพื่อให้โมเดลปฏิบัติต่อมันว่าเป็นข้อเท็จจริงไม่ใช่คำแนะนำ
{
"name": "Brannoch",
"role": "ferry smuggler",
"mood": "wary",
"trust": 1,
"inventory": ["brass key", "flask of rum"],
"knows": ["the harbourmaster takes bribes", "a tunnel runs under the salt warehouse"],
"will_never": ["name his employer", "leave the dock before dawn"],
"location": "Gull Quay, pre-dawn"
}แต่ละฟิลด์มีคุณค่าในตัวเอง mood และ trust กำหนดน้ำเสียง inventory กำหนดขอบเขตสิ่งที่สามารถให้ได้อะไรได้ knows จำกัดสิ่งที่ NPC สามารถเปิดเผยได้ เพื่อให้ผู้เล่นไม่สามารถดึงจุดพล็อตออกมาจากตัวละครที่ตัวละครไม่มีเหตุผลที่จะเก็บไว้ will_never คือรายการสั้นๆ ของการปฏิเสธแบบแข็งกร้าวซึ่งทำให้ตัวละครมีกระดูกสันหลัง ในระดับประมาณ 120 โทเคน ค่าใช้จ่ายของบันทึกทั้งหมดต่อเทิร์นแทบไม่มีอะไรเลย
การเรียกใช้ฟังก์ชันสำหรับเกมแอคชัน
เครื่องมือเปลี่ยนข้อความบรรยายเป็นการเปลี่ยนแปลงสถานะ เครื่องมือด้านล่างครอบคลุมกลไกส่วนใหญ่ที่ขับเคลื่อนด้วยบทสนทนา: การเปลี่ยนความไว้วางใจ การโอนไอเทม และการนำเสนอตัวเลือก โปรดสังเกตว่า apply_tool จำกัดความไว้วางใจและปฏิเสธไอเทมที่ NPC ไม่มี; การตรวจสอบอยู่ในโค้ด
import json
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key=os.environ["API_KEY"])
TOOLS = [
{"type": "function", "function": {
"name": "adjust_trust",
"description": "Change how much this NPC trusts the player after what was just said.",
"parameters": {"type": "object", "properties": {
"delta": {"type": "integer", "minimum": -2, "maximum": 2},
"reason": {"type": "string"}},
"required": ["delta"]}}},
{"type": "function", "function": {
"name": "give_item",
"description": "Hand an item from the NPC's inventory to the player.",
"parameters": {"type": "object", "properties": {
"item": {"type": "string"}}, "required": ["item"]}}},
{"type": "function", "function": {
"name": "offer_choices",
"description": "Present up to three short dialogue options for the player to pick from.",
"parameters": {"type": "object", "properties": {
"choices": {"type": "array", "items": {"type": "string"}, "maxItems": 3}},
"required": ["choices"]}}},
]
def apply_tool(name, args, state, out):
if name == "adjust_trust":
state["trust"] = max(-3, min(5, state["trust"] + int(args.get("delta", 0))))
return f"trust is now {state['trust']}"
if name == "give_item":
item = args.get("item")
if item in state["inventory"]:
state["inventory"].remove(item)
out["items"].append(item)
return f"gave {item}"
return "refused: item not in inventory" # the engine, not the model, decides
if name == "offer_choices":
out["choices"] = args.get("choices", [])[:3]
return "choices shown"
return "unknown tool"
def npc_turn(state, history, player_line):
system = {"role": "system", "content": (
"You voice one NPC in an adults-only interactive story. Stay in character, "
"at most 80 words per reply, no narration of the player's actions. "
"Use tools for anything that changes the game; never claim an item was given without calling give_item.\n"
"NPC state (authoritative): " + json.dumps(state))}
history.append({"role": "user", "content": player_line})
out = {"text": "", "items": [], "choices": []}
for _ in range(4): # cap tool-call rounds
r = client.chat.completions.create(
model="uncensored", messages=[system] + history, tools=TOOLS,
temperature=0.8, max_tokens=300)
msg = r.choices[0].message
entry = {"role": "assistant", "content": msg.content}
if msg.tool_calls:
entry["tool_calls"] = [{"id": c.id, "type": "function",
"function": {"name": c.function.name, "arguments": c.function.arguments}}
for c in msg.tool_calls]
history.append(entry)
if msg.content:
out["text"] += msg.content
if not msg.tool_calls:
return out
for c in msg.tool_calls:
result = apply_tool(c.function.name, json.loads(c.function.arguments or "{}"), state, out)
history.append({"role": "tool", "tool_call_id": c.id, "content": result})
return out
state = json.loads(open("brannoch.json").read())
history = []
print(npc_turn(state, history, "I need to cross before sunrise. Name your price."))รายละเอียดสองประการที่ควรสนใจ ประการแรก วงจรการเรียกใช้ฟังก์ชันถูกจำกัดไว้ที่สี่ครั้ง ดังนั้นโมเดลที่สับสนจึงไม่สามารถวนลูปได้ไม่สิ้นสุด ประการที่สอง การเรียกใช้ฟังก์ชันทุกครั้งจะได้รับข้อความ tool ที่ตรงกันพร้อม tool_call_id เหมือนกัน หากละเว้นไป คำขอครั้งถัดไปจะมีรูปแบบไม่ถูกต้อง สตริงผลลัพธ์จะสั้นและข้อเท็จจริง ซึ่งช่วยให้โมเดลยอมรับสิ่งที่เกิดขึ้นโดยไม่สร้างผลลัพธ์ขึ้นมา
การแตกสาขาโดยไม่เสียพล็อต
ปล่อยให้เครื่องมือเป็นเจ้าของกราฟเรื่องราวและปล่อยให้โมเดลเป็นเจ้าของประโยค โหนดจะระบุว่าจะให้ NPC คนไหนพูด ต้องผ่านประตูใด และแต่ละทางเลือกนำไปสู่ที่ใด เมื่อโมเดลเรียกใช้ offer_choices คุณแมปแต่ละตัวเลือกกับคีย์โหนด; ข้อความอิสระที่ไม่ตรงกันจะย้อนกลับไปที่โหนดปัจจุบัน
{
"id": "quay_negotiation",
"npc": "brannoch",
"gate": {"trust_at_least": 2},
"on_choice": {
"pay_double": {"next": "crossing_fast", "set": {"gold": -40}},
"threaten": {"next": "quay_standoff", "trust_delta": -2},
"ask_about_tunnel": {"next": "warehouse_tunnel", "requires_fact": "tunnel"}
},
"fallback": "quay_negotiation"
}สิ่งนี้ทำให้เรื่องราวสามารถเข้าถึงและทดสอบได้ คุณสามารถเดินผ่านกราฟโดยไม่ต้องเรียก API แม้ครั้งเดียว ตรวจสอบว่า next ทุกตัวมีอยู่ และยืนยันว่าโหนดที่ปิดกั้นต้องการข้อเท็จจริงที่ผู้เล่นสามารถค้นพบได้จริง โมเดลให้ความหลากหลายภายในแต่ละโหนด ไม่ใช่โครงสร้างโดยรอบ
- Gates อ่าน state record: เกณฑ์ความไว้วางใจ ไอเทมที่ถือ ข้อเท็จจริงที่รู้
- Effects แก้ไขมัน: ทอง ความไว้วางใจ แฟล็ก
- Fallbacks รักษาผู้เล่นในตำแหน่งเมื่ออินพุตคลุมเครือ
ความจำตลอดการเล่นที่ยาวนาน
NPC ที่พบเมื่อสิบชั่วโมงที่แล้วควรจำคำดูถูกได้ อย่าเล่นซ้ำบทสนทนาสิบชั่วโมง เก็บสรุปสองประโยคต่อ NPC อัปเดตเมื่อการสนทนาสิ้นสุดลง และเพิ่มลงในบันทึกสถานะเป็นฟิลด์ memories กลไกของการสรุปและการจัดงบประมาณครอบคลุมใน บทความความจำ 100k และการตัดทอนเดียวกันนี้ใช้กับบทสนทนาแบบเลื่อนของแต่ละ NPC
หากคุณให้บริการเกมเบราว์เซอร์ ให้รีเลย์สตรีมผ่านเซิร์ฟเวอร์ของคุณเองตามที่แสดงใน บทความ FastAPI เพื่อให้คีย์ไม่เข้าถึงไคลเอนต์
การทดสอบ NPC เหมือนกับการทดสอบโค้ด
บทสนทนาจากโมเดลมีความน่าจะเป็น แต่กฎเกณฑ์รอบๆ นั้นไม่ใช่ และนั่นคือที่ที่การทดสอบควรอยู่ บันทึกสถานะก่อนหน้านี้เป็น brannoch.json จากนั้นเขียนการตรวจสอบกับเครื่องมือแทนที่จะเป็นข้อความบรรยาย
- การทดสอบการตรวจสอบเครื่องมือ เรียกใช้
apply_toolโดยตรงด้วยไอเทมที่ NPC ไม่มี ค่าความไว้วางใจ 99 และอาร์กิวเมนต์ที่มีรูปแบบไม่ถูกต้อง สถานะต้องถูกต้องตามกฎหมายในทุกกรณี - การทดสอบกราฟ โหลดโหนดทุกตัว ยืนยันว่าเป้าหมาย
nextทุกตัวมีอยู่ และเดินผ่านเส้นทางจากโหนดแรกไปยังจุดจบแต่ละจุดโดยไม่ต้องเรียก API เลย - การทดสอบการเล่นซ้ำ บันทึกการสนทนาจริงหนึ่งครั้ง รวมถึงการเรียกใช้ฟังก์ชันและผลลัพธ์ จากนั้นเล่นซ้ำข้อความเครื่องมือกับเครื่องมือเพื่อตรวจสอบว่าสถานะสุดท้ายตรงกับสิ่งที่คุณคาดหวัง
- การทดสอบการแช่ รันผู้เล่นที่เขียนสคริปต์ผ่านห้าสิบบรรทัดที่อุณหภูมิต่ำและยืนยันว่า NPC ไม่เคยมอบไอเทมที่ไม่มีและไม่เกินขอบเขตความไว้วางใจ
ลดอุณหภูมิลงเหลือประมาณ 0.3 สำหรับการรันเหล่านั้น จากนั้นกลับไปที่ 0.8 สำหรับการเล่น ความประหลาดใจน้อยลงระหว่างการทดสอบหมายถึงความล้มเหลวชี้ไปที่โค้ดของคุณ ไม่ใช่เสียงรบกวนจากการสุ่ม เมื่อพบข้อบกพร่องในการเล่นจริง ให้เพิ่มการแลกเปลี่ยนที่ผิดเข้าไปในชุดการเล่นซ้ำเพื่อให้ไม่สามารถกลับเข้ามาโดยไม่มีใครสังเกตเห็น
นิสัยสุดท้าย: เก็บเสียงตัวละครไว้ในย่อหน้าสั้นๆ ต่อ NPC และกฎใน state record เสียงสามารถปรับได้อย่างอิสระโดยนักเขียน; กฎเปลี่ยนแปลงเฉพาะกับการตรวจสอบโค้ดเท่านั้น การผสมพวกมันใน blob เดียวกันคือวิธีที่การเขียนใหม่ในบุคลิกของ NPC ปลดล็อกไอเทมโดยไม่ได้ตั้งใจ
การคำนวณต้นทุน พร้อมสมมติฐานที่ระบุ
ราคาอยู่ที่ $0.15 ต่อหนึ่งล้านโทเคนอินพุตและ $0.50 ต่อหนึ่งล้านโทเคนเอาต์พุต ตัวเลขด้านล่างเป็นสมมติฐานสำหรับการวางแผน ไม่ใช่การวัดผล สมมติว่าหนึ่งบรรทัดของ NPC มีค่าใช้จ่าย: คำสั่งระบบและสถานะ 350 โทเคน บทสนทนาล่าสุด 1,000 โทเคน คำจำกัดความของฟังก์ชัน 250 โทเคน ดังนั้น 1,600 โทเคนอินพุต; ตอบกลับ 100 โทเคนเอาต์พุต
| รายการ | การคำนวณ | ต้นทุน |
|---|---|---|
| Input ต่อบรรทัด | 1,600 x $0.15 / 1M | $0.0004 |
| ผลลัพธ์ต่อบรรทัด | 100 x $0.50 / 1M | $0.0001 |
| หนึ่งบรรทัด | ผลรวม | $0.0005 |
| หนึ่งเซสชัน, 60 บรรทัด | 60 x $0.0005 | $0.03 |
| 10,000 เซสชัน | 10,000 x $0.03 | $300 |
รอบการเรียกใช้ฟังก์ชันเพิ่มคำขออีกอย่าง: ประมาณ 1,700 โทเคนอินพุตบวก 40 โทเคนเอาต์พุต ประมาณ $0.00047 หากหนึ่งในสามของบรรทัดทำให้เกิดการเรียกใช้ฟังก์ชัน ให้เพิ่มหนึ่งในสามของจำนวนนั้นไปยังค่าเฉลี่ย การตรวจสอบเพดานก็สำคัญเช่นกัน: ที่ 300 คำขอต่อนาทีต่อคีย์ คีย์เดียวรองรับบรรทัด NPC ได้ประมาณ 300 บรรทัดต่อนาทีสำหรับผู้เล่นพร้อมกันทั้งหมด ดังนั้นการเปิดตัวขนาดใหญ่จึงต้องการคิว อัตราค่าบริการสรุปไว้ที่ หน้าราคา
ถาม-ตอบ
API รองรับ function calling สำหรับเกมแอคชันหรือไม่?
ใช่ เครื่องมือยอมรับในรูปแบบ OpenAI ดังนั้นคุณประกาศฟังก์ชัน รับการเรียกใช้ฟังก์ชัน และส่งผลลัพธ์กลับเป็นข้อความเครื่องมือ
บทสนทนา NPC หนึ่งครั้งมีค่าใช้จ่ายเท่าไหร่?
ขึ้นอยู่กับพรอมต์ของคุณ หากสมมติว่ามี input 1,600 tokens และ output 100 tokens ต่อบรรทัด ค่าใช้จ่ายต่อบรรทัดจะอยู่ที่ประมาณ $0.0005 ตามอัตราที่ประกาศไว้
ตัวละครในเกมของฉันสามารถเป็นเด็กในฉากทางเพศได้หรือไม่?
ไม่ได้ เนื้อหาทางเพศที่เกี่ยวข้องกับเด็กจะถูกบล็อกเสมอด้วยสถานะ 403 รวมถึงในนิยาย บริการนี้สำหรับผู้ใหญ่ที่มีอายุ 18 ปีขึ้นไป
ฉันจะหยุดไม่ให้ NPC เปิดเผยความลับของพล็อตได้อย่างไร?
ระบุสิ่งที่มันรู้และสิ่งที่มันจะไม่ทำใน state record และบังคับใช้การเปลี่ยนแปลงไอเทมและ flag ในโค้ดของคุณเอง
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คopy คีย์ เปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด