{"section":"tutorials","requestedLocale":"en","requestedSlug":"assigning-and-testing-agents-in-agent-builder","locale":"en","slug":"assigning-and-testing-agents-in-agent-builder","path":"docs/en/tutorials/vtex-cx-platform/agent-builder/assigning-and-testing-agents-in-agent-builder.md","branch":"main","content":"The **My agents** section allows you to assign agents to the team and test their operation. Some official agents require credentials to operate on the platform. For more information, go to [Official agents from VTEX CX Platform and their credentials](https://help.vtex.com/docs/tutorials/official-agents-from-vtex-cx-platform).\n\n> ℹ️ To create custom agents, use the VTEX CX Platform (Weni) CLI. Learn more in [Using the VTEX CX Platform (Weni) CLI](https://developers.vtex.com/docs/guides/using-the-weni-by-vtex-cli).\n\nThis article is divided into the following sections:\n\n- [Assigning an agent to the team](#assigning-an-agent-to-the-team)\n- [Removing an agent](#removing-an-agent)\n- [Testing an agent](#testing-an-agent)\n\n## Assigning an agent to the team\n\nTo assign a new agent to your store, follow these steps:\n\n1. Access your organization in the [VTEX CX Platform dashboard](https://dash.weni.ai/orgs).\n2. In the side menu, click the **My agents** icon.\n3. Click <i class=\"fas fa-plus\"></i>`Assign new agents`.\n4. On the **Assign new agents** page, select one of the available options:\n- **Official agents:** Agents provided by VTEX or by external integrations already added to the platform.\n- **Custom agents:** Agents created for your operation.\n\n> ℹ️ You can also find agents using the search field or filtering by category type.\n\n5. After choosing an agent, click `View details`.\n6. In the agent modal, review the information about available MCPs and the conversation example.\n7. Click `Start setup`.\n8. In **Assign \\{Agent name\\}**, in the **System selection** section, select one of the available options and click `Next`.\n9. In **MCP selection**, select one of the available options to define the agent's behavior.\n10. In **Configure \\{System name\\} MCP**, if available, enter or select the agent's parameters. Some agents don't have configurable parameters.\n11. In **Review the setup and enter credentials**, review the information, complete the required fields, and click `Finish`.\n\nAfter completing these steps, the agent will be displayed in the **Assigned agents** section of the **My agents** page.\n\n## Removing an agent\n\nTo remove an agent from your store, follow these steps:\n\n1. Access your organization in the [VTEX CX Platform dashboard](https://dash.weni.ai/orgs).\n2. In the side menu, click the **My agents** icon.\n3. In the **Assigned agents** section, click the desired agent.\n4. Click `View options`.\n5. Click `Remove agent`.\n\n> ℹ️ If you want to use this agent again, assign it again as described in [Assigning an agent to the team](#assigning-an-agent-to-the-team).\n\n## Testing an agent\n\nTo test the operation of an assigned agent, click `Test your agents` in the lower-right corner of the screen.\n\nIn the **Test your agents** section, you can:\n\n- In the **Manager version** field, select the model that will act as the orchestrator agent during the conversation.\n- Start a conversation using the dialog box.\n- Send an audio message by clicking the microphone icon or the <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> button and then `Audio`.\n- Send files by clicking the <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> Send file button.\n- In the **Visual flow** tab, view a diagram showing which agents are called to produce the response displayed in the dialog box.\n- In the **Logs** tab, check the detailed record of events processed by the AI model during the conversation. This information helps you understand conversation processing, identify potential issues, and improve agent performance.\n\nTo search for specific events, click `Filter logs` and search by keywords or the following categories:\n\n| Category | Step description |\n| --- | :--- |\n| Applying security rules | Security check of content, including protection of sensitive data, blocking of prohibited content, and enforcement of usage policies. |\n| Assigning task to the agent | Defines the specialized agent or internal resource that will handle a step in the conversation. |\n| Knowledge | Queries the knowledge base, such as documentation, Help Center articles, or internal content, to search for official information before responding. |\n| Forwarding to the manager | Returns control to the manager to define the next step of the conversation. |\n| Forwarding to human support | Forwards the conversation to human support due to a technical limitation, exception, or business rule. |\n| Sending to manager | Sends the result of a tool, agent, or flow step to the manager for processing. |\n| Sending final reply | Sends the response to the user after internal orchestration is completed. |\n| Tool | Uses an external resource or specific module, such as order inquiry, image analysis, audio transcription, or search in another system. |\n| Thinking | Step in which the model internally processes the request, plans the response, and decides whether to call tools, query knowledge, or forward the conversation to another flow. |\n\n> ℹ️ To remove the conversation history with the orchestrator agent, click the <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> menu next to Test your agents and then `Clear conversations`."}