AI Actions

AI Actions allow your agent to execute external HTTP endpoints as tools.

Configuration Fields

• Action name (tool identifier)
• Description (when the model should use it)
• JSON Schema (tool parameters)
• Endpoint URL
• Method (GET or POST)
• Optional static headers

Example Schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string",
      "description": "Customer order ID"
    }
  },
  "required": ["orderId"]
}

Execution Behavior

At runtime, Dukon:

1. Registers configured actions as model tools.
2. Sends arguments from model tool calls to your endpoint.
3. Returns JSON response payload to model context.

Safety Recommendations

• Scope endpoints to least privilege.
• Add server-side auth and request validation.
• Implement endpoint timeouts and idempotency.
• Monitor tool error rates and payload quality.