Unfiltered AI لحوار الشخصيات غير القابلة للعب (NPC) في الألعاب والأدب التفاعلي
احتفظ بسلطة اللعبة في المحرك: احفظ حالة كل شخصية غير قابلة للعب (NPC)، وتحقق من صحة استدعاءات الأدوات المقترحة، واحتفظ بالانتقالات القصصية المسموح بها. يطبق هذا الدليل تلك القواعد على الحوار المُنشأ ويوضح كيفية تقدير تكاليف الرموز.

محدّثUnfiltered AI
نقاط رئيسية
- مزودو الاستنتاج المخصصون مثل Unfiltered AI يقدمون سلوكًا غير خاضع للرقابة على نموذج واحد، متجنبين عشوائية توجيه المجمع.
- توفر المجمعات مثل OpenRouter الوصول إلى نماذج متعددة ولكن قد تختلف في مدى صرامة تطبيق فلاتر المحتوى اعتمادًا على إصدار النموذج المحدد.
- تستخدم Unfiltered AI نموذجًا مفتوح الأوزان على أجهزة مخصصة مع نافذة سياق 100k، بسعر $0.15/$0.50 لكل مليون رمز.
- للتوافق الصارم مع NSFW أو اللعب الأدوار، تزيل واجهة LLM غير الخاضعة للرقابة المخصصة الحاجة إلى هندسة الموجّه المعقدة لتجاوز الفلاتر العامة.
حلقة اللعبة، مرسومة بالكلمات
احتفظ بهذا الرسم البياني في ذهنك. يدخل خط اللاعب إلى engine. يتركب المحرك موجّهًا من ثلاثة أجزاء: التعليمات الثابتة، سجل الحالة الحالي للشخصية غير القابلة للتفاعل، والحوار الأخير. يذهب الموجّه إلى النموذج. يجيب النموذج بـ text، مع استدعاءات الأدوات، أو مع كليهما. يذهب النص إلى الشاشة. تذهب استدعاءات الأدوات مرة أخرى إلى المحرك، الذي يصدقها، يغير سجل الحالة، ويعيد سلسلة نتيجة قصيرة حتى يتمكن النموذج من إنهاء جملته. ثم ينتظر الحلقة اللاعب.
الخاصية المهمة هي أن المحرك هو المصدر الوحيد للحقيقة. يقترح النموذج؛ يقرر المحرك. إذا قال النموذج أن الشخصية تعطي مفتاحًا ولكن لم يستدعي الأداة، يبقى المفتاح في المخزون. هذا الفصل هو ما يجعل الحوار المولد آمنًا للسلك في لعبة مع القواعد. كل ما يلي ينبع منه.
تستخدم جميع الطلبات نقطة النهاية chat-completions القياسية في https://api.unfilteredaiapi.com/v1 مع معرف النموذج uncensored. تستخدم الأدوات تنسيق استدعاء الدوال من OpenAI، لذا يعمل نفس الرمز مع مكتبات العملاء الرسمية.
النطاق وملاحظة البالغين فقط
الحكايات التفاعلية للبالغين هي استخدام مشروع. لا ترفض الخدمة المحتوى البالغ القانوني، المواضيع المظلمة أو المواضيع المثيرة للجدل في الخيال. هي مخصصة للبالغين الذين تبلغ أعمارهم 18 عامًا فأكثر، ويجب أن تقول لعبتك ذلك على صفحة المتجر وتقييد الوصول وفقًا لذلك.
سطر واحد ثابت: يتم حظر المحتوى الجنسي الذي يتضمن قاصرين دائمًا بـ 403، في الخيال واللعب الأدوار على حد سواء. صمم لذلك صراحة. اعط كل شخصية عمر بالغ في سجل الحالة، واجعل محركك يتعامل مع 403 بسلاسة عن طريق إنهاء التبادل بدلاً من إعادة المحاولة.
حالة NPC المهيكلة
تتجه أوصاف الشخصيات الحرة. سجل مهيكل مضغوط لا يتجه. اجعله صغيرًا، ضعه في رسالة النظام في كل دور، وسمعه بأنه سلطوي حتى يعامله النموذج كحقيقة بدلاً من اقتراح.
{
"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 يحد من ما يمكن للشخصية غير القابلة للتفاعل كشفه، لذا لا يمكن للاعبين استخراج نقاط الحبكة التي ليس للشخصية سبب للاحتفاظ بها. will_never هو قائمة قصيرة من الرفض الصارم الذي يعطي الشخصية عمودًا فقريًا. في حوالي 120 رمزًا، يكلف السجل بأكمله تقريبًا لا شيء لكل دور.
استدعاءات الأدوات لأحداث اللعبة
تحوّل الأدوات النثر إلى تغييرات في الحالة. الثلاثة أدناه يغطون معظم آليات الحوار: تحويل الثقة، نقل عنصر، وعرض الخيارات. لاحظ أن apply_tool يثبت الثقة ويرفض العناصر التي لا تملكها الشخصية غير القابلة للتفاعل؛ التحقق من الصحة يعيش في الرمز.
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؛ حذفه وجعل الطلب التالي غير صالح. سلاسل النتائج قصيرة وواقعية، مما يسمح للنموذج بالاعتراف بما حدث دون اختلاق العواقب.
التفرع دون فقدان الحبكة
دع محرك القصة يدير رسم القصة، ودع النموذج يدير الجمل. تُدرج العقدة اسم الشخصية غير اللاعبية التي تتحدث، والبوابة التي يجب تجاوزها، وأين يؤدي كل خيار. عند استدعاء النموذج لـ 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، والتأكيد على أن العقد المقيدة تتطلب حقائق يمكن للاعب اكتشافها فعليًا. يزود النموذج بالتنوع داخل كل عقدة، وليس الهيكل حولها.
- البوابات تقرأ سجل الحالة: عتبات الثقة، العناصر المحتجزة، الحقائق المعروفة.
- التأثيرات تعدلها: الذهب، الثقة، العلامات.
- الحلول البديلة تحافظ على مكان اللاعب عندما يكون الإدخال غامضًا.
الذاكرة عبر جلسة لعب طويلة
يجب أن تتذكر الشخصية غير القابلة للعب (NPC) التي قابلتها منذ عشر ساعات إهانة. لا تعيد تشغيل عشر ساعات من الحوار. احفظ ملخصاً من جملتين لكل شخصية غير قابلة للعب (NPC)، حدّثه عند انتهاء محادثة، وأضفه إلى سجل الحالة كحقل memories. تغطي آليات التلخيص والميزانية في مقال الذاكرة 100k، وينطبق نفس التقليم على حوار كل شخصية غير قابلة للعب (NPC) المتراكم.
إذا كنت تخدم لعبة متصفح، قم بإعادة توجيه البث المتدفق عبر خادمك الخاص كما في مقال FastAPI حتى لا يصل المفتاح إلى العميل.
اختبار الشخصيات غير القابلة للتفاعل كما تختبر الرمز
الحوار من نموذج هو احتمالي، لكن القواعد حوله ليست كذلك، وهذا هو المكان الذي تنتمي إليه الاختبارات. احفظ سجل الحالة من السابق كـ brannoch.json، ثم اكتب فحوصات ضد المحرك بدلاً من النثر.
- اختبارات التحقق من صحة الأدوات. اتصل بـ
apply_toolمباشرة بعنصر لا تملكه الشخصية غير القابلة للتفاعل، وdelta ثقة 99، وحجج غير صالحة. يجب أن تبقى الحالة قانونية في كل حالة. - اختبارات الرسم البياني. حمّل كل عقدة، أكد وجود كل هدف
next، وامشِ مسارًا من العقدة الأولى إلى كل نهاية بدون استدعاء API على الإطلاق. - اختبارات إعادة التشغيل. سجل محادثة حقيقية مرة واحدة، بما في ذلك استدعاءات الأدوات والنتائج، ثم أعد تشغيل رسائل الأدوات ضد المحرك للتحقق من أن الحالة النهائية تتطابق مع ما تتوقعه.
- اختبارات التحمل. قم بتشغيل لاعب مُبرمج عبر خمسين سطرًا بدرجة حرارة منخفضة وتأكد من أن الشخصية غير القابلة للعب (NPC) لا تعطي أبدًا عنصرًا تفتقر إليه ولا تتجاوز حدود الثقة أبدًا.
خفض درجة الحرارة إلى حوالي 0.3 لتلك التشغيلات، ثم عد إلى 0.8 للعب. عدد أقل من المفاجآت أثناء الاختبار يعني أن الفشل يشير إلى رمزك، وليس إلى ضوضاء العينة. عندما يظهر خطأ في اللعب المباشر، أضف التبادل المذموم إلى مجموعة إعادة التشغيل حتى لا يعود دون أن يلاحظه أحد.
عادة أخيرة: احتفظ بصوت الشخصية في فقرة قصيرة واحدة لكل شخصية غير قابلة للعب (NPC) والقواعد في سجل الحالة. يمكن تعديل الصوت بحرية من قبل الكتاب؛ القواعد تُغير فقط بمراجعة الكود. خلطهما في كتلة واحدة هو كيف يؤدي إعادة كتابة شخصية غير قابلة للعب (NPC) عن غير قصد إلى فتح عنصر.
حساب التكاليف، مع ذكر الافتراضات
الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. الأرقام أدناه هي افتراضات للتخطيط، وليست قياسات. افترض أن سطر NPC واحد يكلف: تعليمات النظام والحالة 350 رمزًا، الحوار الأخير 1,000 رمز، تعريفات الأدوات 250 رمزًا، لذا 1,600 رمز إدخال؛ رد 100 رمز إخراج.
| العنصر | الحساب | التكلفة |
|---|---|---|
| الإدخال لكل سطر | 1,600 × $0.15 / 1M | $0.0004 |
| الإخراج لكل سطر | 100 × $0.50 / 1M | $0.0001 |
| سطر واحد | المجموع | $0.0005 |
| جلسة واحدة، 60 سطرًا | 60 × $0.0005 | $0.03 |
| 10,000 جلسة | 10,000 × $0.03 | $300 |
تضيف دورة استدعاء الأداة طلبًا إضافيًا: حوالي 1,700 رمز مدخل و40 رمز مخرج، أي حوالي $0.00047. إذا كان سطر واحد من كل ثلاثة أسطر يُفعّل أداة، أضف ثلث هذا المبلغ إلى المتوسط. فحوصات الحدّ الأعلى مهمة أيضًا: عند حدّ المعدل 300 طلب في الدقيقة لكل مفتاح، يدعم مفتاح واحد حوالي 300 سطر NPC في الدقيقة عبر جميع اللاعبين المتزامنين، لذا تحتاج الإطلاقات الكبيرة إلى الطابور. يتم تلخيص الأسعار في صفحة الأسعار.
أسئلة وأجوبة
هل يدعم API استدعاء الدوال لإجراءات اللعبة؟
نعم. تُقبل الأدوات بتنسيق OpenAI، لذا تُعرّف الدوال، وتتلقى استدعاءات الأداة، وترسل النتائج مرة أخرى كرسائل أداة.
كم يكلف محادثة NPC؟
يعتمد ذلك على الموجّهات الخاصة بك. مع افتراض وجود 1,600 رمز مدخل و100 رمز مخرج لكل سطر، يكلف السطر الواحد حوالي $0.0005 وفقًا للأسعار المنشورة.
هل يمكن أن تكون الشخصيات في لعبتي قاصرين في المشاهد الجنسية؟
لا. يتم حظر المحتوى الجنسي الذي يتضمن قاصرين دائمًا برمز 403، بما في ذلك في الخيال. الخدمة مخصصة للبالغين الذين تبلغ أعمارهم 18 عامًا فأكثر.
كيف أوقف NPC من الكشف عن أسرار الحبكة؟
اذكر ما يعرفه وما لن يفعله أبدًا في سجل الحالة، وفرض تغييرات العناصر والعلم في الكود الخاص بك.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.