# Creating a script with AI
## Introduction
The custom script editor includes an integrated AI agent, so you can get real-time assistance creating and updating scripts!
Our AI integration knows about expected keys and value types (payload, variables, meta, etc.), so generated scripts will be in a form that's ready to use in process flows.
{% hint style="info" %}
For the best results from AI, use PHP, JavaScript, Python, or GO. AI does work for other languages however, you will need to provide significantly more context in your requests.
{% endhint %}
Show me
## Need to know
* The maximum memory size for a custom script is 512MB
* The maximum size of a custom script is 4GB
* Up to 5 AI requests can be made per day for any company profile, free of charge.
* A [subscription tier bolt-on](/product-documentation/getting-started/subscription-tier-limits.md) can be purchased if you'd like to increase this allowance.
* You can view the number of AI requests used and remaining from your [AI conversation history](/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/creating-a-script-with-ai/ai-conversation-history.md).
* AI prompts can be up to 1500 characters.
* Sample payloads for an AI request can be up to 6000 characters.
## Using AI to create a script
Follow the steps below:
**Step 1**\
Log in to the [Patchworks dashboard](https://app.wearepatchworks.com/scripts) and select `scripts` from the left-hand navigation bar.
**Step 2**\
Select the `create script` button:
**Step 3**\
Add a unique `name` and a `description` and then choose your preferred coding language:
{% hint style="warning" %}
Script names must be unique - you can't add two scripts with the same name.
{% endhint %}
**Step 4**\
Move down to the Patchworks AI panel and enter your prompt (be as clear and specific as possible) - for example:
{% hint style="info" %}
The Patchworks AI panel is displayed as soon as your coding language is selected in the previous step.
{% endhint %}
**Step 5**\
If you have a sample payload and would like to provide it for clarity, select the `provide an example payload?` checkbox and paste in your payload - for example:
We recommend providing a sample payload whenever possible, as it provides valuable context to the AI agent.
Sample payloads don't have to be perfect (or valid code) - as long as the structure and format are described correctly, the AI agent should have enough to work with. For example, if you don't have a JSON payload available, you might enter something like:
{% code overflow="wrap" %}
```
The payload comprises a JSON object containing multiple fields and associated values. There are no arrays.
```
{% endcode %}
**Step 6**\
Click the `generate` button:
{% hint style="warning" %}
Each time you `generate` a script, the [AI request allowance associated with your subscription tier](/product-documentation/getting-started/subscription-tier-limits.md) is decremented. You can view the number of AI requests used and remaining from your [AI conversation history](/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/creating-a-script-with-ai/ai-conversation-history.md).
{% endhint %}
**Step 7**\
AI generates a first pass of the script, which is displayed in an overlay:
{% hint style="info" %}
If your request is ambiguous (for example, you indicate that you require some specific fields to be added but don't stipulate what these are), you may be prompted for clarification:\
\
In this case, enter your response in the comments field and click `send reply`.
{% endhint %}
From here:
* If you are satisfied that the script is correct, or that you at least have enough to work with independently, click `accept script`:\
\
You can't edit the generated script in the AI 'overlay' window - you need to accept it and then make any required updates in the standard script editor.
\
Having accepted a script, it opens in the [standard script editor](/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/creating-a-script-manually.md#adding-and-editing-script-code) so you can [save](/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/creating-a-script-manually.md#adding-and-editing-script-code), [edit](/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/creating-a-script-manually.md#adding-and-editing-script-code) and [test](/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/testing-scripts.md) the code as needed.
Always test your scripts to ensure that the results are as expected.
* If you want to refine your requirements and ask AI to generate again, update the `comments` field and click `send reply`:\
\
\
Then, if you are satisfied that the script is correct, or that you at least have enough to work with independently, click `accept script` - otherwise you can refine your requirements again.
* If you want to close the script and exit back to your original prompt, click `close`.
* If you feel that the generated response is not appropriate/helpful, click `report`. This marks the conversation for review by Patchworks.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.wearepatchworks.com/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts/creating-a-script-with-ai.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.