AI Agents

Configure specialized AI personalities that handle conversations on your sites.

What is an Agent?

An agent is a configured AI personality assigned to a site. It defines which AI model is used, what the system prompt says, how creative the responses are, and which knowledge sources are available. Without a custom agent, the site uses global platform defaults.

You can create multiple agents and assign them to a site — each with different roles. InnConnect routes incoming conversations to the correct agent based on keyword matching. For example, a 'Sales' agent handles product questions while a 'Support' agent handles complaints.

AI Model Selection

Choose from Mistral Large (highest quality) or Mistral Small (faster and cheaper). Select based on the complexity of conversations you expect.

System Prompt

The system prompt sets the agent's personality, tone, and rules. Write it in plain language: 'You are a friendly hotel receptionist...' The agent follows these instructions in every conversation.

Skills

Skills are reusable capabilities — like searching a specific data table or calling an external API. Attach skills to agents to extend what they can do beyond answering questions.

Keyword Routing

When multiple agents are assigned to a site, InnConnect routes conversations based on keywords. The first agent whose keywords match the message handles it. One agent is always marked as default.

Creating an Agent

Go to Agents in the sidebar to create and manage agents.

Go to Agents → Create agent.
Give the agent a name and description (internal only — not shown to visitors).
Write a system prompt. Be specific: describe the agent's role, tone, what it should and should not do.
Choose the AI model and adjust temperature and max tokens if needed.
Save, then go to your site's settings to assign the agent.

Configuration Reference

Field	Description
Name	Internal name for the agent. Not shown to visitors.
Model	`mistral-large-latest` for best quality; `mistral-small-latest` for speed. Claude models available where configured.
System Prompt	Instructions that define the agent's personality, role, and boundaries. Written in natural language.
Temperature	Controls creativity. 0.0 = deterministic and precise, 1.0 = creative and varied. Default 0.7 suits most conversational use cases.
Max Tokens	Maximum length of a single AI response. Higher values allow longer answers but cost more credits.
Extended Thinking	When enabled, the model reasons step-by-step before answering. Produces more accurate answers for complex questions at higher credit cost.
Knowledge Base Access	When enabled, the agent searches the knowledge base before answering. Controlled per-agent via the configuration panel.

Assigning Agents to a Site

Agents are not global — they must be assigned to a specific site. One agent can be assigned to multiple sites.

Go to Sites → Edit site → Agents tab. Add one or more agents. Mark one as the default. For each non-default agent, specify routing keywords.

Multi-Agent Routing

When a message arrives, InnConnect checks each non-default agent's keywords against the message. The first match wins. If no keywords match, the default agent handles it.

Example: You have a 'Sales' agent with keywords price, buy, order, availability and a 'Support' agent as default. A visitor asking 'What is the price of the Pro plan?' is routed to Sales. A visitor saying 'My invoice is wrong' goes to Support (default).

Agent Skills

Skills extend what an agent can do. A skill is a named capability the AI can invoke — like querying a data table, fetching live data from an external URL, or running a workflow.

Skills are created under Agents → Skills and then assigned to individual agents. An agent can have multiple skills.

Tip: Always set a default agent. It handles all conversations that don't match any keyword rule. A well-written default agent is your safety net.