agentica-claude-proxy

Guide for integrating Agentica SDK with Claude Code CLI proxy

1. Upewnij się, że masz zainstalowany Claude CLI i możesz uruchomić polecenie claude -p. Skill wymaga dostępu do narzędzi Read, Bash i możliwości edycji plików.

2. Skonfiguruj zmienną środowiskową S_M_BASE_URL wskazującą na localhost:2345, gdzie będzie działać proxy Agentica. Proxy będzie komunikować się z Claude CLI na localhost:8080.

3. W kodzie agenta Agentica, gdy wywoływasz Claude Code CLI, dodaj flagę --allowedTools z listą narzędzi: Read, Write, Edit, Bash. Bez tej flagi agent otrzyma błędy uprawnień przy próbie modyfikacji plików.

4. Upewnij się, że odpowiedzi z proxy są formatowane jako Server-Sent Events (SSE). Każdy chunk powinien być wysyłany jako data: {json}\n\n, a koniec sekwencji jako data: [DONE]\n\n. Agentica oczekuje tego formatu do poprawnego parsowania odpowiedzi.

5. Gdy agent zwraca wyniki, muszą być sformatowane jako blok kodu Python z instrukcją return. Agentica parser wyodrębnia kod między znacznikami python i – bez tego agent może zgłosić sukces bez faktycznego wykonania operacji.

6. Jeśli agent halucynuje (twierdzi, że wykonał zadanie, ale go nie wykonał), dodaj do system prompt ostrzeżenie anti-hallucination, które wymusza rzeczywiste wywołanie narzędzi przed zwróceniem wyniku. Instruuj agenta: najpierw faktycznie użyj narzędzia, czekaj na rezultat, dopiero wtedy zwróć odpowiedź.