beam-connect

Manages Beam AI workspace agents, tasks, and analytics through a unified routing interface.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill beam-connect-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beam-connect
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/beam/beam-connect
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill beam-connect-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Beam AI agents requires juggling multiple API operations—listing agents, creating tasks, monitoring analytics, and debugging failures—without a single entry point. This Skill consolidates all Beam AI workspace operations into one interface with automatic configuration validation and smart routing. ## Core Features & Use Cases - Configuration Pre-Flight Checks: Validates API keys and workspace IDs before any operation, prompting for credentials when missing. - Agent & Task Management: Lists workspace agents, creates tasks, retries failures, approves human-in-the-loop steps, and rates outputs. - Analytics & Optimization: Retrieves agent performance metrics, tests graph nodes, and runs tool optimization workflows. - Use Case: Ask to "list my beam agents" to see all workspace agents, then say "create task for Customer Support: process the latest ticket" to execute a task and optionally monitor its progress. ## Quick Start Ask the AI to list your Beam agents or create a task for a specific agent, and it will validate your configuration first before executing the operation.

Frequently Asked Questions about beam-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list agents in my Beam AI workspace?

Say "list agents" or "show beam agents" and the skill runs the list_agents.py script after validating your configuration. Results show each agent's name, ID, type, and creation date, and are cached so you can reference agents by name later.

How do I create and monitor a Beam AI agent task?

Provide an agent ID and task query, and the skill calls create_task.py to queue the task. You can then monitor progress with get_task_updates.py, retry failures, approve human-in-the-loop steps, or rate the output.

What credentials does Beam AI integration require?

You need a Beam API key and workspace ID, both available from Settings in the Beam AI app. The skill's pre-flight check detects missing credentials and prompts you to save them to a .env file before proceeding.

Why does my Beam AI request return a 401 or 403 error?

A 401 error means your token expired and you need to re-authenticate with a fresh API key. A 403 error indicates insufficient workspace permissions, so verify your account has access to the target workspace.

Can I test and update individual agent graph nodes?

Yes, the skill supports testing a specific graph node with custom input via test_graph_node.py and updating node objectives via update_graph_node.py. You need the agent ID, node ID, and graph ID to run these operations.