Zarządzanie kodowaniem

Dzięki funkcji Kodowanie administratorzy mogą tworzyć kontrolowane klucze API dla narzędzi programistycznych, takich jak Aider i OpenCode. Użytkownicy nie pracują wtedy z własnym kluczem OpenAI, lecz z kluczem zarządzanym przez AI-School.

Dzięki temu Kodowanie nadaje się do lekcji programowania, projektów oraz dla zaawansowanych użytkowników, którzy chcą korzystać z pomocy AI w lokalnym środowisku programistycznym.

Dlaczego kontrolowane klucze API?

Zwykły klucz API często daje szeroki dostęp do zewnętrznej platformy AI. W Kodowaniu użycie przebiega przez AI-School. Dzięki temu zarządzanie, koszty i raportowanie pozostają w szkole.

Główne korzyści:

• Koszty pod kontrolą: ustaw budżet dla każdego klucza.
• Identyfikowalne użycie: zużycie, koszty i czaty są przypisane do użytkownika.
• Centralne zarządzanie: twórz, ograniczaj i unieważniaj klucze z poziomu środowiska administracyjnego.
• Odpowiednie dla klas: twórz za jednym razem klucze dla całej grupy uczniów.

Włączanie Kodowania

Kodowanie jest włączane na poziomie środowiska. Może to zrobić administrator organu prowadzącego.

1. Przejdź do Środowisko administracyjne → Kodowanie.
2. Kliknij Włącz Kodowanie.
3. Przeczytaj ostrzeżenie dotyczące kosztów subskrypcji i kosztów API.
4. Kliknij Akceptuję i włączam.

Po włączeniu AI-School obsługuje połączenie techniczne w tle. Administratorzy nie muszą w tym celu zarządzać zewnętrznymi ustawieniami projektu.

Koszty

Z Kodowaniem mogą wiązać się dodatkowe koszty subskrypcji. Koszty API są naliczane z marżą. W razie pytań skontaktuj się z AI-School.

Nadawanie dostępu szkołom

Po włączeniu określasz, które szkoły mogą korzystać z Kodowania.

1. Otwórz kartę Zarządzanie.
2. Wybierz szkoły, które mogą korzystać z Kodowania.
3. Kliknij Zapisz dostęp.

Administrator szkoły widzi tylko te szkoły, dla których Kodowanie jest dozwolone i do których ma uprawnienia. Dla administratora szkoły zbędne panele szkół są ukryte.

Wybór modeli

Na karcie Zarządzanie wybierasz, które modele OpenAI są dostępne w Kodowaniu.

AI-School korzysta z następujących modeli:

Model	Zastosowanie
GPT-6 Luna	Szybki i wszechstronny model dla uczniów i do codziennej pomocy w programowaniu
GPT-6.1 Terra	Wydajny model dla nauczycieli, zaawansowanych uczniów i złożonych zadań programistycznych
GPT-6.1 Sol	Najbardziej zaawansowany model do wymagającej pracy programistycznej i profesjonalnego użytku

Do pracy w klasie GPT-6 Luna to szybki i przystępny początek. Wybierz Sol lub Astra, gdy zadanie wymaga więcej analizy, rozumowania lub samodzielnych kroków programistycznych.

Kompatybilne narzędzia do kodowania

Kodowanie działa z narzędziami, które mogą korzystać z punktu końcowego zgodnego z OpenAI. Użytkownik potrzebuje wtedy trzech informacji:

• klucza API Kodowania
• adresu URL punktu końcowego Kodowania AI-School: https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
• dozwolonego modelu, na przykład gpt-6-luna

W większości sytuacji AI-School zaleca te dwa narzędzia:

Narzędzie	Zalecane dla	Uwagi
Aider	Uczniów i kodowania w klasie	Narzędzie do programowania w parach (pair programming) w terminalu. Mniej agentowe, dzięki czemu lepiej nadaje się do nauki programowania.
OpenCode	Nauczycieli i zaawansowanych uczniów	Agentowe narzędzie do kodowania dla terminala, pulpitu i IDE. Potężniejsze, ale wymaga większego doświadczenia.

Istnieją też inne narzędzia do kodowania, które technicznie mogą współpracować z punktem końcowym zgodnym z OpenAI:

Narzędzie	Typ	Na co zwrócić uwagę
Continue	Asystent IDE dla VS Code i JetBrains	Obsługuje konfigurację OpenAI z niestandardowym apiBase. Odpowiedni, gdy użytkownicy chcą pracować głównie w swoim IDE.
Cline	Rozszerzenie VS Code i CLI	Wybierz dostawcę OpenAI Compatible i wpisz bazowy adres URL, klucz API oraz model. Mocno agentowe; mniej odpowiednie dla początkujących bez wsparcia.
Roo Code	Rozszerzenie VS Code	Może współpracować z dostawcą zgodnym z OpenAI. Dokładnie sprawdzaj, jakie działania wykonuje agent.
Sourcegraph Cody Enterprise	Korporacyjny asystent kodowania	Szczególnie istotny dla organizacji korzystających z Sourcegraph Enterprise. Obsługuje konfigurację modelu openaicompatible na poziomie organizacji.

Nie każde narzędzie do kodowania jest automatycznie odpowiednie

Narzędzie jest odpowiednie tylko wtedy, gdy możesz ustawić własny bazowy adres URL zgodny z OpenAI. Dlatego narzędzia takie jak Claude Code i Codex CLI nie nadają się do Kodowania: Claude Code nie korzysta z API zgodnego z OpenAI, a Codex CLI nie oferuje odpowiedniego ustawienia dla konkretnego punktu końcowego Kodowania. Także narzędzia takie jak Cursor czy Windsurf można używać tylko wtedy, gdy używana wersja obsługuje dowolnie konfigurowalny bazowy adres URL zgodny z OpenAI.

Porada dla szkół

Dla uczniów zacznij od Aider. Narzędzia agentowe, takie jak OpenCode, Cline czy Roo Code, dodawaj dopiero wtedy, gdy użytkownicy mają wystarczające doświadczenie z terminalem, gitem, diffami i lokalnym zarządzaniem plikami.

Raportowanie

Karta Raportowanie pokazuje użycie i koszty w wybranym okresie. Domyślnie wyświetlane jest ostatnie 7 dni.

Raport zawiera:

• łączną liczbę żądań
• łączne koszty
• liczbę tokenów
• podział według grup
• podział według użytkowników

Administrator szkoły widzi tylko raporty w ramach własnego, dozwolonego zakresu. Administrator organu prowadzącego widzi raporty dla całego środowiska.

Wyłączanie Kodowania

Możesz tymczasowo wyłączyć Kodowanie za pomocą przycisku na pasku narzędzi.

Gdy Kodowanie jest wyłączone:

• istniejących kluczy API nie można używać
• raporty i dane historyczne zostają zachowane
• Kodowanie można później ponownie włączyć

Wyłączenie nie usuwa istniejących raportów.