Documentatie

Hoe je Phrona aansluit: BIP, REST, MCP en de SDK's. Met de werkwoorden en de envelop zoals ze zijn.

Phrona is van buitenaf aan te sturen. Deze pagina beschrijft de ingangen; de volledige specificatie staat in het platform en op de service zelf.

Interfacetaal (BIP 1.0)

Eén werkwoord-vocabularium, één envelop, twee codecs, twee registers. De werkwoorden zijn describe, briefing, search, ask, verify, trace, cite en write.

Ingangen

  • POST /v1/brain/<id>/interact — agent-integratie met een Bearer-token.
  • POST /api/bip/<id>/interact — platform-UI met sessie-cookie.
  • POST /v1/brain/<id>/stream — SSE-stream van ask.
  • GET /v1/knowledge/search?q= — snelle, read-only kennisset-uitlezing zonder taalmodel.
  • GET /v1/brain/<id>/briefing — agent-briefing bij sessiestart.
  • GET /v1/memory — duurzaam geheugen, met upsert, batch en delta-feed.

Self-describing

De service beschrijft zichzelf. GET /v1/meta geeft endpoints en mogelijkheden, GET /v1/bip/docs de volledige specificatie, GET /openapi.json een OpenAPI-stub.

Koppelingen

  • MCP — POST /mcp (streamable HTTP, JSON-RPC). Een agent gebruikt de werkwoorden als tools zonder zelf de envelop te bouwen.
  • Binair — dezelfde envelop met Content-Type: application/cbor.
  • REST — losse endpoints onder /v1/ voor kennis, geheugen en notificaties.
  • SDK — een dependency-vrije Python-client met dezelfde werkwoorden.
  • Webhooks — push-notificaties wanneer een verwerking klaar is.
  • Gesprekskanalen — Telegram, Signal of Slack via een agent-platform dat op MCP of BIP is aangesloten.

Voorbeeld

curl -X POST https://phrona.dev/v1/brain/<id>/interact \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"op":"search","query":"...","top_k":8}'

Een token is gebonden aan één Brein. Wat je met een token kunt, is daarmee begrensd tot dat Brein.