Resolido Docs
Ai agents

Test the AI agent

POST
/agents/{agentId}/test

Chat with an agent as a test customer (works for inactive agents too) and get its reply, tools and knowledge used. Uses AI credits.

Authorization

bearer testing
headerAuthorizationBearer <token>

API key (rsl_live_…) from Settings → Developers.

Scope: testing

Path Parameters

agentId*string

AI agent id. Never invent ids – list resources first.

Length1 <= length <= 64

Request Body

application/json
  1. body
message?string

What the test customer writes. Omit to only wait for a pending reply.

Length1 <= length <= 5000
testSessionId?string

Continue a previous test conversation (from the last result).

Lengthlength <= 2000
waitSeconds?integer

How long to wait for the AI reply.

Range0 <= value <= 55
Default45

Response Body

Success

application/json
  1. response
status*string

replied = AI answered; handed_off = AI escalated to a person; no_reply = AI chose not to answer; pending = still thinking, call again with testSessionId and no message.

Value in"replied""no_reply""handed_off""error""pending"
replies*array<string>
toolsUsed*array<string>
knowledgeUsed*array<string>
testSessionId*string
conversationId*string
dashboardUrl*string
curl -X POST "https://example.com/agents/string/test" \  -H "Content-Type: application/json" \  -d '{}'
{  "status": "replied",  "replies": [    "string"  ],  "toolsUsed": [    "string"  ],  "knowledgeUsed": [    "string"  ],  "testSessionId": "string",  "conversationId": "string",  "dashboardUrl": "string"}

Evaluate a test conversation POST

Evaluate a test conversation (from agents.test) against plain-language criteria with an AI judge. Used by `resolido test`. Uses AI credits.

Update AI agent PATCH

Update an AI agent's name, instructions, model, domains, signature and behaviour. Only sent fields change. Owner/admin.