Chats

A chat is a conversation with the built-in LLM where you describe what you want an agent to do. The LLM interprets your request, generates the agent's instructions and skills, and assembles a complete agent definition ready to deploy.

Chats serve two purposes:

• One-off tasks: Ask the LLM to query recent device data, summarize an incident, or analyze a set of MQTT events without creating a persistent agent.
• Agent authoring: Describe an automation goal, iterate on the behavior through follow-up messages, and deploy the result as a long-running agent.

View Chats

Click Chats in the left menu to open the Chats page. The list shows all chats in this deployment with the following columns:

Column	Description
Title	The chat title, auto-generated from the first message. Click to open the chat.
Deployed Agent	The agent deployed from this chat, if any.
Updated At	When the chat was last active.
Actions	Rename or delete the chat.

Start a New Chat

1. Click Chats in the left menu.
2. Click + New Chat.
3. Optionally select connectors to make available for this session (see Select Connectors).
4. Type your request in the input field and press send.

The input field placeholder shows example prompts to help you get started, such as:

• Query recent power draw from EMQX Tables and summarize line-3 motor usage
• Detect stalled robot arm telemetry from MQTT topics and page the on-call team

These are suggestions only. Describe your own use case in plain language.

Select Connectors

Before or during a chat, you can select which connectors the LLM has access to. The LLM uses the selected connectors when generating an agent definition, for example to configure the MQTT trigger topic or the target of a mqtt.publish action.

To select connectors:

1. Click the connector icon in the lower-left corner of the input area. A Connectors panel appears listing your configured connectors.
2. Check the connectors you want to make available for this session.
3. To add a new connector, click + in the upper-right corner of the panel. This opens the Add Connector form without leaving the chat.

If no connectors are selected, the LLM can still respond to general questions but cannot generate an agent definition that references a specific broker or Tables instance.

Thinking Mode

The input area has a thinking mode selector in the lower-right corner. Two modes are available:

Mode	Description
Thinking	The LLM applies more reasoning before responding. Suitable for complex agent definitions with multiple tools or skills.
Instant	The LLM responds faster with less reasoning. Suitable for simple questions or one-off tasks.

Select the mode that fits your request before sending.

Refine the Agent Definition

After the LLM responds, you can continue the conversation to refine the agent:

• Ask the LLM to adjust the trigger topic, change the threshold, or add a new tool.
• Request a different skill implementation or a more conservative alerting condition.
• Ask the LLM to explain what it generated before you deploy.

Each follow-up message updates the agent definition in the workspace. The LLM retains context across all messages in the same chat.

Deploy an Agent from a Chat

When the LLM has generated an agent definition, a Deploy Agent button appears at the bottom of the chat.

1. Review the generated definition. You can ask follow-up questions or request changes before deploying.
2. Click Deploy Agent. A dialog appears with a pre-filled Agent Name and Description generated from the chat.
3. Optionally edit the name or description, then click Deploy Agent in the dialog.
4. The agent detail page opens. The agent may take a few minutes to reach Running status.

TIP

Deploying an agent from a chat does not close or archive the chat. You can return to the same chat later to update the agent's behavior and redeploy.

Redeploy from a Chat

To update a deployed agent, return to the originating chat and continue the conversation:

1. Open the chat from the Chats list.
2. Describe the changes you want to make.
3. Click Deploy Agent again when the LLM has updated the definition.

Redeploying replaces the running agent with the new definition. The previous run history is preserved.

Rename a Chat

1. On the Chats list page, click the edit icon in the Actions column.
2. Enter a new title and confirm.

Delete a Chat

1. On the Chats list page, click the delete icon in the Actions column.
2. Confirm the deletion.

Deleting a chat does not affect any agents that were deployed from it. The agent continues running independently.

Next Steps

• Manage Agents
• Manage Connectors