Agent class

Create and manage conversational agents

Basic usage

from kapso.builder import Agent
from kapso.builder.agent.constants import START_NODE, END_NODE

agent = Agent(
    name="support_bot",
    system_prompt="You are a helpful support assistant"
)

agent.add_node(START_NODE)
agent.add_node(END_NODE)
agent.add_edge(START_NODE, END_NODE)
agent.validate()

Constructor

Agent(
    name: str,
    system_prompt: str = None,
    message_debounce_seconds: int = None
)

• name: Agent identifier (alphanumeric + underscores)
• system_prompt: Instructions for the LLM
• message_debounce_seconds: Wait time before processing rapid messages

Methods

add_node()

agent.add_node(node)

Add a node to the graph. Accepts Node objects or START_NODE/END_NODE constants.

add_edge()

agent.add_edge(source, target, condition=None)

Connect two nodes with optional condition.

agent.add_edge(START_NODE, "greeting")
agent.add_edge("greeting", "help", condition="user needs help")

validate()

agent.validate()

Check graph structure. Required before deployment.

Special nodes

Every agent needs START_NODE and END_NODE:

from kapso.builder.agent.constants import START_NODE, END_NODE

agent.add_node(START_NODE)  # Entry point
agent.add_node(END_NODE)    # Exit point