Skip to main content

Agents

An Agent in Protean AI is a configurable, deployable AI execution unit that combines a deployed model, instructions, knowledge, memory, tools, and communication channels into a single governed artifact.

Where a raw model only predicts the next token, an Agent encapsulates intent, constraints, and execution context. Instead of re-prompting and re-wiring a model for every interaction, you define the behaviour once and reuse it across conversations, applications, and teams.

Agents are first-class resources: they can be published, versioned, deployed onto a node pool, shared, and governed with enterprise-grade access control.

AgentsSnapshot of Protean AI Platform

Agents provide the following advantages:

  • Encapsulate model behaviour, instructions, and runtime configuration in a single artifact
  • Produce repeatable, consistent AI behaviour across users and applications
  • Combine models, knowledge, memory, skills, and MCP tools without application-level wiring
  • Support a controlled draft → publish → revision lifecycle with full auditability
  • Expose the agent through multiple channels (interactive chat, MCP) from one definition

Core Concepts

Before configuring an Agent, it helps to understand three building blocks.

Agent

The Agent is the top-level resource. It has a name, a description, and a lifecycle status, and it bundles everything below: instructions, model, knowledge, memory, skills, MCP tools, channels, and evaluation, plus any sub-agents. It is deployed onto a node pool and, once published, can serve conversations.

Agent & Sub-Agents

Every Agent has a primary behaviour definition, its instructions, model, knowledge, memory, skills, MCP tools, channels, and evaluation. This is simply referred to as the agent.

An Agent can also contain sub-agents: specialised units the agent delegates to, each with its own model, instructions, and tools. A sub-agent is configured exactly like the agent itself. See Sub-Agents.

note

A sub-agent is a full, independent behaviour definition. The only thing it cannot contain is another layer of sub-agents, delegation is one level deep.

Deployment

A published Agent is deployed onto a node pool, which provisions the runtime that serves requests. An agent is only usable in chat once its deployment is created and has at least one available replica. See Deploy & Auth.

Configuration Overview

An Agent's behaviour is configured through a set of segments, each covered by its own page:

SegmentPurpose
GeneralName and description
ChannelsHow the agent is reached (Chat, MCP)
InstructionsThe system prompt that governs behaviour
ModelDeployed model, creativity, thinking, reasoning
KnowledgeKnowledge sets the agent searches to ground answers
MemoryConversation and long-term memory
SkillsBuilt-in capabilities (knowledge search, ask-user)
MCP ServersExternal tools the agent may call
EvaluationAutomatic scoring of the agent's responses
Sub-AgentsSpecialised units the agent delegates to
Deploy & AuthRuntime deployment and access control

Lifecycle at a Glance

Agents follow a controlled lifecycle to support safe iteration and governance:

StatusMeaning
DraftEditable; not yet usable by others
PublishedImmutable, deployed, and serving conversations
ArchivedSuperseded by a newer revision; preserved for audit
ObsoletedNo longer in use

Editing a published agent creates a new draft revision that points back at the published version. Publishing the draft promotes it, leaving the previous version intact for auditability. See Lifecycle & Publishing.

Access Control

Access Control governs who can view, create, modify, publish, and operate Agents. Protean AI follows the principle of least privilege. See Access Control for the full role/action matrix.

Workflow

  1. Create a new Agent (name + description).
  2. Write instructions, the system prompt that defines the agent's role and boundaries.
  3. Select a model and tune creativity, thinking, and reasoning options.
  4. Attach knowledge, memory, skills, and MCP tools as needed.
  5. Enable channels (Chat and/or MCP).
  6. Deploy the agent to a node pool and save & test it.
  7. Publish the agent so it can be shared and used across teams.