Skip to main content

Part 3: Allowing the Agent to Take Action

Finally, you will utilize an existing API to send out the Invoice Reconciliation report to stakeholders. You will also give the agent the ability to call the ERP and update the relevant Invoice with a status based on the result of the reconciliation process.

Create a new Mail Tool

  1. In Agent Garden, click the Tools icon in the left-hand navigation bar. Click Create New Tool.
  2. Select API from the Agent Designer modal and click Add Tool.
    • Tool Name: [builderInitials] Send Mail
    • Description: Send Matching Report via Email
    • Under Input Parameters, click + Add Input Parameter.
      • Name: AGENTREPORT
      • Description: Send Agent Report via Email
      • Type: Select String from the dropdown.
      • Click Add Input Parameter.
    • Click Save & Continue.

Tool Configuration

  1. Choose Add Manually under Configuration:
    1. Base URL: https://c04-usa-east.integrate.boomi.com

    2. Method: POST

    3. Endpoint Path: /ws/rest/tools/sendEmail

    4. Basic Authentication:

      • Username: boomi_joel_davenport-XBUHTV.MOKSAY
      • Password: 7880eeac-4e46-4a03-b7a3-fd421fd5e20b
    5. Request Type: JSON

    6. Request Body:

      • Replace yourEmailAddress with your email.
      {
      "message": " {{AGENTREPORT}}",
      "to": "yourEmailAddress",
      "subject": "Invoice Matching Report"
      }
    7. On the Review screen, verify the tool's configuration and click Deploy Tool.

    8. Confirm by clicking Deploy in the pop-up.

Create an API Tool to Update the ERP

Update Tool Signature

  1. Tool Name: [builderInitials] Update Invoice
  2. Description: Updates an invoice in the ERP
  3. Input Parameters:
    • Parameter 1:
      • Name: Invoice Number
      • Description: Invoice Number to Update
      • Type: Select String from the dropdown.
    • Parameter 2:
      • Name: Status
      • Description: Invoice Status. Must be one of the following: APPROVED, REJECTED, AWAITING REVIEW
      • Type: Select String from the dropdown.

Tool Configuration

  1. Choose Add Manually under Configuration:
    1. Base URL: https://c04-usa-east.integrate.boomi.com

    2. Method: POST

    3. Endpoint Path: /ws/rest/tools/invoice

    4. Basic Authentication:

      • Username: boomi_joel_davenport-XBUHTV.MOKSAY
      • Password: 7880eeac-4e46-4a03-b7a3-fd421fd5e20b
    5. Request Type: JSON

    6. Request Body:

      {
      "invoice_doc": " {{Invoice Number}}",
      "status": "{{Status}}"
      }

      Update Invoice Tool

    7. On the Review screen, verify the tool's configuration and click Deploy Tool.

    8. Confirm by clicking Deploy in the pop-up.

Attach these tools to the Agent

  1. Navigate back to the Agents screen.
  2. Click on the agent's name ([builderInitials] Invoice Reconciliation Agent) → EditDisable to enter the configuration screen.
  3. On the Tasks tab, find the Generate Matching Report task.
  4. Click the Manage Tools button for this task.
  5. Click + Add New Tool.
  6. Search for and check the boxes for the following tools:
    • [builderInitials] Update Invoice
    • [builderInitials] Send Mail
  7. Click Add Tool, and then Save.

Final Deployment

  1. Click Save & Continue until you reach the Review screen.
  2. Click Deploy Agent and confirm the deployment.

Add the Agent to Favorites

  1. Navigate to the Agent List by clicking the Agent button in the left menu bar.

  2. Find your Agent in the list. Use the search bar if necessary.

  3. Under the Actions heading, click the vertical ellipsis and select Add to Favorites.

    Favorite

Test the Agent

  1. From the main "Agents" list, click the Chat icon in the left-hand navigation bar.

    Chat Navigation

  2. In the top left, click the dropdown next to Boomi GPT, and select your Invoice Reconciliation Agent from the Favorites list.

    Select Agent

  3. Ask lab lead for an Invoice ID to check, and prompt the agent to Evaluate {Invoice ID}

Congratulations!

You've successfully built an Invoice Reconciliation Agent that automates three-way matching across Purchase Orders, Goods Received Notes, and Invoices. Your agent can now validate documents, identify discrepancies, update ERP systems, and notify stakeholders—transforming a manual, error-prone process into an intelligent automation!