Pular para o conteúdo principal
POST
/
v1
/
agents
/
{agent_id}
/
run
Run agent (single-shot)
curl --request POST \
  --url https://api.quintus.tec.br/v1/agents/{agent_id}/run \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "messages": [
    {
      "content": "<string>",
      "role": "user",
      "metadata": {}
    }
  ],
  "user": {
    "id": "<string>",
    "reference": "<string>"
  },
  "context": {},
  "metadata": {},
  "persist": true
}
'
{
  "agent_message": {
    "id": "<string>",
    "content": [
      {
        "text": "Hello agent",
        "type": "text"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  },
  "session_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://quintus.tec.br/docs/llms.txt

Use this file to discover all available pages before exploring further.

Autorizações

X-API-Key
string
header
obrigatório

Parâmetros de caminho

agent_id
string
obrigatório

Corpo

application/json
messages
MessageCreateRequest · object[]
obrigatório
Required array length: 1 - 10 elements
user
SessionUser · object

Reference to a user when creating a session. Lookup-only. Use POST /users to create users.

context
Context · object

Free-form key/value pairs injected into the agent's system context for this run.

metadata
Metadata · object

Integrator-defined storage. Not seen by the agent.

persist
boolean
padrão:true

If true, a session is created and persisted. If false, the run is intended to be ephemeral (current implementation still persists; this will change in a future release).

Resposta

Successful Response

agent_message
Message · object
obrigatório
session_id
string | null