Docs

HTTP

Opening an agent to another system: one POST, one turn, one reply, with a token.

For another system rather than a person: one POST, one turn, one reply.

Add the channel to the agent:

// This agent may be reached by another system holding a token.
//
// Without this file, POST /api/agents/shop/chat is refused for a token and
// answered only for somebody signed in on the box.
import { apiChannel } from "@chloejs/core/channels";

export default apiChannel();

Make a token, with npx chloe tokens make <name> or on the dashboard's tokens page. The secret is shown once and not stored.
Call the agent:

curl -X POST http://127.0.0.1:3067/api/agents/shop/chat \
  -H "authorization: Bearer $CHLOE_TOKEN" \
  -H "content-type: application/json" \
  -d '{"prompt":"how many orders are late?"}'

{"runId":"...","text":"Three are late.","steps":2,"cost":0.0031}

curl -X POST http://127.0.0.1:3067/api/agents/shop/job/restock \
  -H "authorization: Bearer $CHLOE_TOKEN"

{"started":"shop/restock"}

Send thread, a name of your own, to carry on a conversation; leave it out to start fresh. Without this channel a token gets a 403 for that agent, and only somebody signed in on the dashboard can reach it. It takes chatHistory and nothing else. A job that stops to ask somebody waits in GET /api/parked, because HTTP cannot push a question out.