Skip to main content

​
Introduction

This procedure explains how to deploy and operate the Faulty Printed Circuit Board Detection Agent on a node running EVE-OS (Edge Virtualization Engine). The agent processes real-time vision data locally to identify defects on printed circuit boards (PCBs) during manufacturing or quality control, ensuring privacy and low latency without requiring a constant connection to Edge Infrastructure Services. You can control the industrial hardware and alert logic through the agent’s chat interface.

​
Prerequisites

  • You have a role that can submit deployment requests: Organization Admin, MLOps Admin, or MLOps Engineer in your organization, or the Super Admin system role. See Organizations, Users, and Roles.
  • A ZEDEDA Edge Kubernetes Service cluster is imported and running. For setup instructions, see the ZEDEDA Edge Kubernetes Service quick start.
  • The target node is a Jetson AGX Thor device or Developer Kit (recommended for default deployment).
  • The target node has one NVIDIA GPU available to the agent, at least 16 GB of memory (up to 32 GB used), and storage for about 80 GB of persistent volumes (model cache, application data, and shared model storage).
  • Physical hardware is available: a conveyor belt and camera connected to the node, positioned to capture PCBs as they move through the inspection zone.
  • If running a gated model, you have a HuggingFace access token. Enter it as the Hugging Face token value in the deployment wizard’s configuration values.

​
Deploy the Faulty PCB Detection Agent

  1. In the sidebar, select Marketplace > AI Apps.
  2. Locate the Faulty Printed Circuit Board Detection Agent in the gallery. Use the search field if needed.
  3. Select the agent card to open the agent detail page.
  4. Select the Deploy icon.
  5. Follow the deployment wizard to select the target ZEDEDA Edge Kubernetes Service cluster and complete the deployment configuration.
Deploying creates a deployment request with status Pending. Organization Admin or MLOps Admin in that organization must approve it; users cannot approve their own requests. See Approve and Validate Models. After the request is approved and deployment completes, the agent starts on the node and its chat interface becomes available. On first start, the agent downloads its model from Hugging Face, which requires internet access and can take 10 minutes or more.

​
Configure Alert Recipients

Before running the agent, add the operator email addresses that should receive defect alert notifications.
  1. Open the agent’s web interface by navigating to the Agent Chat URL for your node, http://<node-IP>:30080.
  2. In the Agent Chat, select Users in the navigation sidebar.
  3. Select Add User and enter the operator’s email address.
  4. Select Send to save the recipient.
Repeat for each operator who should receive defect alerts.

​
Run the Faulty PCB Detection Agent

  1. In the Agent Chat, select Live Preview in the navigation bar.
  2. Select Start Monitoring to activate the continuous monitoring loop.
  3. Place a printed circuit board on the conveyor belt.
  4. Wait for the board to stop under the camera so the agent can capture a detailed frame.
  5. Review the agent output in the chat. Select Logs to view the full detection log entries.
  6. Identify whether the board has defects, for example, a missing solder bridge or power connector.
  7. If a defect is detected, approve the alert workflow prompt to send an email notification to the configured operators.

​
Verify the Configuration

  • Verify that the web dashboard displays the detected items and correctly updates the historical trend data.
  • Check the operator email inbox to confirm that the defect alert was delivered successfully.

​
In This Section