0Pricing
AI Agents · درس

ميزانيات الرموز لكل خطوة

حدّد عدد رموز الإدخال والإخراج لكل عقدة كي لا تؤدي حلقة لا نهائية إلى إفلاسك.

ميزانيات الرموز لكل خطوة درس مجاني في AI Agents على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents 4 دروس في المجموع.

الرموز المميزة تساوي مالًا

كل رمز مميز ترسلونه أو تستقبلونه يكلّف مالًا ووقتًا. يتتبع وكلاء الإنتاج استخدام الرموز المميزة في كل خطوة ويفرضون حدودًا قصوى.

ضعوا حدًا لـ max_tokens في كل مكان

اضبطوا دائمًا max_tokens في كل استدعاء. فمن دونه، قد تؤدي مطالبة معطوبة إلى إنتاج استجابات من 10,000 رمز مميز:

response = client.chat.completions.create(
    model='gpt-4o-mini',
    messages=messages,
    max_tokens=1024,   # cap per response
)

الحدود لكل خطوة في حلقة الوكيل

تحتاج الخطوات المختلفة إلى ميزانيات مختلفة:

STEP_BUDGETS = {
    'planner': 512,
    'classifier': 64,
    'final_synthesis': 2048,
    'tool_call': 256
}

response = client.chat.completions.create(
    model=model,
    messages=messages,
    max_tokens=STEP_BUDGETS[step_name]
)

قلّلوا رموز الإدخال

تكلّف رموز الإدخال مالًا أيضًا. قلّلوها بصرامة:

import tiktoken
enc = tiktoken.encoding_for_model('gpt-4o-mini')

def trim_to_budget(text, max_tokens=4000):
    toks = enc.encode(text)
    if len(toks) > max_tokens:
        return enc.decode(toks[:max_tokens])
    return text

الميزانية الإجمالية لكل تشغيل

اجمعوا رموز الإدخال والإخراج عبر جميع الخطوات، وأوقفوا التشغيل عند تجاوز الحد:

MAX_TOKENS_PER_RUN = 50_000
total = 0
for step in agent_steps:
    r = call_step(step)
    total += r.usage.total_tokens
    if total > MAX_TOKENS_PER_RUN:
        return 'Budget exhausted; partial result'

حدود التكلفة بالدولار

تكون الميزانية بالدولار أحيانًا أكثر دلالة:

PRICES = {'gpt-4o-mini': {'in': 0.15e-6, 'out': 0.60e-6}}

for step in agent_steps:
    r = call_step(step)
    cost = r.usage.prompt_tokens * PRICES[model]['in'] + r.usage.completion_tokens * PRICES[model]['out']
    total_cost += cost
    if total_cost > MAX_COST_PER_RUN:
        break

الميزانيات التكيفية

أنفقوا مزيدًا من الرموز على أصعب الخطوات:

if step_difficulty == 'easy':
    max_tokens = 256
elif step_difficulty == 'hard':
    max_tokens = 2048

تقدير طول الإخراج

اطلبوا من النموذج أحيانًا تحديد الطول الذي ينبغي أن تكون عليه الإجابة:

preview = llm.invoke(f'How many tokens (approx) does {question} need to answer?').content
budget = parse_int(preview, default=512)
final = llm.invoke(question, max_tokens=budget)

اقتطعوا مخرجات الأدوات

تؤدي مخرجات الأدوات الكبيرة، مثل HTML والسجلات، إلى تضخيم السياق. اقتطعوها قبل إرسالها إلى النموذج:

tool_result = run_tool(...)
text = json.dumps(tool_result)
if len(text) > 4000:
    text = text[:4000] + '\n...[truncated]'

ضغط السجل

في المحادثات الطويلة، لخّصوا التبادلات الأقدم لتوفير الرموز:

if total_message_tokens(messages) > 8000:
    messages = compact(messages)

تنسيق الإخراج يؤثر في عدد الرموز

يتسم JSON بالإسهاب. بالنسبة إلى الاستجابات الهيكلية القصيرة، يمكنكم التفكير في:

  • وسيط استدعاء أداة واحد
  • قائمة مفصولة بفواصل
  • تنسيق مخصص مضغوط

تتبّع توزيع الرموز

تكشف المدرجات التكرارية لكل خطوة عن الخطوات التي ينبغي تحسينها:

metrics.observe('step.planner.tokens', r.usage.total_tokens, tags={'agent': 'qa'})

لماذا max_tokens؟

لماذا ينبغي ضبط max_tokens في كل استدعاء لـ LLM؟

مراجعة

ضعوا حدًا لـ max_tokens في كل استدعاء. قلّلوا المدخلات. خصصوا ميزانيات لكل خطوة. ضعوا حدودًا إجمالية لكل تشغيل. تتبّعوا التوزيعات. اضغطوا السجل.

الأسئلة الشائعة

هل درس «ميزانيات الرموز لكل خطوة» مجاني؟

نعم — نص درس «ميزانيات الرموز لكل خطوة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents 4 دروس في المجموع.

ماذا ستتعلم في «ميزانيات الرموز لكل خطوة»؟

حدّد عدد رموز الإدخال والإخراج لكل عقدة كي لا تؤدي حلقة لا نهائية إلى إفلاسك. تتمرن على AI Agents مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ AI Agents؟

لا تُشترط خبرة سابقة. AI Agents على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.

كم من الوقت يستغرق درس «ميزانيات الرموز لكل خطوة»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس AI Agents هذا؟

نعم. كل درس في AI Agents يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. ميزانيات الرموز لكل خطوة
  2. توجيه النماذج (من الأرخص إلى الأغلى)
  3. تخزين المطالبات والنتائج مؤقتًا (Anthropic وVertex)
  4. التكميم وفك الترميز التخمني
← العودة إلى AI Agents