Process input

POST

/agents/:agentId/process

Sends input to an agent and receives dialogue + validated actions.

agentIdstringRequired

This endpoint expects an object.

inputstringRequired

contextmap from strings to anyOptional

Agent response

dialoguestring or null

actionobject or null

stateChangesmap from strings to any or null

memoriesRecalledlist of strings or null

1	import requests
2
3	url = "https://api.forbocai.com/v1/agents/agentId/process"
4
5	payload = {
6	"input": "I'd like to buy that key from you.",
7	"context": {
8	"playerGold": 50,
9	"playerInventory": ["sword", "shield"]
10	}
11	}
12	headers = {"Content-Type": "application/json"}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"dialogue": "That key? It's... special. 50 gold and we have a deal.",
3	"action": {
4	"type": "OFFER_TRADE"
5	},
6	"stateChanges": {
7	"mood": "neutral"
8	}
9	}