Overview
Extend Umbraco.AI with custom providers, middleware, and tools.
Umbraco.AI is designed to be extensible. You can add support for new AI providers, customize the request pipeline with middleware, and create custom tools for AI agents.
Extension Points
Custom Providers
Add support for AI services not included out of the box
Middleware
Add logging, caching, rate limiting, and custom behavior
Custom Tools
Create tools that AI agents can use to perform actions
Agent Workflows
Create multi-agent orchestration workflows for orchestrated agents
Custom Guardrail Evaluators
Create evaluators for domain-specific safety and compliance rules
Knowledge Sets
Ship background knowledge about your product that the AI can draw on
Notifications
Subscribe to entity lifecycle events for validation and automation
When to Extend
Create a Custom Provider When
You need to connect to an AI service without an existing provider
You want to use a self-hosted AI model
You need custom authentication or API handling
Create Middleware When
You want to log all AI requests and responses
You need to cache responses for identical requests
You want to add rate limiting or retry logic
You need to modify requests or responses globally
Create Custom Tools When
You want AI agents to interact with your systems
You need to expose business logic to AI
You want to enable AI to query databases or APIs
Create Agent Workflows When
You need multi-agent orchestration (e.g., writer + editor pipelines)
You want to compose agents into sequential or parallel workflows
You need custom agent collaboration patterns
Create a Knowledge Set When
You ship a package and want the AI to understand your product
You want to provide background reference material without an end-user having to configure anything
You have content that the AI should draw on only when it is relevant
Subscribe to Notifications When
You need to validate operations before they execute
You want to audit changes for compliance
You need to trigger automation in response to events
You want to maintain data consistency across systems
Architecture Overview
In This Section
Custom ProvidersMiddlewareCustom ToolsWorkflowsKnowledge SetsNotificationsLast updated
Was this helpful?