# Recipe Copilot in recipe building
Recipes are the foundation of any automation strategy on Workato. However, building a recipe can be challenging when you're uncertain about where to start. Recipe Copilot addresses this challenge by generating a sketch outline based on your description of the recipe you plan to build.
Recipe Copilot also supports the development and refinement of your recipes. Whether you add new steps, modify existing ones, or fine-tune configurations, Recipe Copilot provides a flexible and interactive process to ensure your automation aligns with your goals.
# Prerequisites
- Ensure that you have Copilot enabled for your workspace. Enabling Copilots requires an Admin system role. If you aren't assigned this role, contact your workspace administrator to enable this feature. Refer to our Copilots documentation for more information.
# Describe and sketch your automation
To create a recipe, outline the intended workflow and specify relevant apps. Recipe Copilot sketches the flow based on your description, providing a foundation for your automation process.
Recipe Copilot outline prompt
Phrase your prompts carefully to enhance the quality and relevance of Recipe Copilot's responses. Use the following tips to create effective prompts:
- State applications and objectives clearly to help Recipe Copilot understand your requirements and generate accurate suggestions.
- Use clear, descriptive language to outline your workflow or the task needing assistance.
# Examples of effective prompts
Consider the following examples to understand how to craft effective prompts for Recipe Copilot and what to avoid:
Vague: "Issue notification."
- This prompt lacks context, making it difficult for Recipe Copilot to generate useful suggestions.
Better: "Sync Jira to Slack when a high-priority issue is created."
- This prompt specifies the apps (Jira and Slack) and includes a condition (high-priority issue), but it still lacks details about the specific actions to take.
Best: "Notify the engineering team in Slack and create a Trello card when a new high-priority Jira issue is created, including the issue title, description, and due date."
- This prompt is clear and detailed, naming the involved apps (Slack, Jira, Trello), specifying the condition, and outlining the objective and required information. This gives Recipe Copilot the context it needs to generate accurate suggestions.
# Start over
Click Start over at any time to restart the recipe-building process. This action resets the process based on the recipe's current state:
- While the sketch is loading: Resets the recipe to its empty state.
- When the sketch is loaded and ready for review: Resets the recipe to its empty state.
- When configuring steps: Disables the Start over button.
- After all steps are configured: Retains the configured steps but clears fields from steps Pending review.
- After all steps are configured and reviewed: Retains both the steps and their fields.
Start over in Recipe Copilot
# Review the sketch
After you describe your automation, Recipe Copilot sketches a flow of your recipe:
Recipe outline in Recipe Copilot
Click Looks good to approve the sketch. To make changes, type your updates in the prompt to refine the sketch.
# Interact with and refine the sketch
Recipe Copilot offers a flexible, iterative process, enabling you to refine the sketched outline as needed. Use the following methods to adjust the sketch and tailor it to your automation goals:
# Set up connections
After you approve the recipe sketch, Recipe Copilot prompts you to set up the necessary connections. This step links the apps and services involved in your automation.
Complete the following steps to set up connections when creating a recipe sketch using Recipe Copilot:
Review the connection prompt displayed by Recipe Copilot after you approve the recipe sketch. The prompt lists the apps and services required for your automation.
Connection setup in Recipe Copilot
Go through the list of connections provided by Recipe Copilot. For each app or service, you can:
- Select existing connections.
- Create new connections if none exist for the required apps.
- Click Edit apps used to change the app connectors for your recipe.
PERMISSIONS
If you lack permissions to create new connections, contact your workspace administrator.
Confirm all necessary connections.
Recipe Copilot automatically converts your sketch into an actual recipe, configuring the steps based on the connections you confirm.
Generated recipe
# Review the generated recipe
After Recipe Copilot generates your recipe, you must review each step.
Complete the following steps to review the generated recipe:
Click each step labeled Pending review to start reviewing.
Review pending steps in Recipe Copilot
Review each step's configuration in the recipe and take the appropriate action:
- Click Accept all to approve all suggestions.
- Select Ignore all to reject all suggestions and make manual adjustments later.
If you reject suggestions or need adjustments, edit the steps as required. This may involve adjusting datapills, modifying conditions, or changing actions to meet your automation goals.
DATAPILL MAPPING
Recipe Copilot intelligently maps datapills into your actions. Confirm that the correct datapills are mapped to your recipe steps.
Manually adjust recipe
By reviewing and refining each step, you ensure that your recipe is optimized for your needs.
# Add or modify steps
After configuring your recipe, you can use Recipe Copilot to add new steps or modify existing ones. This flexible approach enables you to enhance or adjust your automation directly within the sketch outline.
Complete the following steps to add or modify steps in your generated recipe:
Ask Recipe Copilot to add a step or modify an existing one in the sketch outline by entering one of the following commands:
Add step
Modify an existing step
Provide more details about the step you plan to add or modify. For example:
After the meeting is scheduled in Google Calendar, send a summary email to the project stakeholders with the meeting details, the Jira issue description, and any relevant attachments or links.
Add a new step using Recipe Copilot
Review the updated sketch outline. If the modifications meet your requirements, click Looks good to approve the flow.
Review updated sketch
Select an existing connection or create a new one for the added or modified step in the sketch, if required.
Review the setup of the newly added or modified step within the sketch, making adjustments as needed.
Review new step configuration
After you’ve reviewed and approved all configurations, your recipe is ready for testing or further action.
# Error handling
When Recipe Copilot detects an issue during the recipe-building process, it identifies and highlights the problematic step. It then provides detailed information about the issue and suggests ways to resolve it.
# Test and debug
Before testing and debugging your recipe, complete the following steps to ensure it is secure:
Test and debug all steps in the recipe for functionality and accuracy.
Manage sensitive information by following secure data handling practices.
Apply best practices for error handling and monitoring throughout your recipe.
# Data usage
Refer to our appendix to see the data Recipe Copilot uses.
# Limitations
Recipe Copilot supports a wide range of automation tasks, but complex scenarios may require manual setup. For these cases, refer to Workato's recipe documentation.
Last updated: 10/3/2024, 6:12:06 PM