Agent Setup & Scheduling
Availability times look wrong- Confirm the agent time zone is set correctly
- Double-check whether you’re using 12-hour vs 24-hour format
- Review if you applied a schedule across days accidentally
- Ensure you clicked Save Changes
- Refresh and re-open the agent profile to confirm
Knowledge Base
Scrape completed but AI isn’t using the content- Click Sync after scraping
- Confirm the scraped content appears in files/folders
- Try re-scraping if the URL was incorrect or incomplete
- Large websites take longer than smaller ones
- Start with the main domain (not deep links)
- Wait and check for new structured files after completion
- Update the file manually or re-scrape your website
- Always Sync after changes
Actions & Integrations
Integration connected but actions don’t work- Re-authenticate the integration (tokens can expire)
- Confirm the correct account is connected (e.g., correct Google account)
- Verify the action endpoint/config is correct
- Check headers (Authorization key is the #1 cause)
- Confirm endpoint URL is correct
- Verify required arguments are provided
- Confirm it was added successfully under Integrations
- Refresh the page and check again
- Disconnect and re-integrate if it didn’t complete authentication
Custom AI Experts and Memory
Run now is disabled for a scheduled expert- Confirm Schedule is selected as a trigger.
- Turn the expert Active.
- Save any unsaved changes.
- Check whether the expert is marked as broken or missing required settings.
- Confirm the expert is Active.
- Review the Timezone and repeat schedule.
- Check the Next run field after saving.
- Make sure the schedule goal is filled in.
- Confirm the connected app is integrated and healthy.
- Open External trigger settings and click Select trigger again.
- Search by the integration or account name.
- Reconnect the integration if its status shows unavailable.
- Open the expert and review Allowed tools.
- Remove broad tool groups the expert does not need.
- Save the expert and test again.
- Refresh AI Studio > Memory.
- Switch between Organization and User to confirm the selected scope.
- If the page shows an error message, wait a moment and try again.
- Confirm the file finished loading before editing.
- Click Save after making changes.
- Wait for the Memory saved confirmation.
- If the save fails, copy the intended change into a temporary note and try again after refreshing.
Abilities (Create, Edit, Triggers, Registration)
Ability doesn’t trigger- Trigger conditions may be too strict or not matching user phrasing
- Confirm the interaction is happening through a supported channel (phone/email/live chat)
- Ensure the ability is saved and active
- Triggers may overlap across multiple abilities
- Make trigger phrases more specific
- Reduce redundancy by consolidating abilities
- The user may not be recognized as registered
- Ensure the workflow collects the right fields needed for registration
- Verify registration logic inside the ability workflow
Building Abilities (Ask, Speak, Act, Condition)
Condition branch never runs- Variable name may be wrong (must match exactly)
- Condition value may not match what users actually type (case/spacing)
- Ask prompt may not be collecting consistent responses (add examples)
- Ensure your ticket instructions reference the correct variables
- Confirm Ask nodes are connected before the Act node
- Add optional parameters only if your workflow has those values
Best Practices for AI Studio
- Scrape your website first, then Sync
- Keep Knowledge Base file titles clear and specific
- Use Condition nodes for decision points, not long prompts
- Keep triggers specific to avoid overlap
- Use Registration abilities only when identity matters
- Test every branch before production use
- Review integrated actions periodically and remove unused integrations
