What is Workato GO?
Workato GO is the Workato component that gives users a single interface for chatting with genies, searching for knowledge, and completing tasks such as approvals. A genie is an AI-powered agent that you build in Agent Studio and deploy to Workato GO as its chat interface. Workato GO searches two knowledge sources: world knowledge, which is publicly available information, and company knowledge, which is your company’s apps and internal documentation. A data source is a connection between Workato GO and a business system, such as Jira, Confluence, or Google Drive, that Workato GO indexes to make company knowledge searchable.
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 Workato GO issues, or help you work around them:
1. Check the Workato GO URL
Open Workato GO at the URL of your own account, for example, https://your-domain.workato.ai. Make sure you are using the correct subdomain, not a demo instance.
2. Check that the genie is available to you
If a genie does not appear in Workato GO, open it in AI Hub > Agent Studio and check the following:
- The genie is started
- Workato GO was selected as its chat interface in the Triggers section
- The genie is assigned to your user group on its End user access page
- You have activated your Workato Identity account
3. Check your search settings and access
If the search does not return the expected results, select the right knowledge source in the search drop-down menu: Company knowledge for your apps and internal documentation, or World knowledge for public information. Workato GO respects the permissions of the source systems, so you only see documents that you can open in the source app. Check that you can open the document there. If the content does not appear at all, ask your Workato GO administrator to check the data source.
4. Check your network
Workato GO uses Server-Sent Events (SSE), a standard way for a server to push a continuous stream of updates to your browser. If chat messages do not update in real time or the connection closes immediately, a firewall, a proxy, or an internet service provider restriction may block this connection. Ask your IT team to:
- Allowlist the Workato GO domain for your data center, for example, api-prod.matrix.workato.com
- Allow streaming connections to that domain
- Make sure that proxies and firewalls do not end long-lived connections
5. 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.
6. Reload the page or try another browser
Refresh the browser tab and try again. If the issue persists, try another browser or a private (incognito) window. This rules out extensions, cached data, or browser settings.
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
- Workato GO URL
- Workspace ID
- Genie and conversation IDs
- Search details
- HAR file
- Screenshots
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
- Whether it worked before or is a new setup
Workato GO URL
The URL of your Workato GO account helps Product Support find the affected account. Copy the base URL from the browser address bar, for example, https://your-domain.workato.ai.
Workspace ID
Each environment (Development, Test, Production) has its own workspace ID. Provide the ID of the environment where the affected genie is configured. To find it:
- Open the environment where the issue can be reproduced
- Navigate to Workspace Admin > Settings > General
- Copy the Workspace ID value
Genie and conversation IDs
If the issue occurs in a conversation with a genie, collect the genie ID and the conversation ID. If you do not have access to Agent Studio, ask your Workato administrator to provide the 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.
Search details
If the issue is with search, include:
- The exact search query
- The knowledge source you selected: World knowledge or Company knowledge
- The app and the document or page that you expected to find
HAR file
A HAR file is a recording of your browser’s network traffic. It helps Product Support investigate issues in Workato GO.
Open Workato GO and navigate to the place where the issue occurs
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)
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
Go to the page in Workato GO where the issue occurs and take a screenshot of the full browser window, so that the error and the address bar are both visible.
Comments
0 comments
Please sign in to leave a comment.