Using NxAgent Chat

NxAgent is an AI-powered assistant embedded directly into the Koodisi workspace. The chat panel is where most AI-assisted work starts: you describe what you want, NxAgent proposes it, and you decide what gets applied.

You remain responsible for reviewing generated content, testing changes, and deciding what enters an application.

Before you begin

• AI chat must be enabled for your account. If the panel does not open, contact your organization administrator.
• Open the application you want to work in. NxAgent answers against the application you have open.

Open the chat panel

1. Select the Generate icon in the top toolbar.
2. To close the panel, select the same icon again.

The panel opens on the right of the workspace, showing example prompts you can select to prefill the input.

Choose a mode

Select a mode from the mode selector at the bottom left of the input box before you send your first message.

Mode	Use it for
Build	Creating and editing workflows, mappings, and other application artifacts
Design	Working through requirements before committing to a build
Ask	Questions only, including health, error, and how-to questions

Ask is read-only. It looks things up and explains them but cannot change your application, which is what you want while investigating a problem.

note

Build appears only where build mode is enabled for your workspace. If you do not see it, your administrator controls this setting.

Set a response style

The response style controls how much explanation you get back. Select the style control in the input toolbar, then choose one.

Style	Best for
Concise (Default)	Direct answers with no filler. Best for experienced users.
Learning	Deeper explanations, background, and anticipated follow-ups.
Explanatory	Thorough walkthroughs, trade-offs, and structured sections.
Formal	Precise, professional language suited to stakeholder-facing output.

Attach context

Attaching an existing workflow or schema makes answers specific to your application rather than general.

1. Select the attachment control in the input bar, or drag a workflow or schema from the left sidebar into the chat input.
2. To remove an attached item, select ✕ on its tag.
3. Enter your prompt and send it.

Use the smallest useful context. Remove unrelated workflows and schemas before sending.

Write an effective request

State the outcome, the constraints that matter, and how you will judge the result.

Create a webhook workflow that validates an employee record, rejects requests without an employee ID, and returns a clear error. Use the attached schema. Do not change existing workflows. Show me the proposed changes before applying them.

For investigation, include the environment, the time window, the symptom you observed, and the behavior you expected.

warning

Do not include passwords, tokens, keys, or customer data in a prompt.

Review generated changes

When NxAgent proposes changes, it stages them for your review rather than writing them straight into the application. The preview can include workflows, resources, schemas, and variables.

1. Open the generated-change preview.
2. Select an item from the file list.
3. Select Preview to inspect the complete proposed artifact, or Diff to compare it against the current version.
4. Select Accept to apply the selected item, or Reject to leave the application unchanged. To act on every proposed item at once, use Accept All or Reject All.

Accepting a deletion or replacement changes the selected application. Check the application context and file path before you confirm.

Auto-accept

The Auto-accept changes toggle applies proposed changes without waiting for file-by-file approval.

warning

Keep Auto-accept changes off for shared applications, unfamiliar tasks, and release-critical work.

Manage conversations

• To start a clean conversation, select New Thread in the panel header. Earlier conversations are saved.
• To reopen an earlier conversation, select History in the panel header and choose a session.
• To give long previews and charts more room, maximize the panel from the header.

How you know it worked

The panel shows your message, NxAgent's response, and — for generated artifacts — a preview you can inspect before accepting. Nothing reaches your application until you accept it.

When it does not work

Symptom	Cause	What to do
Answers are generic, not about your workflow	No context attached	Attach the workflow or schema, then resend
The mode selector will not change	The mode is fixed once a thread starts	Select New Thread, then choose the mode before sending
No Accept action on a response	The response is text, not a generated artifact	Only workflow, schema, and similar artifacts can be accepted
The Generate icon is missing	AI chat is not enabled for your account	Contact your organization administrator

Next steps

• Building Workflows and Mappings — generate workflows and data mappings from a description.
• Governing AI — organization controls, AI skills, and credit limits.