Custom Tool

Status: Live

The endpoint is called on every agent turn (GET or POST) and the response is injected into the agent’s context. Auth headers and per-question tool calling are on the roadmap.

Gives the agent live data — like an order-lookup API — by attaching this node to an agent via the Knowledge & tools port.

Ports

• Out (top, dashed) → an AI Agent’s resource port.

Config

Field	Status	Behavior
Endpoint	Live	The URL to call (must be public http(s); private/local addresses are blocked).
Method	Live	GET, or POST with the customer’s message as {"message": "…"} JSON.

Runtime behavior

Before the agent thinks, Zapito calls your endpoint (10s timeout, redirects not followed) and hands the first 2,000 characters of the response to the agent as context, with the instruction to use it when it answers the question. If the call fails, the agent is told the tool was unreachable and to say it will check and get back to the customer — it never invents values.

There’s no auth header support yet, so the endpoint must be publicly readable. Don’t point it at anything secret.