--- description: Learn how to review your AI Agent instructions, identify configuration issues, and apply suggested fixes before publishing. title: How to Review AI Agent Instructions image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0 --- [NewWe just raised $62.5M in Series B! 🎉 What it means for you![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](https://respond.io/blog/respond-io-raises-62-million-series-b) Help me with... ⌘ 1. [All Collections >](/help) 2. [ Product >](/help/product) 3. [ AI Agents >](/help/ai-agents) 4. How to Review AI Agent Instructions # How to Review AI Agent Instructions Review your AI Agent’s instructions to identify configuration issues before publishing or updating the Agent. The review checks your **Instructions** and enabled **AI** **skill instructions** against your Workspace setup. It can identify invalid references, incorrectly configured AI skills, unsupported instructions, conflicting instructions and other issues that may affect how your AI Agent works. ## How to Review Your AI Agent 1. Go to **AI Agents**. 2. Create a new AI Agent or select an existing one to edit. 3. Click **Publish** (if the agent isn't published yet) or **Save** (if it's already published) — this automatically reviews your instructions. 4. Wait for the review to complete. 5. If issues are found, select **Review issues** to view them. You can review the issues and suggested fixes before making changes to your AI Agent. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3hEkcCSSSJf5AqQtRYDqwj/1f306e23d606ab4cbcd2d0a3312390bf/e3ad26b8-cda4-4d83-98f0-673af91ceb0e.png?fm=jpg&q=80&w=1200&fl=progressive) ## What the Review Checks The review checks several parts of your AI Agent configuration. ### References and Tokens The review checks that the Workspace items referenced in your instructions exist and are used correctly. This includes: * **Contact Fields:**`$FieldName` * **Workflows:** `!WorkflowName` * **Users and Teams:** `@UserName` and `@TeamName` * **Tags:** `%TagName` For example, an issue may be detected if your instructions reference a Contact Field or Tag that no longer exists. For Contact Fields, the review can also detect when a field value is used without enough context for the AI Agent to understand what the value represents. ### AI Skills The review checks whether the AI skills described in your instructions match the skills configured for the AI Agent. Issues may be detected when: * Your instructions reference a skill that isn't enabled. * An enabled skill referenced by your instructions has no skill instructions. * Your instructions reference a skill that isn't available. * An AI skill uses an invalid destination, such as an **Assign to agent or team** skill with no destination or an **Add comment** skill that mentions a Team or AI Agent instead of a User. * Your instructions contradict each other about when or how a skill should be used. Learn more about configuring and using [**AI Agent skills**](https://respond.io/help/ai-agent-actions/using-ai-agent-actions). The existing skills guide already explains skill behavior such as skills running before replies and the need to use exact Workspace item names. ### Unsupported Instructions The review can detect instructions that ask the AI Agent to perform unsupported tasks. For example: * Reading a Contact’s existing Tags. * Reading internal Comments. * Finding information in a Knowledge Source based on its document title instead of its content. * Sending unsupported attachment types such as videos, voice notes or stickers. > For more information about what AI Agents can and can’t access, see [AI Agents: Known Limitations and Workarounds.](https://respond.io/help/ai-agents/ai-agents-known-limitations-and-workarounds) ### Follow-up Instructions and Limits The review checks whether your instructions stay within supported AI Agent limits. Issues may be detected for: * More than **5 follow-up steps**. * A follow-up scheduled more than **24 hours** after the previous message. * Branching or multiple parallel follow-up sequences. * Instructions that ask the AI Agent to refer to more than the **last 20 messages** in a conversation. ### Instruction Clarity and Consistency The review also checks whether your instructions provide a clear and consistent flow for the AI Agent to follow. It may identify: * Conflicting instructions for the same situation. * A missing or unclear goal. * No clear exit condition. * Instructions that lack enough structure for the intended flow. > For guidance on structuring your instructions, see [How to Write Effective AI Agent Prompts.](https://respond.io/help/ai-agents/how-to-write-effective-ai-agent-prompts) ## Review and Fix Issues When issues are detected, select **Review** to see them in more detail. Issues are grouped according to where they appear, such as your main **Instructions** or an individual Action. For issues with a suggested fix: 1. Select the issues you want to fix. 2. Review the suggested changes. 3. Select **Apply fixes**. 4. Check the proposed changes before confirming them. Your instructions aren’t changed until you confirm the fixes. After fixes are applied, the instructions are reviewed again for remaining issues. ### Ignore an Issue Select **Ignore** if you don’t want to address an issue during the current review. Ignoring an issue: * Removes it from the current list of open issues. * Doesn’t change your AI Agent’s instructions. * Doesn’t mark the issue as permanently resolved. Ignored issues are cleared when you run a new review, so an issue may appear again if it is still detected. ## FAQ & Troubleshooting ### Does Review change my AI Agent instructions automatically? No. Review identifies issues and may suggest fixes, but your instructions aren’t changed until you review and confirm the proposed changes. ### Does Review test how my AI Agent responds to Contacts? No. Review checks your AI Agent’s instructions and configuration. It doesn’t test live conversations or actual runtime behavior. ### Does Review check my Knowledge Source content? No. Review doesn't read the content of your Knowledge Sources. It checks the AI Agent's instructions, AI skill instructions and relevant Workspace configuration instead. ### Does Review check whether a Workflow is published? No. Review can check whether a referenced Workflow exists, but it doesn’t check whether that Workflow is published. Share this article [![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions) ## Related articles đŸ‘©â€đŸ’» * [AI Agent: Advanced SettingsLearn how to configure advanced settings for your AI Agent, such as wait time, so it waits for a Contact to finish messaging before replying. ](/help/ai-agents/ai-agent-advanced-settings) * [AI Agents: Known Limitations and WorkaroundsLearn about platform-level limitations of AI Agents in respond.io, including visibility constraints, message history limits, unsupported capabilities, and recommended workarounds. ](/help/ai-agents/ai-agents-known-limitations-and-workarounds) * [Getting Started with AI AgentsLearn how to set up an AI Agent with templates to get started fast. ](/help/ai-agents/getting-started-with-ai-agents) * [How to Test AI AgentsLearn how to safely test your AI Agent before publishing by simulating conversations and previewing AI skills without affecting real customers. ](/help/ai-agents/how-to-test-ai-agents) * [How to Write Effective AI Agent PromptsLearn how to write effective AI Agent prompts with best practices, tips, and practical examples. ](/help/ai-agents/how-to-write-effective-ai-agent-prompts) Can't find what you're looking for? 🔎 [Contact Support](/contact-us) 2026-10-16T08:04:12.086Z help ```json {"@context":"https://schema.org","@graph":[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Learn how to review your AI Agent instructions, identify configuration issues, and apply suggested fixes before publishing.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/2Y6LIr15mC1nj8MgftMVT5/6ffeea71593277f0fc29dafd1c1de9b9/Serene_Avatar.svg","name":"Shing-Yi Tan","url":"https://respond.io/author"},"dateCreated":"2026-09-01T00:00:00.000Z","dateModified":"2026-10-02T03:24:15.299Z","datePublished":"2026-09-01T00:00:00.000Z","headline":"How to Review AI Agent Instructions","mainEntityOfPage":"https://respond.io/help/ai-agents","publisher":{"@id":"https://respond.io/#organization"},"url":"https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions"},{"@context":"https://schema.org","@id":"https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Help","item":"https://respond.io/help"},{"@type":"ListItem","position":2,"name":"Product","item":"https://respond.io/help/product"},{"@type":"ListItem","position":3,"name":"AI Agents","item":"https://respond.io/help/ai-agents"},{"@type":"ListItem","position":4,"name":"How to Review AI Agent Instructions","item":"https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions"}]},{"@type":"Organization","@id":"https://respond.io/#organization","name":"Respond.io","alternateName":"respond.io","url":"https://respond.io/","image":["https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"],"logo":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4045649d540241d398c39ab07b2b62bb","description":"Respond.io is an AI-powered customer conversation platform that helps businesses manage conversations, automate workflows and scale sales, marketing and support operations. Trusted by 10,000+ B2C brands, it unifies WhatsApp, TikTok, Instagram and Facebook in a single AI-powered team inbox for chats, calls and campaigns.","email":"success@respond.io","telephone":"+6011-54211197","foundingDate":"2017-02-17","address":{"@type":"PostalAddress","streetAddress":"Level 41, Permata Sapura Tower, Jalan Pinang","addressLocality":"Kuala Lumpur","addressRegion":"Federal Territory of Kuala Lumpur","postalCode":"50088","addressCountry":"MY"},"areaServed":"Worldwide","contactPoint":{"@type":"ContactPoint","contactType":"Customer Service","url":"https://respond.io/contact"},"sameAs":["https://respond.io/","https://www.facebook.com/getrespondio/","https://www.linkedin.com/company/respondio/","https://play.google.com/store/apps/details?id=com.respond.inbox.io","https://www.youtube.com/@respondio","https://twitter.com/respond_io","https://apps.apple.com/my/app/respond-io-inbox/id1667772955","https://www.g2.com/products/respond-io/reviews","https://www.producthunt.com/products/respond-io","https://zapier.com/apps/respondio/integrations","https://www.capterra.com/p/179311/Rocketbots/","https://www.crunchbase.com/organization/respondio","https://builtin.com/company/respondio","https://respond-io.en.softonic.com/web-apps","https://my.jobstreet.com/companies/respondio-168558101085004","https://brandfetch.com/respond.io","https://webcatalog.io/en/apps/respond-io"],"knowsAbout":["WhatsApp API","WhatsApp Business API","WhatsApp CRM","WhatsApp automation","omnichannel communication platform","WhatsApp Business Multiple Users","WhatsApp BSP","WhatsApp Business Solution Provider","WhatsApp automation tool","WhatsApp team inbox","WhatsApp AI agent","WhatsApp Business AI chatbot","WhatsApp marketing software","conversational sales platform","WhatsApp appointment booking"]},{"@type":"WebPage","@id":"https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions#webpage","url":"https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions","name":"How to Review AI Agent Instructions","description":"Learn how to review your AI Agent instructions, identify configuration issues, and apply suggested fixes before publishing.","isPartOf":{"@id":"https://respond.io/#website"},"primaryImageOfPage":{"@type":"ImageObject","url":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"},"breadcrumb":{"@id":"https://respond.io/help/ai-agents/how-to-review-ai-agent-instructions#breadcrumb"}},{"@type":"WebSite","@id":"https://respond.io/#website","name":"Respond.io","url":"https://respond.io/","potentialAction":{"@type":"SearchAction","query-input":"required name=search_term_string","target":"https://respond.io/search?query={search_term_string}"},"publisher":{"@id":"https://respond.io/#organization"}}]} ```