AI Forms

Documentation Index

Fetch the complete documentation index at: https://docs.aipower.org/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Create a Form

1. Open AI Puffer > AI Forms > Forms.
2. Click Create New Form.
3. Enter the form title.
4. In the left Layouts accordion, drag a layout into the center designer.
5. In the left Form Elements accordion, drag fields into the layout columns.
6. Click a field in the designer to edit it in Element Settings.
7. In the right AI container, select the model.
8. Write the form prompt in the AI container.
9. Click Validate Prompt to check field placeholders.
10. Click Save.
11. Click Preview to test the form from the admin screen.

​

Form Elements

​

Layouts

​

Multi-Step

1. Turn on Enable Multi-Step.
2. Choose Display Progress.
3. Hover a row in the designer.
4. Click the chat bubble icon to configure that row as a step.
5. Add a step title and description if needed.
6. Add a condition if the step should appear only for specific answers.
7. Save the form.

​

Workflow

1. Create and save the target AI Form first.
2. Edit the source AI Form.
3. Turn on Enable Workflow.
4. Choose the default Next AI Form.
5. Use Send AI output to to prefill a target text field with the source form’s AI response.
6. Click Add Mapping under Map submitted answers to pass source answers into target text fields.
7. Click Add Route under Conditional routes if different answers should open different target forms.
8. Optional: turn on Auto-submit next form if the next form should run as soon as mapped values are filled.
9. Save the source form.
10. Test the source form with Preview or its shortcode.

​

Examples

Domain idea to blog post

Use this workflow when the first form suggests domain names and the second form turns the selected direction into a launch blog post draft.Create the target form first:

1. Create Blog Post Draft.
2. Add a Text Area field named domain_suggestions.
3. Add a Text Area field named business_context.
4. Add a Text Input field named tone.
5. Write a prompt that chooses a strong domain from {domain_suggestions} and writes a blog post using {business_context} and {tone}.
6. Save the form.

Then create the source form:

1. Create Domain Name Generator.
2. Add a Text Area field named idea_description.
3. Add a Dropdown field named tone.
4. Write a prompt that suggests domain names from {idea_description} and {tone}.
5. Open Workflow.
6. Turn on Enable Workflow.
7. Set Next AI Form to Blog Post Draft.
8. Set Send AI output to to domain_suggestions.
9. Add a mapping from idea_description to business_context.
10. Add a mapping from tone to tone.
11. Optional: turn on Auto-submit next form if you want the blog post draft to start immediately after domain ideas are generated.
12. Save and test the source form.

When the visitor submits the source form, the generated domain ideas appear in the target form. The original business description and tone are also prefilled.

Lead intake router

Use this workflow when one intake form should route visitors to different next forms based on their request type.Create the target forms first:

1. Create Sales Follow-up with fields named company_name, intake_summary, and lead_notes.
2. Write a prompt that drafts a sales follow-up from those fields.
3. Create Support Reply with fields named company_name, intake_summary, and customer_message.
4. Write a prompt that drafts a support reply from those fields.
5. Save both target forms.

Then create the source form:

1. Create Lead Intake Router.
2. Add a Text Input field named company_name.
3. Add a Dropdown field named request_type with values such as sales, support, and partnership.
4. Add a Text Area field named request_details.
5. Write a prompt that summarizes the lead from {company_name}, {request_type}, and {request_details}.
6. Open Workflow.
7. Turn on Enable Workflow.
8. Set Next AI Form to Sales Follow-up as the default route.
9. Add a route where request_type equals support, then set the target to Support Reply.
10. In that route, map AI output to intake_summary, company_name to company_name, and request_details to customer_message.
11. Add a route where request_type equals sales, then set the target to Sales Follow-up.
12. In that route, map AI output to intake_summary, company_name to company_name, and request_details to lead_notes.
13. Optional: turn on Auto-submit next form if each routed target form has everything it needs from the mappings.
14. Save and test the source form with both request types.

Sales requests open the sales follow-up form. Support requests open the support reply form. Other request types fall back to the default next form.

​

Labels

​

AI

​

Prompt

Write a customer support reply.

Customer message:
{customer_message}

Tone:
{tone}

Next step:
{next_step}

​

Knowledge Base

1. Turn on Knowledge Base.
2. Click the settings icon beside Knowledge Base.
3. Select Vector provider.
4. Choose the vector store, index, or collection.
5. For Pinecone, Qdrant, or Chroma, select the same Embedding model used when the content was indexed.
6. Set Limit and Score threshold.
7. Save the form.

​

Web Search

1. Select an OpenAI, Google, Anthropic, OpenRouter, or xAI model.
2. Turn on Web Search.
3. Click the settings icon beside Web Search.
4. Configure the provider options.
5. Save the form.

​

Connected Apps

1. Go to AI Puffer > Settings > Apps.
2. Connect the app account or webhook destination.
3. Create or enable a recipe that uses the AI Form Submitted event.
4. Choose the scope: All AI Forms, This AI Form, or Selected AI Forms.
5. Return to AI Puffer > AI Forms.
6. Edit the form and check the right-side Connected Apps container.
7. Submit the form on the frontend to test the recipe.

​

Manage Forms

​

Publish

​

Shortcode

[aipkit_ai_form id=123]

[aipkit_ai_form id=123 theme="dark"]
[aipkit_ai_form id=123 show_provider="true" show_model="true"]
[aipkit_ai_form id=123 save_button="true" copy_button="true"]
[aipkit_ai_form id=123 pdf_download="true"]

​

Block

1. Edit the page or post.
2. Add the AI Form block.
3. Select the form.
4. Choose the theme and display options.
5. Save the page.

​

Result Actions

​

Settings

​

Limits

1. Set Guest quota.
2. Choose Quota mode for logged-in users.
3. Set User quota or Role-based quotas.
4. Choose Reset period.
5. Edit Quota reached message.
6. Configure optional primary and secondary buttons.

​

Custom CSS

.aipkit-ai-form-wrapper.aipkit-theme-custom {
  /* custom form styles */
}

​

Provider Filtering

​

Logs

​

Troubleshooting