{"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](#assign-an-agent-to-the-team)\n- [Remove an agent](#remove-an-agent)\n- [Test an agent](#test-an-agent)\n\n## Assign 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 from VTEX or from external integrations previously registered on 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, fill in or select the agent's parameters. Some agents don't have configurable parameters.\n11. In **Review the setup and enter credentials**, review the information, fill in 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## Remove 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 [Assign an agent to the team](#assign-an-agent-to-the-team).\n\n## Test 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- Select, in the **Manager version** field, the model that will act as 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 files by clicking the `Enviar arquivo`.\n- In the **Visual flow** tab, view in diagram format which agents are being 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 | Definition of the specialized agent or internal resource that will be responsible for a step of the conversation. |\n| Knowledge | Query to the knowledge base, such as documentation, Help Center articles, or internal content, to search for official information before the response. |\n| Forwarding the manager | Return of control to the manager to define the next step of the conversation. |\n| Forwarding to human support | Forwarding of the conversation to human service due to a technical limitation, exception, or business rule. |\n| Sending to manager | Sending of the result of a tool, agent, or flow step to the Manager for processing. |\n| Sending final reply | Sending of the response to the user after internal orchestration is completed. |\n| Tool | Use of 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`."}