Create agent

POST

/agents

POST

/v1/agents

1 import requests
2 
3 url = "https://api.forbocai.com/v1/agents"
4 
5 payload = {
6     "cortexId": "ctx_abc123",
7     "persona": "You are Kira, a cautious merchant. You distrust strangers but can be won over with fair trades.",
8     "initialState": {
9         "inventory": ["rusty_key", "healing_potion"],
10         "mood": "suspicious"
11     }
12 }
13 headers = {"Content-Type": "application/json"}
14 
15 response = requests.post(url, json=payload, headers=headers)
16 
17 print(response.json())

Try it

201Created

1 {
2   "id": "agent_9f8b7c6d5e4a3b2c1d0e",
3   "cortexId": "ctx_abc123",
4   "persona": "You are Kira, a cautious merchant. You distrust strangers but can be won over with fair trades.",
5   "state": {
6     "inventory": [
7       "rusty_key",
8       "healing_potion"
9     ],
10     "skills": {},
11     "relationships": {},
12     "mood": "suspicious",
13     "fear": 0.75,
14     "confidence": 0.65
15   },
16   "memoryCount": 12,
17   "createdAt": "2024-04-20T14:45:00Z"
18 }

Creates a new AI agent with a persona and initial state.

Request

This endpoint expects an object.

cortexIdstringRequired

personastringRequired

initialStateobjectOptional

memoryConfigobjectOptional

Response

Agent created

idstring or null

cortexIdstring or null

personastring or null

stateobject or null

memoryCountinteger or null

createdAtdatetime or null