TypeSafe AI

يتكيف تكامل ألفا TypeSafe AI مع نماذج النظام One، بما في ذلك Jev، مع إطار عمل العامل Python. تقيم هذه النماذج حالة التطبيق مقابل الأسئلة المطبوعة واحتمالات العودة والنتائج. فهي لا تولد استجابات دردشة حرة عادية.

تثبيت الحزمة

pip install agent-framework-typesafe --pre

التكوين

تعيين مفتاح API قبل إنشاء العميل:

TYPESAFE_API_KEY="<api-key>"
# Optional:
TYPESAFE_DEFAULT_MODEL="jev-latest"
TYPESAFE_BASE_URL="<api-root>"

تكون لقيم الدالة الإنشائية الأسبقية على متغيرات البيئة. يمكنك أيضا إدخال TypeSafe AsyncTypeSafeClientمكون . يظل العملاء الذين تم إدخالهم مملوكين للمتصل؛ أغلق العملاء الذين تم إنشاؤهم بواسطة TypeSafeChatClientclose() أو مدير سياق غير متزامن.

إنشاء عامل قرار مكتوب

مرر تعيين TypeSafe Questions من خلال خيار إطار عمل response_format العامل:

import asyncio

from agent_framework import Agent
from agent_framework_typesafe import TypeSafeChatClient
from typesafe_sdk import Choice, Noul


async def main() -> None:
    client = TypeSafeChatClient()
    try:
        agent = Agent(
            client=client,
            name="TicketEvaluator",
            instructions="Evaluate the support request.",
        )
        response = await agent.run(
            "Our checkout has failed for three days and we are losing sales.",
            options={
                "response_format": {
                    "department": Choice(
                        instructions="Which team should handle this request?",
                        criteria={
                            "billing": None,
                            "technical": None,
                            "sales": None,
                        },
                    ),
                    "urgent": Noul(
                        instructions="Does this request need urgent attention?"
                    ),
                },
            },
        )
        print(response.value)
    finally:
        await client.close()


asyncio.run(main())

بالنسبة لهذا الموصل، response_format هو تعيين TypeSafe Questions غير صحيح يحتوي على Noulأو Choiceأو Score أسئلة. يمكنك الوصول إلى كامل الكتابة SystemOneResponse من خلال response.value.

استخدم default_questions على العميل عندما يكون للتكامل عقد ثابت واحد. على سبيل المثال، يمكن لعميل TypeSafe الذي لديه أسئلة افتراضية أن يعمل بمثابة عميل العزل ل SecureAgentConfig.

أدوات الدالة وMCP

TypeSafeChatClient يدعم حلقة استدعاء دالة Agent Framework القياسية للمخططات ذات المجموعة المغلقة. تتضمن أشكال الوسيطات المعتمدة ما يلي:

• الثوابت الثابتة.
• تعدادات أو قيم PythonLiteral.
• القيم المنطقية.
• صفائف التعداد أو Literal القيم دون قيود صفيف إضافية.
• الإصدارات الاختيارية من هذه الأشكال.

لا يدعم العميل السلاسل أو الأرقام المطلوبة ذات النموذج الحر أو الكائنات المتداخلة أو الصفائف العامة أو الوسيطات المطلوبة التي تقبل القيم الخالية أو قيود المخطط التي لا يمكن للموصل الاحتفاظ بها. إذا قمت بتحديد وسيطة غير معتمدة، يستبعد العميل الأداة بأكملها في الوضع التلقائي أو يرفض الأداة عند طلبها.

تعمل أدوات MCP من خلال Agent، والتي تكتشف وظائف MCP وتوسعها إلى أدوات دالة قبل توجيه TypeSafe. الوظائف التي تناسب مخططاتها المجموعة الفرعية المدعومة هي فقط القابلة للتوجيه. يدعم الطلب على الأكثر 32 أداة قابلة للتوجيه، و64 خاصية لكل أداة، و64 عضوا في قائمة التعداد لكل وسيطة، و128 سؤالا داخليا تم إنشاؤه.

يتم تعيين العميل افتراضيا إلى استدعاء أداة واحدة لكل تشغيل. تكوين function_invocation_configuration={"max_function_calls": N} للسماح بجولات الأدوات المتتالية.

القدرات والحدود

الإمكانية	Support
التصنيف والكتابة والتهديف والتوجيه	TypeSafe Questions و SystemOneResponse
البرنامج الوسيط ل Agent Framework وبيانات تتبع الاستخدام	مدعوم
أدوات الدالة المحلية	مدعوم لمجموعة المخطط الفرعية المقيدة
وظائف MCP	مدعوم لمجموعة المخطط الفرعية المقيدة
البث المباشر	غير مدعوم
إنشاء نص حر	غير مدعوم
محتوى رسالة غير نصية	غير مدعوم
خيارات الإنشاء مثل temperature	مرفوض

يستخدم TypeSafeChatClient لطبقات إطار العمل القياسية. استخدم RawTypeSafeChatClient فقط عندما تريد إنشاء مكدس طبقة مخصص أو إلغاء الاشتراك في تنفيذ الدالة والبرامج الوسيطة وبيانات تتبع الاستخدام.

الخطوات التالية

استخدام المخرجات المنظمة