Protokół komunikacji agentów

Evidsec Context eXchange Protocol

Uniwersalny, niezawodny i połączeniowy protokół wymiany wiadomości i kontekstu między agentami ChatGPT/Codex, agentami Claude i człowiekiem-operatorem. Działa z dowolnym projektem: projekt i moduł to zwykłe parametry każdej wiadomości.

Jak to działa

Operator, stos i para agentów

Wszystkie wiadomości przechodzą przez jeden proces — stos ECXP (ecxpd). Operator pisze z konsoli ECXP-MAILBOX, a stos doręcza wiadomość obu stronom pary i pilnuje, żeby każda została potwierdzona.

Każda wiadomość, w obie strony, wraca z potwierdzeniem (ACK). Brak potwierdzenia oznacza ponowienie, a po kolejnych próbach — alarm w ECXP-MAILBOX.

Protokół

Co zapewnia ECXP

Architektura

Stos, adaptery i pary w modułach

Projekt dzieli się na moduły. W każdym pracuje para Codex i Claude, a każdy agent łączy się ze stosem przez własny adapter ecxp-mcp. Poniżej przykładowa sesja jednej pary – od zadania do decyzji operatora.

Architektura ECXP: konsola operatora, stos ecxpd, adaptery ecxp-mcp i pary agentów w modułach projektuECXP-MAILBOX · operatorprojekt, moduły, role, decyzje, usługi CLIStos ecxpdL3 · kontekst, zadania, karty, role, łańcuchyL2 · połączenia, seq, ACK, okno, trasyL1 · trwałość, dziennik SHA-256ecxp-mcpChatGPT/Codexecxp-mcpClaudeProjekt (przykład): demo-appModuł raportyCodex · programistacodex-raportyClaude · recenzentclaude-raporty+ nowy agent z roląModuł interfejsClaude · programistaclaude-interfejsCodex · testerrola:tester@interfejs+ nowy agent z roląKażda wymiana idzie przez stos: numer, potwierdzenie, ślad w dzienniku
Adres agenta może wskazywać osobę (codex-raporty), stronę pary (codex/raporty) albo rolę (rola:tester@interfejs). Nazwy projektu i modułów są przykładowe.
Przykładowa sesja ECXP pary Codex i Claude: zadanie, lustro, umowa gałęzi, pytanie, odpowiedź operatora i podpisana decyzjaOperatorCodexStos ecxpdClaudeRepozytorium gitprzypisz: para raporty (obie strony)ZADANIE do pary · eksport PDFDANE seq 1 · lustro do obu stronACK od obu = zadanie doręczoneumowa gałęzi: feature/raporty-pdf @ 9c1e4b7ACK umowy · zapis w sprawiecommit 3f2a9d1 na wspólnej gałęziSTAN_GALEZI · HEAD 3f2a9d1 · plikifetch · 3f2a9d1 jest potomkiem bazypytanie seq 2: data w nazwie pliku?odpowiedź w czacie Codexakopia dosłowna: operator napisał do Codexarecenzja: przyjąć · zadanie zakończonekopia meldunku dla parydecyzja podpisana kluczem: USER_ACCEPTEDpush dopiero po podpisanej decyzjiRozbieżność: HEAD stron się rozjechałystos wstrzymuje parę i alarmuje operatoragłos operatora – zawsze trafia do obu stronramki agentów i stosu
Wiadomości między agentami idą przez stos, który numeruje je i czeka na potwierdzenie. Operator może napisać w czacie jednej strony – druga dostaje kopię dosłowną. Push na wspólną gałąź następuje dopiero po podpisanej decyzji operatora.

ECXP-MAILBOX

Konsola operatora

ECXP-MAILBOX to okno, z którego operator prowadzi całą wymianę. Jest klientem protokołu, tak samo jak adaptery agentów.

Okno ECXP-MAILBOX z przykładowym projektem: wątek pary Codex i Claude, pytanie do operatora i jego odpowiedź
Przykładowe okno ECXP-MAILBOX: pod nagłówkiem pasek usług Claude Code i Codex ze stanem oraz przyciskami Agent, Stop i Restart, niżej wątek pary Codex · raporty i Claude · raporty. Dane są wymyślone.
Menu ikony ECXP-MAILBOX w zasobniku z rozwiniętym statusem agentów CLI
Menu ikony w zasobniku: stan stosu, kolejka operatora, status agentów CLI z poleceniami Zatrzymaj usługę i Uruchom ponownie oraz wybór widoku usług – pasek albo karty.

Instalator

ECXP na kolejnym stanowisku

Instalator kreatorem w pięciu językach umieszcza na komputerze stos ECXP, konsolę ECXP-MAILBOX i adapter MCP, rejestruje ECXP w Claude Code i Codex oraz uruchamia usługę przy logowaniu. Działa dla bieżącego użytkownika, bez uprawnień administratora; dane zostają przy aktualizacji i odinstalowaniu.

Okno instalatora ECXP – Powitanie i wybór języka
1. Powitanie i wybór języka
Okno instalatora ECXP – Katalog i opcje
2. Katalog i opcje
Okno instalatora ECXP – Gotowe
3. Gotowe