Dokumentasjonsmeny
/llms-full.txt

Hele dokumentasjonen som én ren tekstside.

DokumentasjonMCP-referanse

MCP-referanse

Company Brain er en ekstern MCP-server. Denne siden er referansen en agent trenger: endepunktet, de åtte verktøyene, og den nøyaktige kontrakten for hvilke deler av et svar som er stabile nok til å parses.

Server

FeltVerdi
Navncompany-brain
Versjon1.0.0
Endepunkthttps://aiaxagents.ai/api/mcp
TransportStreamable HTTP
AutentiseringAuthorization: Bearer <token>
Avvisningen når tokenet mangler eller er ugyldig
Unauthorized: the request is missing a valid Company Brain token.
Svaret når virksomheten har for lite innhold
The brain does not have enough content yet to build the knowledge graph. Try again once the organization has added more.

Arbeidsflyt

Company Brain er virksomhetens tilgangsstyrte kunnskapsgraf: mennesker, avdelinger, prosesser, systemer og verktøy, AI-agenter, strategier, datakilder, retningslinjer, og relasjonene mellom dem.

  1. Kall get_skill_pack én gang i starten av en økt for et kompakt operativt kart tilpasset tilgangsnivået. Det siterer de samme node-idene som indeksen.
  2. Kall query_index for å finne relevante noder.
  3. Kall read_concept med en node-id, vist i klammer, for detaljer og relasjoner. Siter alltid node-idene svaret bygger på.
  4. Kall write_inbox for å foreslå ny kunnskap: en observasjon, en korreksjon, et forslag eller et arbeidsresultat. Forslag skrives aldri direkte inn i hjernen. En leder må godkjenne dem i innboksen i portalen først.

For onboarding: kall get_onboarding_status først, deretter get_onboarding_action_catalog for nøyaktige skjemaer, og bruk propose_onboarding_action for verifiserte strukturerte endringer. Onboardingforslag ligger bak den samme ledergodkjenningen, og den eksterne klienten setter dem aldri i verk selv.

Tokenet har to uavhengige grenser. Tilgangsnivået bestemmer hvilken kunnskap det får se; treff bak et høyere nivå skjules og rapporteres bare som et antall. Scopene bestemmer hvilke verktøy det får kalle: leseverktøyene krever brain:read, og begge forslagsverktøyene krever brain:propose i tillegg, på toppen av tilgangsnivået og ledergodkjenningen. Et verktøykall uten scopet det trenger, avvises som Forbidden, og ingenting registreres: rapporter det manglende scopet til brukeren i stedet for å prøve igjen.

Kunnskapsstatus: noder og relasjoner kan være merket som en utledet hypotese eller en uavklart kobling. Ta forbehold om dem i svaret og presenter dem aldri som etablerte fakta. Hvert merke er et varseltegn fulgt av frasen "inferred hypothesis; needs confirmation" eller "unresolved mapping; not a fact"; match på frasen, ikke hele linjen. Umerkede elementer er verifisert.

Innholdet virksomheten selv har lagt inn, blant annet titler og sammendrag, kan være på norsk. Det er kundens egne data. Siter dem som de står.

Verktøy

get_skill_pack
Et kompilert, versjonert operativt kart over virksomheten for dette tokenets tilgangsnivå: oversikt, avdelinger og mennesker, prosesser med eiere og opphav, systemer, agenter, datakilder og åpne gap. Ingen inndata. Det er et kart, ikke kilden. Ikke merket read-only, fordi en endret graf kan legge til en ny avledet revisjon i det interne registeret. Det endrer aldri kunnskap.
query_index
Rangert søk i den synlige grafen. Inndata: query (tekst, minst 2 tegn), types (valgfri liste av nodetyper), limit (valgfritt heltall, 1 til 20, standard 10). Returnerer treff med node-ider for videre oppslag. Treff bak et høyere tilgangsnivå skjules og telles bare. Read-only.
read_concept
All informasjon om én node: metadata, sammendrag og alle relasjoner til andre synlige noder. Inndata: id (tekst, en node-id fra query_index). Gir én avvisning for en ukjent id og en annen for en node over tokenets tilgangsnivå. Read-only.
list_gaps
De svakeste punktene i den synlige grafen: spørsmål som ikke er avklart, temapar som henger sammen i én eneste relasjon, tynt dekkede områder, og grunnlag som skal vurderes på nytt. Ingen inndata. Hver linje starter med et stabilt merke. Read-only.
write_inbox
Registrerer et forslag i virksomhetens innboks. Skriver aldri til hjernen. Inndata: kind (én av observation, correction, proposal, work_output), title (tekst, 3 til 120 tegn), body (tekst, 10 til 4000 tegn), relatedNodeIds (valgfri liste med inntil 10 node-ider). Krever brain:propose. Returnerer en kvittering med innboks-id, type og status.
get_onboarding_status
Hvor langt virksomheten har kommet i de sju onboardingstegene, hvor godt grunnlaget er, og hvilket område som står for tur. Ingen inndata. Returnerer antall og stegtilstand, aldri personlisten eller innholdet i dokumenter. Read-only.
get_onboarding_action_catalog
Alle støttede onboardinghandlinger med nøyaktig JSON Schema og risikonivå. Ingen inndata. Kall den før du foreslår noe, i stedet for å gjette feltnavn og verdier. Read-only.
propose_onboarding_action
Sender én validert onboardingendring til godkjenningsinnboksen. Inndata: action (et av handlingsnavnene i katalogen), summary (tekst, 3 til 160 tegn, vises til den som godkjenner), details (objekt som følger skjemaet til den valgte handlingen). Krever token på nivå manager eller admin, i tillegg til brain:propose. Setter aldri endringen i verk selv.
propose_draft_email
Oppretter et forslag om et e-postutkast. Inndata: to (liste med 1 til 10 e-postadresser), subject (tekst, 1 til 300 tegn), bodyText (tekst, 1 til 20000 tegn). Krever outreach:propose. Verktøyet oppretter ikke utkastet og sender ingenting: en leder må godkjenne forslaget først, og ved godkjenning opprettes utkastet i lederens egen postkasse, klart til gjennomlesing, redigering og manuell sending. AiAx sender aldri noe selv. Godkjennings-iden utledes av innholdet, slik at et gjentatt kall treffer forslaget som allerede finnes.

Maskinkontrakten

Hvert svar blander to registre, og bare det ene er en kontrakt. Visningstekst gjengis på virksomhetens eget språk, så en klient som bygger på noe som er ment for visning, ryker den dagen virksomheten bytter språk.

Stabilt, språkuavhengig og trygt å parse:

  • Node-ider i [klammer], og modul- og entitets-idene i wikireferansen.
  • Nodetypeetiketter, alltid det engelske settet: organization, person, department, project, agent, SOP / process, tool, strategy, data source, policy.
  • Relasjonsverb, alltid det engelske settet: is part of, belongs to, manages, works on, owns, uses, depends on, governs, can access, supports, champions, targets, needs clarification with.
  • Access, gjengitt som selve enum-verdien og aldri etiketten: public, department, project, manager, hr, executive, restricted.
  • De to frasene for kunnskapsstatus, "inferred hypothesis; needs confirmation" og "unresolved mapping; not a fact", hver med et varseltegn foran i den utsendte linjen; match på frasen.
  • Metadatanøkler, alltid engelske: Title, Coverage, Owner, Relation, Model, Approval threshold, Score, Quadrant, Estimated savings/year.
  • Ferskhetsfeltene (Evidence status, Verified, Review by) og alle andre tidspunkter, som ISO 8601-instanser og aldri formaterte datoer.
  • Gap-merker, ett per linje, på formen [gap:<kind>] der kind er én av clarification, thin_link, sparse_theme, stale_evidence.
  • Grenser for inndata: skjemaene under Verktøy, blant annet intervallet for limit og verdilistene.
  • Avvisninger og tomme svar, ordrett, og de to ulike avvisningene fra read_concept.
  • Skrivekvitteringer og registerlinjer for ferdighetspakker, blant annet revisjonen, innholdshashen og tidspunktet den ble generert.

Ikke kontrakt, og visningstekst på virksomhetens språk: titler, sammendrag, metadataverdier, merkelapper, gap-setninger og alle overskrifter. Siter dem, aldri parse dem.

En gap-linje, merket først
- [gap:stale_evidence] <setning på virksomhetens språk>