KretAI — wprowadzenie

KretAI — wprowadzenie

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.

Czym jest

KretAI (w SDK KretAi) deklaruje modele, narzędzia (funkcje KretS) i agentów. Zamrożone są deklaracje, walidacja oraz bramki uprawnień i polityki danych. Wykonanie z prawdziwym modelem nie należy do kontraktu 1.0 (KretAI 1.1+, NOT_RUN). W Core KretAI jest DISABLED.

Dla początkujących

Opisujesz, z jakiego modelu agent może korzystać, jakich narzędzi (zwykłych funkcji KretS) i w jakich limitach. Kompilator sprawdza te opisy. W tej wersji nie uruchamiasz prawdziwego modelu — sprawdzasz deklaracje i bramki bezpieczeństwa.

Dla zaawansowanych programistów

Agent nie ma własnych uprawnień (co najwyżej to, co host przyznał podmiotowi). Narzędzie działa z uprawnieniami swojej deklaracji; argumenty od modelu są danymi niezaufanymi (obiekt JSON o dokładnie zadeklarowanych polach). Model zewnętrzny wymaga 6 warunków (polityka danych, polityka hosta, lista hostów, https, zgoda, kretai.external_model.connect); brak któregokolwiek = odmowa przed połączeniem. local-only wymusza połączenie na pętli zwrotnej. Sekrety (klucz API) tylko z KretConfig/Vault.

Jakie problemy rozwiązuje

Bezpieczne, audytowalne deklarowanie użycia AI przed jakimkolwiek wykonaniem modelu.

Kiedy używać

• deklarowanie kontraktów AI (modele, narzędzia, agenci)
• walidacja polityk modeli i uprawnień narzędzi
• testowanie narzędzi jako zwykłego KretS

Kiedy nie używać

• oczekiwanie działania prawdziwego modelu (NOT_RUN; KretAI 1.1/1.2)
• użycie w Core (DISABLED do decyzji KCS)
• wpisywanie kluczy API w plikach (tylko odwołanie do Vault)

Współpraca z innymi technologiami

KretS (ai.ask, narzędzia), KretDB (pamięć agenta), KretConfig/Vault (sekrety), KretL (uprawnienia kretai.*, kretdb.*).

Obecny status

FROZEN_SUPPORTED_SUBSET — zamrożony dokładnie opisany zakres; reszta poza kontraktem 1.0.

Dalej: ARCHITECTURE.md · SYNTAX_REFERENCE.md · ../Tutorials/BASIC/TUTORIAL_PL.md