# Beam Academy

## Docs

- [Core Concepts](https://docs.beam.ai/01-getting-started/core-concepts/core-concepts.md): Understand the fundamental building blocks of the Beam platform
- [Quick-start: Setup Your First Agent](https://docs.beam.ai/01-getting-started/quickstart/quickstart.md): Deploy your first AI agent in minutes using pre-configured templates with integrated components
- [Template Gallery](https://docs.beam.ai/01-getting-started/template-gallery/template-gallery.md): Pre-built AI agent templates designed to automate business processes across various industries and departments
- [Welcome to Beam](https://docs.beam.ai/01-getting-started/welcome/welcome.md): Build production-ready AI agents that automate complex workflows with autonomous decision-making
- [Workspace Setup](https://docs.beam.ai/01-getting-started/workspace-setup/workspace-setup.md): Create or join a workspace to start collaborating with your team on AI agent automation
- [Custom Integrations](https://docs.beam.ai/02-building-agents/advanced-patterns/custom-integrations/custom-integrations.md): Build custom API connections for proprietary systems and services not available in the integration catalog
- [Multi-Agent Collaboration](https://docs.beam.ai/02-building-agents/advanced-patterns/multi-agent-collaboration/multi-agent-collaboration.md): Enable agents to call other agents for complex workflow orchestration and specialized task delegation
- [Publishing & Deployment](https://docs.beam.ai/02-building-agents/advanced-patterns/publishing-deployment/publishing-deployment.md): Deploy agents to production and integrate with external applications using the Beam API
- [Integration Connectors](https://docs.beam.ai/02-building-agents/agent-configuration/integrations/integrations.md): Connect agents to external services with pre-built integration connectors for CRM, communication, productivity, and automation
- [Structured Outputs](https://docs.beam.ai/02-building-agents/agent-configuration/structured-outputs/structured-outputs.md): Design predictable output schemas that transform AI responses into machine-readable data for reliable automation
- [Variable Fill](https://docs.beam.ai/02-building-agents/agent-configuration/variables-state/variables-state.md): Configure how data flows through your workflow with five fill methods: AI Fill, Static, User Fill, Linked, and From Memory
- [Creating Agents](https://docs.beam.ai/02-building-agents/agent-fundamentals/creating-agents/creating-agents.md): Build AI agents in Beam using templates, chat-based generation, or custom configuration from scratch
- [Creating Flows](https://docs.beam.ai/02-building-agents/agent-fundamentals/flow-configuration/flow-configuration.md): Design structured execution paths for AI agents with visual workflow builder, nodes, branches, and conditional logic
- [Selecting Tools](https://docs.beam.ai/02-building-agents/agent-fundamentals/tools-integrations/tools-integrations.md): Choose and configure the right tool for each workflow node: Custom GPT tools, integration connectors, or custom integrations
- [Debug Tools](https://docs.beam.ai/03-running-operations/debugging-testing/debug-tools/debug-tools.md): Diagnose and resolve agent execution errors using built-in debugging tools, error handling configurations, and test environments
- [Rerunning Tasks](https://docs.beam.ai/03-running-operations/debugging-testing/rerunning-tasks/rerunning-tasks.md): Re-execute tasks for debugging, testing workflow changes, backtesting prompt improvements, and validating agent performance
- [Test Datasets](https://docs.beam.ai/03-running-operations/debugging-testing/test-datasets/test-datasets.md): Validate agent performance at scale by consolidating test inputs, defining expected outputs, and batch-testing workflows
- [Automation Modes](https://docs.beam.ai/03-running-operations/task-management/automation-modes/automation-modes.md): Configure human-in-the-loop workflows with consent approvals, input requests, and failure handling for controlled agent autonomy
- [Task Executions](https://docs.beam.ai/03-running-operations/task-management/task-executions/task-executions.md): Monitor agent task executions, analyze workflow steps, track performance metrics, and debug agent behavior in real-time
- [Triggers & Webhooks](https://docs.beam.ai/03-running-operations/task-management/triggers-webhooks/triggers-webhooks.md): Configure how agents start execution through integration events, schedules, webhooks, and manual triggers
- [Evaluation Framework](https://docs.beam.ai/04-observability-analytics/evaluation-framework/evaluation-framework.md): Validate agent accuracy at scale with automated evaluation criteria that measure output quality, trigger self-healing retries, and track performance over time
- [Optimize Outputs](https://docs.beam.ai/04-observability-analytics/optimize-outputs/optimize-outputs.md): AI-powered prompt optimization that learns from failures and automatically rewrites prompts to improve accuracy from 5% to 100% without code
- [Overview Analytics](https://docs.beam.ai/04-observability-analytics/overview-analytics/overview-analytics.md): Monitor agent performance, task completion rates, evaluation scores, and user feedback through the centralized Analytics dashboard
- [Changelog](https://docs.beam.ai/05-resources/changelog/changelog.md): Stay up-to-date with the latest Beam AI platform features, improvements, and releases
- [Azure SSO Setup](https://docs.beam.ai/05-resources/team-management-sso/team-management-sso.md): Configure Azure Single Sign-On integration with Beam AI platform for enterprise authentication
- [Delete Context File](https://docs.beam.ai/08-reference/api/agent-context-files/delete-context-file.md): Delete a context file for an agent by file key.
- [Download Context File](https://docs.beam.ai/08-reference/api/agent-context-files/download-context-file.md): Generate a download link for an agent context file.
- [Upload Context File](https://docs.beam.ai/08-reference/api/agent-context-files/upload-context-file.md): Upload context files for an agent.
- [Add Edge to Graph](https://docs.beam.ai/08-reference/api/agent-graph/add-edge-to-graph.md): Add a new edge (connection) between two nodes in the agent workflow graph. Edges define the flow of execution between nodes.
- [Add Node to Graph](https://docs.beam.ai/08-reference/api/agent-graph/add-node-to-graph.md): Add a new node to an agent workflow graph. Nodes represent individual steps or actions in the agent execution flow.
- [Create a complete agent graph](https://docs.beam.ai/08-reference/api/agent-graph/create-complete-graph.md): Creates a new agent with its complete graph structure including nodes, edges, and tool configurations. Both an active/published graph and a draft graph are created.
- [Get Agent Graph](https://docs.beam.ai/08-reference/api/agent-graph/get-agent-graph.md): Retrieve the workflow graph configuration for a specific agent.
- [Get Agent Graph with nodes](https://docs.beam.ai/08-reference/api/agent-graph/get-agent-graph-with-nodes.md): Retrieve graphs and its nodes (without configuration)
- [Get detailed information for a specific node](https://docs.beam.ai/08-reference/api/agent-graph/get-detailed-information-for-a-specific-node.md): Retrieves comprehensive details of a specific node within an agent graph, including its tool configuration, input/output parameters, position coordinates, and execution settings. The node must belong to a graph associated with the specified agent in the current workspace.
- [Get Task Nodes by Tool](https://docs.beam.ai/08-reference/api/agent-graph/get-task-nodes-by-tool.md): Retrieve task nodes that use a specific tool function for analysis and optimization.
- [Publish agent graph](https://docs.beam.ai/08-reference/api/agent-graph/publish-agent-graph.md)
- [Test Graph Node](https://docs.beam.ai/08-reference/api/agent-graph/test-graph-node.md): Test a specific node in the agent graph to validate its configuration and behavior.
- [Update agent and its draft graph](https://docs.beam.ai/08-reference/api/agent-graph/update-agent-graph.md): Updates an existing agent (name, description, settings) and replaces all nodes and edges in its draft graph.
- [Update Edge in Graph](https://docs.beam.ai/08-reference/api/agent-graph/update-edge-in-graph.md): Update an existing edge properties such as condition in the agent workflow graph.
- [Update Graph Node](https://docs.beam.ai/08-reference/api/agent-graph/update-graph-node.md): Update Graph Node
- [Update input/output parameters for a node tool configuration](https://docs.beam.ai/08-reference/api/agent-graph/update-inputoutput-parameters-for-a-node-tool-configuration.md): Updates the input and/or output parameters of a tool configuration associated with a specific node in the agent graph. Input parameters define how data flows into the tool (e.g., AI-filled, user-provided, static values, or linked from other node outputs). Output parameters define the data structure…
- [Update prompt of the tool](https://docs.beam.ai/08-reference/api/agent-graph/update-prompt-of-the-tool.md): Update prompt of the tool used in the node
- [Add context files to an existing agent](https://docs.beam.ai/08-reference/api/agent-setup/add-context-files.md): Upload one or more context files (up to 10) to an existing agent. Supported file types include documents (txt, csv, pdf, xls, xlsx, docx, doc, ppt, pptx) and images (png, jpeg, jpg, tiff, heif, bmp).
- [Get agent setup session](https://docs.beam.ai/08-reference/api/agent-setup/get-agent-setup-session.md): Retrieves the current setup session state for a specific agent, including configuration and progress.
- [Process agent setup steps](https://docs.beam.ai/08-reference/api/agent-setup/process-agent-setup-steps.md): Multi-step agent configuration endpoint. Use this after agent creation (via /agent-context and /agent-creation).
- [Submit feedback on the provided context](https://docs.beam.ai/08-reference/api/agent-setup/submit-context-feedback.md)
- [Provide feedback for a specific setup step](https://docs.beam.ai/08-reference/api/agent-setup/submit-step-feedback.md)
- [Upload context files during agent setup](https://docs.beam.ai/08-reference/api/agent-setup/upload-context-files.md): Upload one or more files (up to 10) to provide context during agent setup. Supported file types include documents (txt, csv, pdf, xls, xlsx, docx, doc, ppt, pptx) and images (png, jpeg, jpg, tiff, heif, bmp).
- [Import a skill from a zip file](https://docs.beam.ai/08-reference/api/agent-skills/import-skill.md): Import a skill into an agent from a zip file. The zip file should contain the skill configuration and any associated assets. The skill will be added to the specified agent.
- [Approve Task Execution](https://docs.beam.ai/08-reference/api/agent-task/approve-task-execution.md): Provide user consent for a task to continue execution when approval is required.
- [Create Agent Task](https://docs.beam.ai/08-reference/api/agent-task/create-agent-task.md): Create a new task for an agent to execute. The task will be queued and processed according to the agent workflow.
- [Get Agent Analytics](https://docs.beam.ai/08-reference/api/agent-task/get-agent-analytics.md): Retrieve analytics data for agent task execution including success rates, performance metrics, and usage statistics.
- [Get Latest Task Executions](https://docs.beam.ai/08-reference/api/agent-task/get-latest-task-executions.md): Retrieve the most recent task executions for monitoring and debugging purposes.
- [Get Next Task](https://docs.beam.ai/08-reference/api/agent-task/get-next-task.md): Iterate through tasks based on filters. Useful for task queue processing and navigation.
- [Get Task Details](https://docs.beam.ai/08-reference/api/agent-task/get-task-details.md): Retrieve detailed information about a specific task including execution status and results.
- [Get Task Updates (SSE)](https://docs.beam.ai/08-reference/api/agent-task/get-task-updates-sse.md): Subscribe to real-time updates for a specific task using Server-Sent Events (SSE). Returns a stream of task execution status changes and results.
- [Get Tool Output Schema](https://docs.beam.ai/08-reference/api/agent-task/get-tool-output-schema.md): Retrieve the expected output schema for a specific tool in the agent graph.
- [List Agent Tasks](https://docs.beam.ai/08-reference/api/agent-task/list-agent-tasks.md): Retrieve a paginated list of agent tasks with filtering and grouping options.
- [Rate Task Output](https://docs.beam.ai/08-reference/api/agent-task/rate-task-output.md): Submit a rating for task execution output to improve agent performance.
- [Reject Task Execution](https://docs.beam.ai/08-reference/api/agent-task/reject-task-execution.md): Reject a task execution that requires user consent. The task will be marked as rejected and stop execution.
- [Retry Task Execution](https://docs.beam.ai/08-reference/api/agent-task/retry-task-execution.md): Retry a failed or incomplete task execution with optional modifications.
- [Submit User Input](https://docs.beam.ai/08-reference/api/agent-task/submit-user-input.md): Provide user input for a task that requires human interaction to continue execution.
- [Get a view by ID](https://docs.beam.ai/08-reference/api/agent-views/get-a-view-by-id.md)
- [List all views](https://docs.beam.ai/08-reference/api/agent-views/list-all-views.md)
- [List linked records for a link column](https://docs.beam.ai/08-reference/api/agent-views/list-linked-records-for-a-link-column.md)
- [List records from a view](https://docs.beam.ai/08-reference/api/agent-views/list-records-from-a-view.md)
- [List Agents](https://docs.beam.ai/08-reference/api/agents/list-agents.md): Retrieve a paginated list of agents available in your workspace. Filter by type, category, or search query.
- [Update Agent](https://docs.beam.ai/08-reference/api/agents/update-agent.md): Update an agent by id within the current workspace.
- [Authentication](https://docs.beam.ai/08-reference/api/authentication/authentication.md): Learn how to authenticate with the Beam AI public API using your API key
- [Get preferred models](https://docs.beam.ai/08-reference/api/custom-tool/get-preferred-models.md)
- [MCP Connection](https://docs.beam.ai/08-reference/api/mcp-connection/mcp-connection.md): Connect to Beam AI using the Model Context Protocol (MCP) for seamless AI assistant integration
- [API Overview](https://docs.beam.ai/08-reference/api/overview/overview.md): Complete API reference for Beam AI platform integration and automation
- [Get Active Tools](https://docs.beam.ai/08-reference/api/tool/get-active-tools.md): Retrieve all active tools for the current workspace.
- [Get Tool Optimization Status](https://docs.beam.ai/08-reference/api/tool/get-tool-optimization-status.md): Check the status of an ongoing tool optimization process.
- [Optimize Tool](https://docs.beam.ai/08-reference/api/tool/optimize-tool.md): Optimize a tool's performance and configuration based on usage patterns and feedback.
- [Get Current User](https://docs.beam.ai/08-reference/api/user/get-current-user.md): Retrieve the profile information of the currently authenticated user, including their workspaces and permissions.

## OpenAPI Specs

- [openapi-final](https://docs.beam.ai/openapi-final.json)
- [openapi](https://docs.beam.ai/api-reference/openapi.json)