What is Agent Studio?
Agent Studio is the Workato component that allows you to build and configure AI agents, called genies. A genie is an AI-powered agent that understands user requests and performs actions, such as retrieving information from an app or running an automation, using the instructions, skills, and knowledge you configure. Users can interact with genies via Slack, Microsoft Teams, or Workato GO.
Before you open a ticket
First, check status.workato.com for an ongoing incident. If there is one, follow its updates and check the affected functionality again once it is resolved.
The following actions often resolve the most common Agent Studio issues, or help you work around them:
1. Reproduce the issue in Test mode
Open the genie in Agent Studio and send the same request in Test mode. The conversation shows which skills the genie called, what inputs it passed to them, what information it retrieved from the knowledge base, and how it used that information in its reply. If the genie called the wrong skill or passed the wrong inputs, adjust the genie’s instructions or the skill’s description and test again.
2. Check that the skill is assigned to the genie
If the genie does not call the required skill, open the genie’s Skills tab and confirm the skill is listed there. A genie cannot use skills that are not assigned to it.
3. Reload the page
If you use the genie in the Workato UI or Workato GO, refresh the browser tab and try again.
4. Retry the request
Genie responses are generated by AI and can vary between attempts, even for the same request. Repeat the request a few times. If the genie seems stuck or the conversation behaves unexpectedly, start a new chat and repeat the request there. Note whether the issue occurs every time or only sometimes.
5. Try another browser or a private (incognito) window
This rules out extensions, cached data, or browser settings. If it works there, disable extensions in your regular browser one by one.
6. Check your network
Corporate proxies, VPNs, or firewalls can block parts of the Workato UI. Try from a different network, or ask your network team to confirm that Workato is reachable. See IP allowlists and gateway domains.
Information to include
If the issue persists, open a ticket and mention what you tried. Including the following information in your ticket helps Workato Product Support resolve it faster:
- Details of the issue
- Genie and Conversation IDs
- Workspace ID
- HAR file
- Screenshots
- Messenger info
How to collect it
Details of the issue
Describe the following:
- Detailed steps to reproduce the issue
- What you were trying to achieve and the current result
- The exact error message, if any
- Timestamp of the last occurrence, with time zone
- How often the issue occurs
- Any recent changes
Genie and Conversation IDs
Genie ID is the identifier for a genie and follows this format: gin-XXXXXXXX-XXXXXX-XX. Conversation ID is the identifier for a specific chat within Agent Studio and follows this format: conversation-XXXXXXXXXXXXXXXXXXXXXXXXXX.
To obtain both IDs:
- Open the Agent Studio section in the UI
- Click the affected genie
- Switch to the Conversations tab
- Open the conversation where the issue was reproduced
- Copy the URL from the browser address bar. It will contain both required IDs:
https://app.workato.com/genies/gin-XXXXXXXX-XXXXXX-XX/conversations/conversation-XXXXXXXXXXXXXXXXXXXXXXXXXX
If the result differs between attempts, provide the conversation IDs of one failed and one successful attempt. Repeat the steps above for each conversation.
Workspace ID
Each environment (Development, Test, Production) has its own workspace ID. Provide the ID of the environment where the issue occurs. To find it:
- Open the environment where the issue can be reproduced
- Navigate to Workspace Admin > Settings > General
- Copy the Workspace ID value
HAR file
A HAR file is a recording of your browser’s network traffic. It helps Product Support investigate issues that you can reproduce in the Workato UI.
Open browser developer tools:
F12orCtrl+Shift+I(Windows/Linux),Cmd+Option+I(macOS)Open the Network tab
Optionally select Keep log (called Preserve log in some browser versions)
Open a genie conversation where the issue occurs
Reproduce the issue
Click the Export HAR (down arrow) icon and save the file
- Attach the file to your ticket
A HAR file can contain sensitive data, such as cookies and the contents of your genie conversation. Share it only through the ticket.
Screenshots
In the Workato UI, go to the page where the issue occurs and take a screenshot of the full browser window, so that the error and the address bar are both visible. In Slack or Microsoft Teams, take a screenshot of the chat where the issue occurs.
Messenger info
Include the following:
- The messenger you use, its version, and whether you use it in the desktop app, the browser, or the mobile app
- Where you talk to the genie: a direct message or a channel
- Whether the issue affects all users or only some of them
- Whether the same request works in the Agent Studio Test mode or in another chat interface
Comments
0 comments
Please sign in to leave a comment.