Humanitec AI Agent

Hey beta-tester, nice to have you!

🌌 Canyon is a very early version of a developer self-service AI. Just like you, we’re on a journey to learn whether this could become an important part of the toolchain. We’re building this product 100% based on user feedback and we’re in love with the problem, not the solution. So please: do not hold back with any critical feedback!

This page will show you how you can integrate Canyon with your Humanitec Organization, and will allow both your Developers and your Platform Engineers boost their productivity in their day-to-day tasks.

Features supported

The Canyon MCP server will be responsible to orchestrate the requests between both:

• Either the Humanitec Documentation (via Kapa.ai);
• Or the Humanitec Orchestrator APIs (via humctl).

Note: The setup could have also pre-configured paths. If interested, please contact us, we will help you set this up. We recommend to not use this feature to start with, you will already be able to accomplish a lot with the two features above.

Prerequisites

• Access to your own Humanitec Organization.
• humctl CLI installed locally - interacts with your own Humanitec Organization.
• canyon CLI installed locally - forwards context, calls Orchestrator, essentially an MCP server.
• Visual Studio Code installed locally with the Cline extension - plugin manager for MCP servers, client to execute your prompts.
  • Note: other client can be used, but that's our recommendation during this beta-testing phase.

Setup in Cline extension

Our recommendation during this beta-testing phase is to use the Cline VS Code extension.

You can add a new server, with the config generated by the command:

canyon install

From there you are already ready to use the Canyon AI.

You can set the model you want to use, for example gemini-2.5-flash with which you will need to bring your own Gemini API Key.

Prompt examples

login to Humanitec

use the Humanitec Organization FIXME

list apps and envs

create application test

deploy a simple workload in application test in development environment

in test application, deploy the development environment in a new test environment

pause the test environment in test application

list paused environment across all the applications and environments

what is the most used resource types across all the applications and environments

is there any deployments in error across all the applications and environments

is there any workloads in error across all the applications and environments

list container images across the applications and environments

by app and env, what the duration of the latest deployment

diff between development and staging for online-boutique app

generate the Score file of the cart workload in the online-boutique app in development env, validate the file until no errors

Tips

render as a tree view

render as a graph

render in a human readable format

Support and feedack

Feel free to send your feedback directly to your Customer Success Engineering team, or via this support@humanitec.com email address. Your feedback are very much appreciated, thanks for taking the time testing and learning with this feature in beta phase.