agentica-server

Agentica server to narzędzie do uruchamiania agentów SDK Agentica z lokalnym proxy Claude'a. Umożliwia Twoim skryptom Pythona komunikację z Claude CLI jako backendem wnioskowania. Zawiera pełną architekturę, sekwencję uruchamiania trzech terminali oraz instrukcje debugowania połączeń między SDK, serwerem a proxy. Idealne do tworzenia i testowania agentów z dostępem do narzędzi.

1. Przygotuj trzy oddzielne terminale — każdy będzie uruchamiać inny komponent stosu. Upewnij się, że masz zainstalowane uv oraz dostęp do Claude CLI.

2. W pierwszym terminalu uruchom Claude proxy na porcie 8080: uv run python scripts/agentica/claude_proxy.py --port 8080. Czekaj, aż proxy będzie gotowe do przyjmowania żądań.

3. W drugim terminalu przejdź do katalogu serwera Agentica i ustaw zmienną środowiskową INFERENCE_ENDPOINT_URL wskazującą na proxy, następnie uruchom serwer na porcie 2345: cd workspace/agentica-research/agentica-server, potem INFERENCE_ENDPOINT_URL=http://localhost:8080/v1/chat/completions uv run agentica-server --port 2345.

4. W trzecim terminalu ustaw zmienną S_M_BASE_URL na adres serwera i uruchom swój skrypt agenta: S_M_BASE_URL=http://localhost:2345 uv run python scripts/agentica/your_script.py. Zastąp your_script.py nazwą Twojego pliku.

5. Aby sprawdzić, czy wszystko działa, użyj curl do testowania health checków — dla proxy: curl http://localhost:8080/health, dla serwera: curl http://localhost:2345/health. Jeśli obie odpowiedzi są pozytywne, agent może się połączyć.

6. Jeśli napotkasz problemy z połączeniem, pamiętaj, że SDK łączy się z serwerem (port 2345), a serwer łączy się z proxy (port 8080) — to dwa różne endpointy. Sprawdź logi w każdym terminalu, aby zidentyfikować, gdzie połączenie się przerywa.