Atomic protocol step

POST

/npcs/:npcId/process

POST

/npcs/:npcId/process

1 curl -X POST https://api.forboc.ai/npcs/npcId/process \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "tape": {
6     "observation": "The NPC notices a suspicious figure lurking near the marketplace.",
7     "npcState": {},
8     "memories": [
9       {}
10     ]
11   }
12 }'

200Successful

1 {
2   "instruction": {
3     "type": "IdentifyActor"
4   },
5   "tape": {
6     "observation": "The NPC notices a suspicious figure lurking near the marketplace.",
7     "npcState": {},
8     "memories": [
9       {
10         "text": "Saw a hooded stranger near the market yesterday evening.",
11         "type": "observation",
12         "importance": 0.85,
13         "similarity": 0.92
14       }
15     ],
16     "context": {},
17     "persona": "A cautious and vigilant town guard.",
18     "actor": {
19       "npcId": "npc-12345",
20       "persona": "Town Guard",
21       "data": {}
22     },
23     "prompt": "Identify the suspicious figure based on recent observations and memories.",
24     "constraints": {
25       "maxTokens": 150,
26       "temperature": 0.7,
27       "stop": [
28         "\n"
29       ]
30     },
31     "generatedOutput": "The suspicious figure appears to be a known thief recently reported in the area.",
32     "rulesetId": "guard-protocol-v2",
33     "vectorQueried": true
34   }
35 }

SDK sends the full accumulated tape and the result of the previous atomic side-effect. API returns the next atomic instruction and the updated tape.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

npcIdstringRequired

Request

This endpoint expects an object.

tapeobjectRequired

lastResultmap from strings to any or nullOptional

Response

Next atomic instruction with updated tape

instructionobject

tapeobject