AI Generator Setup in Action Jail (Administrator)

The AI generator in the Action Jail action editor allows quick generation of code, JSON config, and documentation using an LLM (without connecting an agent). To work, you need to configure an API key (OpenAI token) for the selected process (bot).

When to use

• You need to use the "Quick Generate", "Generate from Code", "Generate Documentation" buttons in the action editor.
• AI generation does not work or shows the error "Select a process (bot) in the sidebar".

What to know

• Token is stored at the process (bot) level — each bot can have its own key.
• Fallback source — if the bot has no key, the global openai_token from Instance Settings is used.
• No agent — generation goes directly via the POST /kw/fast_line/ai_text_editor/ endpoint, without Instance Agent or MCP.

Before you start

• You have an OpenAI API key (or compatible provider via Portkey).
• You have permissions to configure the process (bot) or Instance Settings.
• A process (bot) is selected in the Constructor sidebar — otherwise AI generation will show an error.

Step-by-step instructions

Option 1: Token for a specific process (bot)

1. Open Fast Line (or another module where the OpenAI token for the bot is configured).
2. Select the required process (bot) in the sidebar.
3. In the Import section (or equivalent), find the "OpenAI Token" / "Add Token" block.
4. Enter the API key and save.
5. In Action Jail, select the same process in the sidebar — AI generation will work for this bot.

Technical details: The token is stored in kw_bots.custom_json.openai.token for the selected bot_id.

Option 2: Global token (Instance Settings)

1. Open Settings → Instance Settings (or equivalent for your instance).
2. Find the key openai_token.
3. Set the value — OpenAI API key.
4. Save. This token is used if the bot has no key of its own.

Technical details: The value is stored in kw_engine_settings with key = 'openai_token'.

Where groups and descriptions appear

• Action groups — in the Action Jail library in the "Select action group" dropdown (left sidebar when opening an action).
• Action description — in the "Describe the action functionality..." field in the "Action Information" section; used for hints and reference guides.
• Parameter description — in each parameter in the JSON config / UI schema; displayed as a hint next to the field in the Scenario Builder form.

How to verify success

• A process (bot) is selected in Action Jail in the sidebar.
• Clicking "Quick Generate" or "Generate from Code" does not show the "Select process" error.
• Generation returns a result (code, JSON, or text) instead of a network or 422 error.

Troubleshooting

Related instructions

• How to create and manage actions
• Action editor sections
• Actions Reference