Agent-Lab to natywny dla chmury framework w Pythonie do budowania, symulowania i testowania
agentów LLM, oparty na FastAPI, LangChain/LangGraph i PostgreSQL. Wykonaj pip install btech-agent-lab, rozszerz klasy bazowe agentów i złóż gotową do produkcji aplikację
jednym wywołaniem create_app() — z REST API, serwerem MCP, persystencją,
uwierzytelnianiem i obserwowalnością OpenTelemetry w zestawie.
Dokumentacja jest uporządkowana według tego, co chcesz zrobić, w duchu frameworka Diátaxis: samouczki, gdy się uczysz, przewodniki, gdy pracujesz, dokumentacja referencyjna, gdy potrzebujesz konkretnego faktu. Wybierz swoją ścieżkę:
| Chcę… | Ścieżka |
|---|---|
| Zacząć | Twój pierwszy agent → Przewodnik programisty |
| Zbudować aplikację | Przewodnik programisty → Dokumentacja konfiguracji → Dokumentacja REST API → Przewodnik po serwerze MCP |
| Oceniać i prowadzić badania | Przewodnik badacza → Testy i symulacje |
| Wdrażać i utrzymywać | Przewodnik wdrażania → Obserwowalność → Keycloak → Vault |
| Współtworzyć projekt | Przewodnik programisty → Model domeny encji → Podziękowania |
Samouczki
Zorientowane na naukę: przejdź przez całość od początku do końca, nie zbaczaj z trasy.
| Strona | Opis |
|---|---|
| Twój pierwszy agent | Wygeneruj szkielet projektu, zdefiniuj agenta, wywołaj go przez REST, obejrzyj ślad i udostępnij narzędzie MCP — w około 15 minut. |
Przewodniki
Zorientowane na pracę: rozwiąż problem, który masz w tej chwili.
| Strona | Opis |
|---|---|
| Przewodnik programisty | Główny przewodnik: dwa modele rozwoju, konfiguracja, DI, budowanie agentów i wszystkie punkty rozszerzeń. |
| Serwer MCP | Udostępnianie agentów klientom MCP (Claude Desktop, MCP Inspector); dodawanie narzędzi i promptów. |
| Testy i symulacje | Zestaw testów integracyjnych z testcontainers; symulacje agentów z LLM w roli sędziego, z Langfuse/LangWatch. |
| Przewodnik badacza | Notatniki Jupyter, eksperymenty i prototypowanie nowych zachowań agentów. |
| Wdrażanie | Lokalne stosy Docker Compose oraz produkcyjny Kubernetes z Terraform + Helm. |
| Uwierzytelnianie z Keycloak | Konfiguracja realmu, klienta i konta usługi; przepływy tokenów oczekiwane przez API. |
| Sekrety w Vault | Jak sekrety konfiguracji są przechowywane, pobierane i rotowane. |
| Obserwowalność z Grafana · z OpenSearch | Referencyjne dashboardy dla dwóch dołączonych stosów obserwowalności. |
Dokumentacja referencyjna
Wyłącznie fakty: dokładne, kompletne, generowane z kodu.
| Strona | Opis |
|---|---|
| Dokumentacja konfiguracji | Każdy klucz konfiguracji i każda zmienna środowiskowa oraz sposób wyboru aktywnego ConfigSource. |
| REST API | Pełny katalog endpointów z przykładami żądań i odpowiedzi. |
| Model domeny encji | Encje, relacje i trzy bazy danych PostgreSQL. |
Projekt
| Strona | Opis |
|---|---|
| Podziękowania | Współtwórcy i oprogramowanie firm trzecich. |
| Licencja | MIT. |
Co dalej?
Dopiero zaczynasz z Agent-Lab? Zacznij od strony Twój pierwszy agent — kompletnego przewodnika do skopiowania i wklejenia, na końcu którego masz działającego agenta, z którym rozmawiasz przez REST i MCP.