plano/docs/source/get_started/overview.rst

104 lines
4 KiB
ReStructuredText
Raw Normal View History

.. _overview:
Overview
2025-12-23 17:14:50 -08:00
========
`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.
2025-12-23 17:14:50 -08:00
Plano pulls out the rote plumbing work (the “hidden AI middleware”) and decouples you from brittle, everchanging framework abstractions. It centralizes what shouldnt 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.
2025-12-23 17:14:50 -08:00
Built by core contributors to the widely adopted `Envoy Proxy <https://www.envoyproxy.io/>`_, Plano gives you a productiongrade 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: OpenAIstyle v1/responses, de jure: MCP) and proven patterns like sidecar deployments, so it plugs in cleanly while remaining robust, scalable, and flexible.
2025-12-23 17:14:50 -08:00
In this documentation, youll 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.
2025-12-23 17:14:50 -08:00
.. figure:: /_static/img/plano_network_diagram_high_level.png
:width: 100%
:align: center
2025-12-23 17:14:50 -08:00
High-level network flow of where Plano sits in your agentic stack. Designed for both ingress and egress traffic.
Get Started
-----------
2025-12-23 17:14:50 -08:00
This section introduces you to Plano and helps you get set up quickly:
.. grid:: 3
.. grid-item-card:: :octicon:`apps` Overview
:link: overview.html
2025-12-23 17:14:50 -08:00
Overview of Plano and Doc navigation
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`book` Intro to Plano
:link: intro_to_plano.html
2025-12-23 17:14:50 -08:00
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
--------
2025-12-23 17:14:50 -08:00
Deep dive into essential ideas and mechanisms behind Plano:
.. grid:: 3
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`package` Agents
:link: ../concepts/agents.html
2025-12-23 17:14:50 -08:00
Learn about how to build and scale agents with Plano
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`webhook` Model Providers
:link: ../concepts/llm_providers/llm_providers.html
2025-12-23 17:14:50 -08:00
Explore Plano's LLM integration options
.. grid-item-card:: :octicon:`workflow` Prompt Target
:link: ../concepts/prompt_target.html
2025-12-23 17:14:50 -08:00
Understand how Plano handles prompts
Guides
------
2025-12-23 17:14:50 -08:00
Step-by-step tutorials for practical Plano use cases and scenarios:
.. grid:: 3
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`shield-check` Guardrails
:link: ../guides/prompt_guard.html
Instructions on securing and validating prompts
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`code-square` LLM Routing
:link: ../guides/llm_router.html
2025-12-23 17:14:50 -08:00
A guide to effective model selection strategies
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`issue-opened` State Management
:link: ../guides/state.html
2025-12-23 17:14:50 -08:00
Learn to manage conversation and application state
2025-12-23 17:14:50 -08:00
Build with Plano
----------------
2025-12-23 17:14:50 -08:00
End to end examples demonstrating how to build agentic applications using Plano:
.. grid:: 2
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`dependabot` Build Agentic Apps
:link: ../get_started/quickstart.html#build-agentic-apps-with-plano
2025-12-23 17:14:50 -08:00
Discover how to create and manage custom agents within Plano
2025-12-23 17:14:50 -08:00
.. grid-item-card:: :octicon:`stack` Build Multi-LLM Apps
:link: ../get_started/quickstart.html#use-plano-as-a-model-proxy-gateway
2025-12-23 17:14:50 -08:00
Learn how to route LLM calls through Plano for enhanced control and observability