--- title: "Copilot - Simple defect report" slug: "simple-defect-reporting-with-ai" updated: 2026-08-18T07:52:29Z published: 2026-08-18T07:52:29Z canonical: "support.tulip.co/simple-defect-reporting-with-ai" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Simple Defect Reporting with AI To download the app, visit: [Library](https://tulip.co/library/apps/simple-defect-reporting-with-ai/) *Through seamless integration of AI, users can swiftly uncover answers to their queries* ## Purpose This application is designed to create new defect reports or find answers to questions within the already saved reports using AI functions. ## Setup Installing the app also installs the Connector in your Instance, called **Get Records**. You need to configure this connector to use it effectively. If the Get Records connector is offline, follow the process outlined in step 1. If the connector is already set up, you only need to update the authentication of the connector function, as detailed in step two. ### Step 1. Adding a Service Account Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. Navigate to the **Settings** page of your Tulip account. ![Settings.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Settings.png) 2. Select **Tulip API** from the menu and click on **Create Service Account**. ![Create API token1.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token1.png) 3. Provide a name for the Service Account and define the scopes it will be allowed to perform. For example, in this instance, the Service Account is configured to read from Tulip Tables. ![Create API token2.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token2.png) 4. After clicking **Create**, the API information will be provided. **Save this information as it cannot be accessed again.** ![API token 3.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/API%20token%203.png) 5. Next, navigate to the **Connectors** and set up the connector named Get Records. ![Connector-getrecords.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Connector-getrecords.png) 6. Clicking on the connector's name takes you to the **connector settings**. On this page, click the button marked with a red border to configure the connector details. Select the **Cloud Connector host** on the Running On field and update the host field with your instance URL. If everything is set correctly, click on the **Test** button. If there are no errors, you can save the settings. ![Screenshot 2024-01-17 at 11.06.11.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202024-01-17%20at%2011.06.11.png) ### Step 2. Updating the Authentication. 1. Update the username and password for the connector function used in the Copilot - Simple Defect Report app. 2. Change the authentication method from 'no auth' to 'basic auth', and then copy the API key from the Service Account, using it as the username and the Secret as the password. This ensures proper authentication for the connector, enhancing security and access control. ![Screenshot 2024-01-16 at 12.38.44.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202024-01-16%20at%2012.38.44.png) 3. Save the changes, and now you are ready to use the Copilot - Simple Defect Report app. ## Tables Used **(Log) Deviation Events** - This table is used to track defect or deviation events. Each entry in this table corresponds to a unique event related to a single material or the observation of a deviation. Each line in the table may represent multiple quantities associated with the event, providing a comprehensive overview of deviations and defects within the system. ## App Structure This app provides a simple solution, enabling users to quickly obtain answers to their questions using AI. In this step, users have the option to create a report after entering all three required fields: statement of the problem, the root cause, and the corrective action. Clicking **Create New Report** saves this entered information to the table. By selecting a report from the list and clicking **Load Report Data**, the required fields are populated with the selected report, aiding users in creating a report without starting from scratch. To find an answer, users need to enter their question in the search parameter field and then click on the **Search** button. The question doesn't necessarily need to start with 'Is there any issue about...'; it could be any question. ![Copilot-Simple defect report.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Copilot-Simple%20defect%20report.png) ## Further Reading - [Document Q&A with Copilot](/r230/docs/document-qa-with-copilot) - [How to Use the Table API](https://support.tulip.co/docs/how-to-use-the-table-api) **Connectors** **Connectors** enable real-time connectivity between your Tulip solution and a transactional system (e.g. an ERP). The output of a Connector Function can be used in Tulip Apps, Automations, and Functions. - **HTTP Connectors** utilize HTTP API endpoints. - **SQL Connectors** can enable connectivity with certain SQL databases. - **MQTT Connectors** can connect to MQTT brokers for machine monitoring. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/connector.gif) **Tulip Instance** A Tulip customer account. Your instance can be found at https://[your-instance].tulip.co When *your instance* is referenced, we are just talking about your Tulip account on an organization-level, not user-level. **Tulip Tables** **Tulip Tables** are a global location to store your production data. **Tables** are made up of **Records** (rows). A single can be accessed from multiple apps or stations at the same time. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Tables%20Overview%20-%20Feature%20Overview(1).gif)