> For the complete documentation index, see [llms.txt](https://enflexit.gitbook.io/agent-workbench/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enflexit.gitbook.io/agent-workbench/development/basic-steps/starting-awb-from-eclipse.md).

# Starting AWB from Eclipse

Setup a Debug or Run Configuration to start Agent.Workbench from Eclipse

### Create a Configuration and select the plug-ins

As a next step we are going to configure the Run configuration. Click the arrow next to the debug icon and click *Debug Configurations...* .

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-831f0c57804a214a1e8a59d2db8edb58a0edfc9d%2Fdebugconfig.jpg?alt=media\&token=4cdd81be-3179-4826-a2ab-cb05ead37038)

In the explorer on the left, right-click *Eclipse Application* and choose *New Configuration*.

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-c71f74e3c72352d5b2c95c50479cade3a4d9e086%2Fnewlaunchconfig2.jpg?alt=media\&token=b98c30e6-e43c-49e7-a43c-573bbab2196b)

Name the configuration (e.g "Agent.Workbench.local"). In the Main tab, check if *Run a product* equals *org.agentgui.core.product* and make sure the option *Clear:* is unselected.

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-ff8642ee43eaefb879d8f3b238c17362228c52d5%2Fnewlaunchconfigmain.jpg?alt=media)

Then open the *Plug-ins tab* (1). Make sure you select *Launch with: plug-ins selected below only* (2).

![2](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-df97344e30da46c1a1e21a886af4316937563d23%2Fnewlaunchconfig3.jpg?alt=media)

To create our own custom configuration, we need to deselect all selected plug-ins with the *Deselect All* button (3). To avoid any problems, it is important to execute the following steps in the exact order. To avoid any problems, execute the following steps in the exact order.

First we must select the following plug-ins:

* org.eclipse.core.runtime (Start Level 1, Auto-Start: true)
* org.apache.felix.scr (Start Level: 2, Auto-Start: true)
* org.eclipse.equinox.event (Start Level: 2, Auto-Start: true)
* org.agentgui.core

Then click *Add Required Plug-ins* (4) and *Validate Plug-ins* (5). A window should show up, saying that no problems were detected.

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-233b5eb31a484dfd8def6e85c09a3d71fdc3f63b%2Fconfignoproblems.jpg?alt=media)

As a last step, head to the Configuration tab and make sure the checkbox *Clear the configuration area before launching* is unselected as well.

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-f2d62338c8905a34a5007a9c0cfa8fa116d05f1d%2Fconfigtabdebugconfiguration.jpg?alt=media)

Now you can launch Agent.Workbench with the launch configuration from the IDE.

### Adding own plug-ins to the run configuration

In case you already developed own components that you want to launch with Agent.Workbench, adding them to your run configuration is simple. The process is demonstrated by adding a plug-in called *de.agent.test*.

Open your run configuration and go to the *Plug-ins* tab (1), as shown in the tutorial above. Your own components should appear under *Workspace*. Just select them and apply your changes, or start Agent.Workbench in debug-mode. Your own components are now accessible within the application.

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-70521c6b170a4088cd9c7a76511b1f51d1f4a2a2%2Faddplugintotunconfig.jpg?alt=media)

### Problems after validating plug-ins

In some cases after validating the plug-ins, a dialogue shows up saying that problems were detected.

![](https://874617837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL95HBh1KIqu90YyWBK%2Fuploads%2Fgit-blob-2ed9b3e031e17da940d240368e8b95950575c427%2Fxmlgraphicsproblem.jpg?alt=media\&token=80403fef-8bd8-444d-8a25-d9bb1da88bfe)

To solve this problem, we need to add the required bundle:

* org.apache.commons.logging

After you selected the plug-in, click *Add Required Plug-ins* (4), then *Validate Plug-ins* (5). No more problems should be detected.