# Beam Academy

## Docs

- [Core Concepts](https://docs.beam.ai/01-getting-started/core-concepts/core-concepts.md): Understand the current Beam workspace, agents, Flows, tools, variables, memory, and task surfaces.
- [Quick start: create your first agent](https://docs.beam.ai/01-getting-started/quickstart/quickstart.md): Create an agent from a template, review its Flow and integrations, test it, and publish when it is ready.
- [Agent Templates](https://docs.beam.ai/01-getting-started/template-gallery/template-gallery.md): Browse, filter, and create agents from the templates available in your Beam workspace.
- [Welcome to Beam](https://docs.beam.ai/01-getting-started/welcome/welcome.md): Start in your Beam workspace, ask Beam AI for help, and navigate to the surfaces used to build and run agents.
- [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 an integration for an internal or proprietary platform from the workspace Integrations page
- [Loop Nodes](https://docs.beam.ai/02-building-agents/advanced-patterns/loop-node/loop-node.md): Iterate over an array or run a fixed number of passes inside a flow to process multi-item payloads sequentially
- [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): Run a Flow draft, publish it, review its version history, and find the current API reference.
- [Integrations](https://docs.beam.ai/02-building-agents/agent-configuration/integrations/integrations.md): Browse workspace integrations, add a connection, and use an integration when configuring an agent Flow.
- [Structured Outputs](https://docs.beam.ai/02-building-agents/agent-configuration/structured-outputs/structured-outputs.md): Configure named outputs for an AI step and link them to later Flow steps.
- [Variable Fill](https://docs.beam.ai/02-building-agents/agent-configuration/variables-state/variables-state.md): Configure how each tool input receives a value while an agent flow runs.
- [Creating Agents](https://docs.beam.ai/02-building-agents/agent-fundamentals/creating-agents/creating-agents.md): Start an agent from a workspace template or the New agent entry point, then configure its Flow and connections.
- [Creating Flows](https://docs.beam.ai/02-building-agents/agent-fundamentals/flow-configuration/flow-configuration.md): Build and review an agent Flow from its canvas and node sidebar, then test it before publishing.
- [Selecting Tools](https://docs.beam.ai/02-building-agents/agent-fundamentals/tools-integrations/tools-integrations.md): Choose AI, Integration, Controls, or Utilities steps for an agent Flow.
- [Debug Tools](https://docs.beam.ai/03-running-operations/debugging-testing/debug-tools/debug-tools.md): Inspect agent task execution and configure a Flow node with sample input before testing its output
- [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 Mode](https://docs.beam.ai/03-running-operations/debugging-testing/test-datasets/test-datasets.md): Run an agent Flow with data from past tasks in a safe environment before you publish.
- [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): Review an agent's task list, filter task records, and open individual tasks for execution details.
- [Triggers](https://docs.beam.ai/03-running-operations/task-management/triggers-webhooks/triggers-webhooks.md): Configure the Trigger node that starts an agent Flow, then test it before publishing.
- [Evaluation Framework](https://docs.beam.ai/04-observability-analytics/evaluation-framework/evaluation-framework.md): Validate agent accuracy with evaluation criteria, Auto-run retries, and Analytics monitoring.
- [Monitoring](https://docs.beam.ai/04-observability-analytics/monitoring/monitoring.md): Configure task-status notifications for an agent by choosing a schedule, channel, task statuses, and whether to include test tasks.
- [Optimize Outputs](https://docs.beam.ai/04-observability-analytics/optimize-outputs/optimize-outputs.md): Use Pro Learning tools to test, tune, and optimize an agent's tool outputs
- [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
- [Workspace Skills](https://docs.beam.ai/05-resources/workspace-skills/workspace-skills.md): Browse, search, and start creating reusable capabilities from the workspace Skills module.
- [Workspace Views](https://docs.beam.ai/05-resources/workspace-views/workspace-views.md): Create and search workspace views for an agent's node input and output data tables.
- [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)