Agent Configuration Documentation¶

Comprehensive documentation for agent configurations in Bast AI Agno.

Reference: Agno Agent Documentation

Documentation Index¶

📚 Core Documentation¶

Agent Configurations¶

Quick Start Guide
Get started in 5 minutes
Basic usage patterns
Common configurations
Troubleshooting
Configuration Guide
Complete configuration guide
All configuration types
Configuration utilities
Decision trees
Best practices
Configuration Schema
Complete field reference
Field types and defaults
Field dependencies
Validation rules
Common patterns
Examples
Practical examples
Real-world use cases
Integration patterns
Advanced scenarios
Agent Templates
Pre-configured agent templates
RAG agent template
Tool-using agent template
Conversational agent template
Reasoning agent template
Template usage examples

Workflow Configurations¶

Workflow Guide
Complete workflow documentation
Workflow factory usage
Workflow configurations
Step definitions (agents, teams, functions)
Workflow storage
Integration tests
Examples and best practices

Quick Links¶

Get Started¶

Agent Quick Start Guide - Start here for agents (5-minute introduction)
Workflow Guide - Complete workflow documentation

Learn More¶

Agent Configuration Guide - Comprehensive guide with decision trees
Agent Configuration Schema - Complete field reference
Workflow Guide - Workflow factory, configurations, and examples

See Examples¶

Agent Examples Guide - Practical agent code examples
Workflow Guide - Workflow examples and patterns

Documentation Structure¶

docs/
├── README.md                      # This file - Documentation index
├── AGENT_CONFIG_QUICK_START.md   # Agent quick start guide
├── AGENT_CONFIGURATIONS.md        # Complete agent configuration guide
├── AGENT_CONFIG_SCHEMA.md        # Agent schema reference
├── AGENT_CONFIG_EXAMPLES.md      # Agent practical examples
├── AGENT_TEMPLATES.md            # Agent templates guide
└── WORKFLOWS.md                  # Workflow configuration guide

Recent Updates¶

New Workflow System (v0.1.7)¶

Added complete workflow support with configuration-driven workflow creation:

AgnoWorkflowFactory - Workflow factory for building workflows from configuration/templates
Located in: bp/agno_workflows.py
Methods: create_workflow_from_json(), create_workflow(), create_workflow_from_template()
Supports agents, teams, and functions as workflow steps
Automatic workflow storage configuration
Workflow Configurations - Pre-configured workflow templates
Located in: dto/workflows/
simple_workflow_config.py - Basic workflow with researcher and writer agents
Supports sequential agent execution patterns
Separate Workflow Storage - Dedicated MongoDB database for workflows
Database: {prefix}_agno_workflow (separate from agent storage)
Located in: bp/mongodb_resources.py
Method: get_workflow_storage(workflow_name)
Integration Tests - Comprehensive workflow tests
Located in: integration/workflows/simple_workflow_check.py
Tests workflow creation, execution, storage, and error handling
Includes actual workflow execution using workflow.run()
DTO Folder Reorganization - Improved structure
dto/agents/ - All agent configurations
dto/utils/ - All utility functions
dto/workflows/ - Workflow configurations
Backward compatibility maintained with stub files

New Agent Configurations¶

Added three new agent configurations that mimic existing Bast AI models:

greeting_agent_config - Friendly greeting assistant (mimics greeting model)
Responds with warm, welcoming greetings
Located in: core_agent_configs.py
Use case: Initial user interactions
end_conversation_agent_config - Polite conversation ending assistant (mimics end_conversation model)
Responds with warm, closing messages
Located in: core_agent_configs.py
Use case: Ending conversations gracefully
early_exit_agent_config - Quick early exit decision assistant (mimics early_exit model)
Quickly determines if a conversation should exit early
Includes structured output schema (EarlyExitDecision)
Located in: core_agent_configs.py
Use case: Fast decision-making for conversation flow control

New Output Schema¶

EarlyExitDecision - Output schema for early exit decision analysis - Located in: dto/output/early_exit_output.py - Used with: early_exit_agent_config - Fields: - action: "HARD_EXIT" | "SOFT_EXIT" | "KEEP_GOING" - reason: str (e.g., "EMPTY_INPUT", "HAS_ENDING_PHRASE", "GREETING_MSG", "NO_EXIT")

External Resources¶

Agent Resources¶

Agno Agents Overview
Agno Building Agents
Agno Agent Schema (View the Agent schema link)

Workflow Resources¶

Module Structure¶

Business Process Modules¶

bp/agno_workflows.py - AgnoWorkflowFactory class for creating workflows from configuration/templates
bp/mongodb_resources.py - MongoDB storage resources with separate workflow database
bp/agno_agents.py - AgnoAgentFactory class for creating agents
bp/agno_teams.py - AgnoTeamFactory class for creating teams
bp/kb_resources.py - Knowledge base resources

Configuration Modules¶

Agent Configurations (dto/agents/)¶

core_agent_configs.py - Core agent settings & basic configurations (includes greeting, end_conversation, early_exit configs)
memory_configs.py - Memory configurations
storage_session_configs.py - Storage & sessions configurations
knowledge_configs.py - Knowledge (Agentic RAG) configurations
tools_configs.py - Tools configurations
reasoning_configs.py - Reasoning configurations
dependencies_configs.py - Dependencies configurations
context_engineering_configs.py - Context engineering configurations
hooks_guardrails_configs.py - Hooks & guardrails configurations
full_featured_configs.py - Full-featured configurations

Workflow Configurations (dto/workflows/)¶

simple_workflow_config.py - Basic workflow template with researcher and writer agents

Output Schema Modules¶

output/early_exit_output.py - Early exit decision output schema (EarlyExitDecision)

Utility Modules (dto/utils/)¶

agent_tool_utils.py - Tools utilities
agent_reasoning_utils.py - Reasoning utilities
agent_session_utils.py - Session utilities
agent_dependency_utils.py - Dependency utilities
agent_context_utils.py - Context utilities
agent_guardrails_utils.py - Guardrails utilities
agent_validation_utils.py - Validation utilities
agent_merge_utils.py - Merge utilities
agent_preset_utils.py - Preset utilities