Intents

An Intent is a named NLP trigger for an Agent. When a user message semantically matches the intent's phrases, the conversation branches into the flow node wired to that intent.

Intents are agent-scoped. They live under one Agent and are referenced by TRIGGER_INTENT nodes inside that agent's Flows.

Each entry in phrases is { id: number, phrase: string }.

• On create, send an array of plain strings.
• On update, you can mix entries with id (to keep/edit) and without id (to add new ones). Missing IDs are deleted.
• At least one phrase is required.

created → ACTIVE  ←→  INACTIVE  →  ARCHIVED

An INACTIVE intent is preserved but stops matching incoming messages.

You don't have to write all phrases by hand. The API can suggest phrasings for you:

POST /public/v1/agents/{agentId}/intents/generate-phrases

Body:

{
    "name": "cancellation",
    "samples": ["cancel order", "I want to cancel my subscription"],
    "amount": 5
}

amount is bounded to 1–50. The response returns suggested phrases that you can then send back via the create/update endpoints.

The list endpoint paginates; all returns the full set in one call. Both accept a filterText query.

frontline agents intents list --table
frontline agents intents create --name cancellation --phrases '["cancel order","stop subscription"]'
frontline agents intents generate-phrases --name cancellation --samples '["cancel order"]' --amount 5