.. _overview:

Overview
========
`Plano <https://github.com/katanemo/plano>`_ is delivery infrastructure for agentic apps. An AI-native proxy server and data plane designed to help you build agents faster, and deliver them reliably to production.

Plano pulls out the rote plumbing work (the “hidden AI middleware”) and decouples you from brittle, ever‑changing framework abstractions. It centralizes what shouldn’t be bespoke in every codebase like agent routing and orchestration, rich agentic signals and traces for continuous improvement, guardrail filters for safety and moderation, and smart LLM routing APIs for UX and DX agility. Use any language or AI framework, and ship agents to production faster with Plano.

Built by core contributors to the widely adopted `Envoy Proxy <https://www.envoyproxy.io/>`_, Plano gives you a production‑grade foundation for agentic applications. It helps **developers** stay focused on the core logic of their agents, helps **product teams** shorten feedback loops for learning, and helps **engineering teams**  standardize policy and safety across agents and LLMs. Plano is grounded in open protocols (de facto: OpenAI‑style v1/responses, de jure: MCP) and proven patterns like sidecar deployments, so it plugs in cleanly while remaining robust, scalable, and flexible.

In this documentation, you’ll learn how to set up Plano quickly, trigger API calls via prompts, apply guardrails without tight coupling with application code, simplify model and provider integration, and improve observability — so that you can focus on what matters most: the core product logic of your agents.

.. figure:: /_static/img/plano_network_diagram_high_level.png
   :width: 100%
   :align: center

   High-level network flow of where Plano sits in your agentic stack. Designed for both ingress and egress traffic.


Get Started
-----------

This section introduces you to Plano and helps you get set up quickly:

.. grid:: 3

    .. grid-item-card:: :octicon:`apps` Overview
        :link: overview.html

        Overview of Plano and Doc navigation

    .. grid-item-card:: :octicon:`book` Intro to Plano
        :link: intro_to_plano.html

        Explore Plano's features and developer workflow

    .. grid-item-card:: :octicon:`rocket` Quickstart
        :link: quickstart.html

        Learn how to quickly set up and integrate


Concepts
--------

Deep dive into essential ideas and mechanisms behind Plano:

.. grid:: 3

    .. grid-item-card:: :octicon:`package` Agents
        :link: ../concepts/agents.html

        Learn about how to build and scale agents with Plano

    .. grid-item-card:: :octicon:`webhook` Model Providers
        :link: ../concepts/llm_providers/llm_providers.html

        Explore Plano's LLM integration options

    .. grid-item-card:: :octicon:`workflow` Prompt Target (Deprecated)
        :link: ../concepts/prompt_target.html

        Deprecated — kept for existing users. New apps should use Agents.


Guides
------
Step-by-step tutorials for practical Plano use cases and scenarios:

.. grid:: 3

    .. grid-item-card:: :octicon:`shield-check` Guardrails
        :link: ../guides/prompt_guard.html

        Instructions on securing and validating prompts

    .. grid-item-card:: :octicon:`code-square` LLM Routing
        :link: ../guides/llm_router.html

        A guide to effective model selection strategies

    .. grid-item-card:: :octicon:`issue-opened` State Management
        :link: ../guides/state.html

        Learn to manage conversation and application state


Build with Plano
----------------

End to end examples demonstrating how to build agentic applications using Plano:

.. grid:: 2

    .. grid-item-card:: :octicon:`dependabot` Build Agentic Apps
        :link: ../get_started/quickstart.html#build-agentic-apps-with-plano

        Discover how to create and manage custom agents within Plano

    .. grid-item-card:: :octicon:`stack` Build Multi-LLM Apps
        :link: ../get_started/quickstart.html#use-plano-as-a-model-proxy-gateway

        Learn how to route LLM calls through Plano for enhanced control and observability
