Getting Started
This section covers the information needed to get started using Copia Copilot.
Last updated
This section covers the information needed to get started using Copia Copilot.
Last updated
To access Copia Copilot, simply log into your app.copia.io account in a web browser and click the Copilot button in the upper left corner of the browser window.
Submitting your prompts to Copilot is easy. Simply enter your text prompt in the entry field and click the teal button at the right to submit the prompt. Clicking the square button during the prompt generation will cancel the prompt in progress. Visit our Best Practices section for guidelines on prompting techniques that result in the best responses.
There are two ways in which you can reference files in your prompts to Copia Copilot: direct file upload or selection from the Repository File Selector. This section will cover both options.
The preferred and easiest way to reference files is using the Repository File Selector on the left side of the Chatbot window. This feature allows you to select your PLC project file(s) and choose specific project elements to give to the AI as part of your prompt. This can also be used to add non-PLC files to your prompt as well, so long as they are one of the supported file types. See supported file types here.
Regardless of which approach you use to upload your file(s), the Copilot has a limit to the size of files that can be referenced. This is known as the token limit and is roughly proportional to size of the file(s) that are referenced. Prompts that exceed this token limit will result in the content not being attached to the prompt. See more info about this limitation here.
As shown in the image above, entire PLC files can be selected and "attached" to your prompt, assuming they fall within the token threshold. The image shows only Rockwell PLC project files being attached, but any other type of file that is selectable within the repo contents can also be attached. When attaching PLC project files, Copia will attempt to compress them to reduce the token count, so we recommend following the instructions in the next section when prompting about specific elements within the PLC project file.
If you are unable to select the entire PLC project file, or if you want to direct Copilot's focus to a specific area of the PLC project, you can click the View Project button that appears when hovering over any valid PLC project file, as shown in the image below. This will open the project viewer and allow you to view the individual elements of the project tree.
Any selected PLC project item will be shown in the breadcrumb beneath the prompt text entry field. Note that you can only select one project item at a time. However, as shown in the image below, you can select higher-level project elements such as Programs, and Copilot will reference all of the sub-elements, which would be the 6 Routines and 1 Tag List in this example.
While the Repository File Selector is the preferred way for referencing files, Copilot users can manually upload and attach reference files to their prompts. This can be done be clicking the clipboard button to the left of the prompt text entry window, as shown in the image below. Dragging and dropping files into the browser window is also supported.
Files that meet the size and file type criteria are denoted by a green checkmark to the right of the filename. Any attached files that don't meet this criteria are denoted by a red X symbol and will not be attached to the prompt.
Uploaded files will remain attached to every subsequent prompt unless removed. You can remove an uploaded file by hovering over the document icon next to the file name(s) and click the X button.
