Skip to content

Interact with Your Agents in the BeeAI Platform

In this lab, we'll run our TicketWorkflow that we created in Lab 2 in the BeeAI platform. The BeeAI platform creates a simple and elegant UI so that we can test, run, and share our agents easily.

Steps

1. Install BeeAI Platform

Install BeeAI platform using the installation instructions in the documentation. Be sure to complete all parts of installation and setup:

Insight

Be sure to install a version that was tested with the workshop with this syntax uv tool install beeai-cli==<version>.

  1. Install uv (part of pre-work section)

  2. Install BeeAI

    uv tool install beeai-cli==0.2.14

  3. Start the BeeAI platform

    beeai platform start

  4. Configure an LLM provider

    beeai env setup

  5. Check that everything works

    beeai run chat Hi!

Already installed BeeAI in the past? Be sure to update it to the latest version according to the instructions in the documentation.

2. Open the Project Directory

If you don't already have the intro_acp_beeai folder open in VS Code, navigate there. Your working directory should look something like this: ~/beeai-workshop/intro_acp_beeai.

3. Install Dependencies

If you already did this in Lab 1 or 2, you can skip this step. If not, open your terminal (either in VS Code or using your preferred terminal) and install the dependencies:

uv sync

4. Run the Ticket Workflow Agent

In your terminal, run the ticket workflow agent (defaults to run on port 8000):

uv run src/ticket_workflow_agent.py

Insight

If you take a look at the code you will notice that there are 3 ACP agents in this ticket_workflow_agent.py file. The main agent, named "TicketWorkflow", orchestrates the run of the ticket_triage_agent and ticket_response_agent sequentially. Pay special attention to the metadata in the @server.agent decorator. The UI type informs the platform how the end user should interact with the agent. If the agent doesn't have UI metadata defined, it will not be visible in the platform.

5. Launch the BeeAI UI

In your terminal, run:

beeai ui

You should see the UI launch in your browser.

Insight

If you navigate to the menu bar on the left hand side you will see a list of agents. All 3 agents that we are running on the active server appear because they each have UI metadata in their agent detail. If we killed the server, these agents would instantly disappear.

6. Run the TicketWorkflow in the BeeAI Platform

  1. Navigate to the menu bar on the left hand side and select the TicketWorkflow

  2. Enter in the sample text or have fun with coming up with your own ticket:

    Hi there, this is Jane Doe. Ever since yesterday your ProPlan won't let me export reports. This is blocking my quarter-end close—please fix ASAP or refund the month.AccountNumber: 872-55

  3. Press Run

Expected Results:

You should see both the triage output (structured data about the ticket) and the response output (a human-like customer service response) in the platform interface.

7. Clean Up

  1. Stop the ACP agent servers using Ctrl + C or exiting the terminal where it is running.

  2. Clean up the platform by running this command in your terminal:

    beeai platform delete

Congratulations! You've completed the Introduction to ACP + BeeAI Workshop.