Przejdź do treści

KRET LANGUAGE ACADEMY · DOKUMENTACJA ZE ŹRÓDEŁ

KretAI — referencja składni

KretAI — referencja składni

Status 1.0: `FROZEN_SUPPORTED_SUBSET` — zamrożony dokładnie opisany zakres; reszta poza kontraktem 1.0. Gramatyka/wersja: kretai-1.0. Status języka nie nadaje uprawnień KCS ani prawa do działania w Production.

Opisane są wyłącznie konstrukcje potwierdzone implementacją SDK (i, gdzie zaznaczono, testami tej rundy).

model

Deklaracja modelu.

model local.small {
    provider "local"
    name "qwen2.5:7b"
    endpoint "http://127.0.0.1:11434"
    dataPolicy "local-only"
    maxOutputTokens 1024
    timeout 2min
}
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. model local.small {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  2. provider "local"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  3. name "qwen2.5:7b"Pole tożsamości lub wersji w otaczającym bloku; zachowaj jego kontekst.
  4. endpoint "http://127.0.0.1:11434"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  5. dataPolicy "local-only"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  6. maxOutputTokens 1024Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  7. timeout 2minOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  8. }Zamknięcie struktury otwartej we wcześniejszych liniach.
CechaWartość
Parametry / typyprovider local|anthropic, name, endpoint (local), dataPolicy local-only|external-allowed, secret (klucz ustawienia KretConfig), maxOutputTokens, timeout, effort, refusalFallback
Wynik—
Wymagania—
Ograniczeniainna polityka danych → odrzucenie (sprawdzone)
Możliwe błędyKCS-KAI-*
Wprowadzono1.0

tool

Narzędzie = funkcja KretS o zadeklarowanej sygnaturze.

tool counter.add {
    description "…"
    handler "Tools.addCounter"
    parameter name String "…"
    parameter amount Int64 "…"
    returns "Int64"
    permissions {
        kretdb.write
    }
    sideEffects "write"
    requiresConfirmation true
}
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. tool counter.add {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  2. description "…"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  3. handler "Tools.addCounter"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  4. parameter name String "…"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  5. parameter amount Int64 "…"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  6. returns "Int64"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  7. permissions {Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
  8. kretdb.writeOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  9. }Zamknięcie struktury otwartej we wcześniejszych liniach.
  10. sideEffects "write"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  11. requiresConfirmation trueOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  12. }Zamknięcie struktury otwartej we wcześniejszych liniach.
CechaWartość
Parametry / typyhandler, parameter, returns, permissions, sideEffects none|write, requiresConfirmation
Wynikwynik funkcji
WymaganiarequiresConfirmation obowiązkowe przy write; sygnatura zgodna z KretS
Ograniczeniafunkcje ochronne zakazane
Możliwe błędyKCS-KAI-*
Wprowadzono1.0

agent

Agent z narzędziami, delegacją i limitami.

agent assistant {
    model local.small
    system "…"
    tools counter.read counter.add
    delegates reader
    permissions { … }
    limits {
        maxSteps 8
        maxToolCalls 16
        timeout 5min
    }
}
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. agent assistant {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  2. model local.smallOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  3. system "…"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  4. tools counter.read counter.addOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  5. delegates readerOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  6. permissions { … }Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
  7. limits {Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
  8. maxSteps 8Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  9. maxToolCalls 16Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  10. timeout 5minOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  11. }Zamknięcie struktury otwartej we wcześniejszych liniach.
  12. }Zamknięcie struktury otwartej we wcześniejszych liniach.
CechaWartość
Parametry / typymodel, system, tools, delegates, permissions, limits (obowiązkowe), memory
Wynik—
Wymaganiauprawnienia agenta ⊇ uprawnienia narzędzi; delegat ⊆ delegujący; brak cykli
Ograniczeniabudżety kroków, wywołań, tokenów, czasu
Możliwe błędyKCS-KAI-*
Wprowadzono1.0

ai.ask (KretS)

Wywołanie agenta z KretS.

use Kret.Ai as ai
let answer = ai.ask("assistant", "Ile jest zamówień?")
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. use Kret.Ai as aiOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  2. let answer = ai.ask("assistant", "Ile jest zamówień?")Wiązanie wartości; typ i możliwość zmiany zależą od użytej deklaracji.
CechaWartość
Parametry / typyagent, polecenie
WynikString
Wymaganiakretai.use, kretai.model.use (SENSITIVE)
Ograniczeniaprawdziwy model NOT_RUN
Możliwe błędyKCS-KAI-0301, KCS-KAI-0302
Wprowadzono1.0

Źródło i wersja

Zweryfikowany import PUBLIC_CANDIDATE. Identyfikatory źródeł odnoszą się do eksportu i nie dają dostępu do plików serwera.

01_LANGUAGES/KretAI/Documentation/SYNTAX_REFERENCE.md
SHA-256 9416E7E6B7BF990D15467A57476EF8E4ED4FB7005B877215BB0465D9B55D1C56

Zaloguj się na konto użytkownika, aby zapisywać postęp i zakładki. Konta obsługi mogą czytać bez zapisu postępu. Logowanie →

Wybierz, co możemy zapamiętać w tej przeglądarce. Możesz zmienić decyzję w każdej chwili.

Polityka prywatności