agentica-claude-proxy

Umiejętność do integracji Agentica SDK z Claude Code CLI proxy. Skonfiguruj agentów Agentica do pracy z narzędziami Claude, debuguj problemy halucynacji i błędy uprawnień przy operacjach na plikach. Zawiera architekturę proxy, wymagane flagi --allowedTools, format SSE streaming oraz techniki prompt engineeringu zapobiegające fałszywym raportom sukcesu agentów.

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ź.