# open-agents | Vercel Labs | Knowledge Base | Instagit

An open source template for building cloud agents.

GitHub Stars: 2.9k

Repository: https://github.com/vercel-labs/open-agents

---

## Articles

### [How Context Management and Cache Control Optimize Open Agents Calls](/vercel-labs/open-agents/how-does-context-management-and-cache-control-optimize-open-agents-calls)

Discover how Open Agents optimizes LLM calls with context management and cache control, reducing token costs and preventing overflow for efficient multi-turn workflows.

- Tags: performance
- Published: 2026-04-16

### [How to Debug Open Agents Execution and Tool Call Issues: A Complete Guide](/vercel-labs/open-agents/how-to-debug-open-agents-execution-and-tool-call-issues)

Debug Open Agents execution and tool call issues by inspecting sandbox initialization, validating working directory resolution, and tracing execution results. Your complete guide to troubleshooting.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Configure Redis or KV for Open Agents Skills Metadata Caching](/vercel-labs/open-agents/how-to-configure-redis-or-kv-for-open-agents-skills-metadata-caching)

Configure Redis or KV for Open Agents skills metadata caching using REDIS_URL or KV_URL environment variables. Enhance performance with a two-layer cache system.

- Tags: how-to-guide
- Published: 2026-04-16

### [How Tool Result Persistence Works Across Workflow Steps in Open Agents](/vercel-labs/open-agents/how-does-tool-result-persistence-across-workflow-steps-work-in-open-agents)

Discover how Open Agents ensures tool result persistence across workflow steps by upserting assistant messages to PostgreSQL, providing durability through VM restarts and device switches.

- Tags: internals
- Published: 2026-04-16

### [How Sandbox Port Exposure and Domain Mapping Work in Open Agents](/vercel-labs/open-agents/how-does-sandbox-port-exposure-and-domain-mapping-work-in-open-agents)

Learn how Open Agents maps sandbox port exposure to unique public subdomains. Discover routable URLs injected as environment variables for effortless web service exposure.

- Tags: deep-dive
- Published: 2026-04-16

### [How to Implement Persistent Session Resume via Reconnect in Open Agents](/vercel-labs/open-agents/how-to-implement-persistent-session-resume-via-reconnect-in-open-agents)

Learn to implement persistent session resume in Open Agents using reconnect. Store sandbox state and use VercelSandbox connect to reattach to running cloud VMs and refresh timeouts.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Implement Auto-Commit and Auto-PR Workflows with Open Agents](/vercel-labs/open-agents/how-to-implement-auto-commit-and-auto-pr-workflows-with-open-agents)

Learn to implement auto-commit and auto-PR workflows with Open Agents. Automate your Git pipeline and streamline pull requests programmatically using the GitHub API. No manual intervention needed.

- Tags: how-to-guide
- Published: 2026-04-16

### [How Diff Generation and Merge Readiness Checking Work in Open Agents](/vercel-labs/open-agents/how-does-diff-generation-and-merge-readiness-checking-work-in-open-agents)

Discover how Open Agents creates file diffs and checks merge readiness with efficient, stateful polling that respects GitHub API limits. Learn the inner workings of this powerful tool for seamless integration.

- Tags: deep-dive
- Published: 2026-04-16

### [How to Configure ElevenLabs Voice Transcription for Open Agents](/vercel-labs/open-agents/how-to-configure-elevenlabs-voice-transcription-for-open-agents)

Learn to configure ElevenLabs voice transcription for Open Agents. Set your API key and use the useAudioRecording hook to capture and transcribe audio with ElevenLabs Scribe v1.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Use and Configure Skills in the Open Agents System: A Complete Guide](/vercel-labs/open-agents/how-to-use-and-configure-skills-in-the-open-agents-system)

Master Open Agents skills! Learn how to use and configure reusable Markdown modules for custom functionality and automatic discovery in this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-04-16

### [How Chat Streaming Works in Open Agents: Server-to-Client Architecture Explained](/vercel-labs/open-agents/how-does-chat-streaming-work-with-open-agents)

Discover how Open Agents enables chat streaming with its server-to-client architecture. Learn about NDJSON serialization, React hooks, and robust network interruption handling for seamless conversations.

- Tags: deep-dive
- Published: 2026-04-16

### [How to Implement Custom beforeStop and afterStart Hooks for Open Agents Sandboxes](/vercel-labs/open-agents/how-to-implement-custom-beforestop-and-afterstart-hooks-for-open-agents-sandboxes)

Easily implement custom beforeStop and afterStart hooks for Open Agents sandboxes. Learn how to enhance your VM lifecycle with VercelSandbox.create and connectVercelSandbox.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Handle Sandbox Timeouts and Extend Them in Open Agents](/vercel-labs/open-agents/how-to-handle-sandbox-timeouts-and-extend-them-in-open-agents)

Learn to handle sandbox timeouts in Open Agents with extendTimeout and onTimeout hooks. Gracefully save state and avoid SDK enforced hard limits for uninterrupted agent execution.

- Tags: how-to-guide
- Published: 2026-04-16

### [How Read-Only Session Sharing Works in Open Agents Sandboxes](/vercel-labs/open-agents/how-does-read-only-session-sharing-work-in-open-agents-sandboxes)

Discover how Open Agents sandboxes enable read-only session sharing through unique share IDs and public endpoints serving sanitized markdown and streaming status.

- Tags: internals
- Published: 2026-04-16

### [How to Set Up Vercel OAuth Authentication for Open Agents](/vercel-labs/open-agents/how-to-set-up-vercel-oauth-authentication-for-open-agents)

Learn to set up Vercel OAuth authentication for Open Agents using PKCE flow. Securely store tokens and sync to sandboxed CLI environments. Explore our detailed guide.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Configure GitHub App Integration for Open Agents: Complete Setup Guide](/vercel-labs/open-agents/how-to-configure-github-app-integration-for-open-agents-repo-access-and-prs)

Configure GitHub App integration for Open Agents. Securely add repository and PR permissions via Vercel env variables and implement the OAuth flow for seamless access.

- Tags: how-to-guide
- Published: 2026-04-16

### [How the Open Agents Workflow SDK Enables Durable Multi-Step Execution](/vercel-labs/open-agents/how-does-the-open-agents-workflow-sdk-enable-durable-multi-step-execution)

Discover how the Open Agents Workflow SDK turns async functions into durable orchestrators. It survives crashes, retries automatically, and resumes from external events for reliable multi-step execution.

- Tags: deep-dive
- Published: 2026-04-16

### [How to Implement Snapshot-Based Sandbox Resume in Open Agents](/vercel-labs/open-agents/how-to-implement-snapshot-based-sandbox-resume-in-open-agents)

Learn how to implement snapshot-based sandbox resume in Open Agents using the Vercel Sandbox SDK to reconnect to stopped VMs efficiently. Save time and resources with this advanced technique.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Add Custom Tools to Open Agents: A Step-by-Step Guide](/vercel-labs/open-agents/how-to-add-custom-tools-to-an-open-agents-agent)

Learn how to add custom tools to Open Agents agents with this step-by-step guide. Integrate unique functionalities seamlessly into your AI workflows.

- Tags: how-to-guide
- Published: 2026-04-16

### [How to Configure Custom AI Models with the Open Agents Gateway](/vercel-labs/open-agents/how-to-configure-custom-ai-models-with-the-open-agents-gateway)

Learn to configure custom AI models with the Open Agents Gateway. Easily integrate your private endpoints using baseURL and apiKey for flexible AI solutions.

- Tags: how-to-guide
- Published: 2026-04-16

### [How the Agent-Sandbox Separation Architecture Works in Open Agents](/vercel-labs/open-agents/how-does-the-agent-sandbox-separation-architecture-work-in-open-agents)

Discover how the agent sandbox separation architecture in Open Agents isolates logic from execution. Learn how Vercel Firecracker VMs enable secure LLM loops and delegated operations.

- Tags: architecture
- Published: 2026-04-16