For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inBook a demo
DocsReferenceChangelog
DocsReferenceChangelog
  • Getting Started
    • Overview
    • Quickstart
  • Explanation
    • Integrating Humanloop
      • Files
      • Prompts
      • Agents
      • Evaluators
      • Tools
      • Flows
      • Datasets
      • Logs
      • Directories
      • Environments
  • Tutorials
    • Evaluate an Agent in the UI
    • Evaluate an Agent in code
    • Evaluate a RAG app
    • Capture user feedback
  • How-To Guides
    • Migrating from Humanloop
  • Reference
    • Deployment Options
    • Supported Models
    • Template Library
    • Vercel AI SDK
    • .prompt and .agent Files
    • Humanloop Runtime Environment
    • Security and Compliance
    • Data Management
    • Access roles (RBACs)
    • SSO and Authentication
    • LLMs.txt
LogoLogo
Sign inBook a demo
On this page
  • Managing your environments
  • The default environment
  • Using environments
  • Using environments via API
ExplanationKey Concepts

Environments

Deployment environments enable you to control the deployment lifecycle of your Prompts and other files between development and production environments.
Was this page helpful?
Previous

Evaluate an Agent in the UI

Evaluate and improve your Agent by running Evals in the Humanloop UI.
Next
Built with

Environments enable you to deploy different versions of your files to specific environments, allowing you to separately manage the deployment workflow between testing and production. With environments, you have the control required to manage the full LLM deployment lifecycle.

Managing your environments

Every organisation automatically receives a default production environment. You can create additional environments with custom names by visiting your organisation’s environments page.

Only Enterprise customers can create more than one environment

The environments you define for your organisation will be available for each file and can be viewed in the file’s dashboard once created.

The default environment

By default, the production environment is marked as the Default environment. This means that all API calls that don’t explicitly target a specific environment will use this environment. You can rename the default environment on the organisation’s environments page.

Renaming the environments will take immediate effect, so ensure that this change is planned and does not disrupt your production workflows.

Using environments

Once created on the environments page, environments can be used for each file and are visible in the respective dashboards.

You can deploy directly to a specific environment by selecting it in the Deployments section.

Alternatively, you can deploy to multiple environments simultaneously by deploying a version from either the Editor or the Versions table.

Using environments via API

You can now call the version deployed in a specific environment by including an optional additional environment field. An example of this field can be seen in the v5 Prompt Call documentation.