Aplikacje Agent-Lab współdzielą jeden model domeny, zdefiniowany w agent_lab/domain/.
Ten sam model napędza schematy REST API, warstwę persystencji i środowisko uruchomieniowe
agentów — wystarczy poznać go raz, aby wiedzieć, co odczytuje i zapisuje każdy endpoint.
Encje
| Encja | Co modeluje |
|---|---|
| Agent | Instancję agenta LLM — agent_name, agent_type (walidowany względem rejestru), flagę aktywności i znaczniki czasu. Jedna implementacja, wiele skonfigurowanych instancji. |
| AgentSettings | Konfigurację klucz-wartość instancji agenta: prompty (szablony Jinja2), nazwy kolekcji, temperaturę, wartości niestandardowe. Do 16 000 znaków na wartość — to tutaj dostraja się zachowanie agenta przez POST /agents/update_setting. |
| LanguageModel | Model językowy dostępny dla agentów wraz z połączeniem do jego dostawcy. |
| LanguageModelSettings | Parametry poszczególnych modeli (temperatura, maks. liczba tokenów, …), zarządzane przez endpointy /llms. |
| Integration | Integrację zewnętrzną (np. z dostawcą AI) i jej konfigurację. Sekrety są przechowywane w Vault, nigdy w bazie danych. |
| Message | Jedną turę rozmowy: rolę (human / assistant / tool), treść, response_data i powiązania wątku (replies_to). Utrwalaną razem z pamięcią agenta za pomocą checkpointów LangGraph. |
| Attachment | Plik dołączony do wiadomości: surową treść, sparsowaną treść oraz odwołanie do kolekcji embeddingów używanej przy wyszukiwaniu. |
Przykład utrwalonych ustawień agenta — promptów i wartości niestandardowych agenta notatek głosowych — z notebooks/08_test_agent_type-multiagent-voice-assistant.ipynb:
Gdzie przechowywane są dane
Agent-Lab używa trzech baz danych PostgreSQL (oraz Redis) — udostępnianych zgodnie z
przewodnikiem wdrażania i konfigurowanych przez db.url, db.vectors oraz
db.checkpoints (zobacz Dokumentację konfiguracji):
| Magazyn | Zawartość |
|---|---|
db.url |
Dane relacyjne: agenci, ustawienia, modele, integracje, wiadomości, załączniki |
db.vectors |
Embeddingi pgvector — wyszukiwanie wektorowe i pobieranie (/attachments/embeddings) |
db.checkpoints |
Dane checkpointów LangGraph — pamięć agenta między interakcjami |
Redis (broker.url) |
Broker pub/sub dla aktualizacji statusu długotrwałych operacji; także magazyn klientów OAuth dla MCP |
Bezpieczeństwo i zarządzanie sekretami
Sekrety — poświadczenia integracji, klucze API modeli, a także sam ładunek konfiguracji — są zarządzane przez Vault. Baza danych przechowuje odwołania; wrażliwe wartości są pobierane z Vault podczas uruchamiania i na żądanie. Zobacz Sekrety w Vault i Dokumentację konfiguracji.