Agent prompt request

Request of prompt agent session

Endpoint

POST /api/agent/session/prompt/

Auth

Authorization: Bearer ${token}

Body Parameters

KeyDefaultDescription
identitySession identity
messageNatural-language instruction for this turn
modelOptional; override the agent model for this turn

Response

Json
[
    {
        "kind": "status",
        "payload": {
            "code": 0,
            "message": ""
        }
    },
    {
        "kind": "entity",
        "payload": {
            "type": "",
            "message": "",
            "tool": "",
            "argument": ""
        }
    }
]

Notes

  • Agent Permission Required
  • Read-Only Permission Restricted
  • Advances the session one turn. Replies stream as the agent's message followed by each tool call and its result (type is one of message, tool_run, tool_success, tool_failed).