TypeSafe AI

Alfa TypeSafe AI entegrasyonu, Jev dahil System One modellerini Agent Framework Python için uyarlar. Bu modeller, uygulama durumunu yazılan sorulara göre değerlendirir ve olasılıkları ve puanları döndürür. Sıradan, serbest formatlı sohbet yanıtları oluşturmazlar.

Paketi yükle

pip install agent-framework-typesafe --pre

Configuration

İstemciyi oluşturmadan önce API anahtarını ayarlayın:

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

Oluşturucu değerleri ortam değişkenlerine göre önceliklidir. Yapılandırılmış bir TypeSafe AsyncTypeSafeClient de ekleyebilirsiniz. Enjekte edilen istemciler çağıranın sorumluluğunda kalır; close() tarafından oluşturulan istemcileri TypeSafeChatClient veya zaman uyumsuz bir bağlam yöneticisiyle kapatın.

Yazılan karar aracısı oluşturma

TypeSafe response_format eşlemesini Agent Framework Questions seçeneği aracılığıyla iletme:

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())

Bu bağlayıcı için response_format, Score, Noul veya Questions soruları içeren, boş olmayan bir TypeSafe Choice eşlemesidir. response.value aracılığıyla yazılanın SystemOneResponse tamamına erişebilirsiniz.

Tümleştirmenin tek bir sabit sözleşmesi olduğunda istemcide kullanın default_questions . Örneğin, varsayılan sorulara sahip bir TypeSafe istemcisi, SecureAgentConfig için karantina istemcisi olarak görev yapabilir.

İşlev ve MCP araçları

TypeSafeChatClient , kapalı küme şemaları için standart Agent Framework işlev çağırma döngüsünü destekler. Desteklenen argüman biçimleri şunları içerir:

  • Sabit sabitler.
  • Numaralandırmalar veya Python Literal değerleri.
  • Boole değerleri.
  • Ek dizi kısıtlamaları olmadan enum veya Literal değer dizileri.
  • Bu şekillerin isteğe bağlı sürümleri.

İstemci, gerekli serbest biçimli dizeleri veya sayıları, iç içe nesneleri, genel dizileri, zorunlu ama null olabilen argümanları ya da bağlayıcının koruyamadığı şema kısıtlamalarını desteklemez. Desteklenmeyen bir bağımsız değişken belirtirseniz, istemci aracın tamamını otomatik modda dışlar veya gerektiğinde aracı reddeder.

MCP araçları, MCP işlevlerini keşfeden ve bunları TypeSafe yönlendirmeden önce işlev araçlarına genişleten Agent aracılığıyla çalışır. Yalnızca şemaları desteklenen alt kümeye uyan işlevler yönlendirilebilir. Bir istek en fazla 32 yönlendirilebilir aracı, araç başına 64 özelliği, bağımsız değişken başına 64 numaralandırma üyesini ve oluşturulan 128 iç soruyu destekler.

İstemci varsayılan olarak her çalıştırma için bir araç çağrısı kullanır. function_invocation_configuration={"max_function_calls": N} öğesini ardışık araç çağrılarına izin verecek şekilde yapılandırın.

Özellikler ve sınırlar

Özellik Support
Yazılan sınıflandırma, puanlama ve yönlendirme TypeSafe Questions ve SystemOneResponse
Agent Framework ara yazılımı ve telemetri Destekleniyor
Yerel işlev araçları Kısıtlanmış şema alt kümesi için desteklenir
MCP işlevleri Kısıtlanmış şema alt kümesi için desteklenir
Yayın Desteklenmiyor
Serbest biçimli metin oluşturma Desteklenmiyor
Metin olmayan ileti içeriği Desteklenmiyor
temperature gibi üretken seçenekler Reddedildi

Standart çerçeve katmanları için kullanın TypeSafeChatClient . Yalnızca kasıtlı olarak özel bir katman yığını oluşturmak veya işlev yürütme, ara yazılım ve telemetriyi geri çevirmek istediğinizde kullanın RawTypeSafeChatClient .

Sonraki Adımlar

Yapılandırılmış çıkışları kullanma

  • Son güncelleştirme: