Backend
Backoffice
Burchelli - Text Processing

Burchelli - Text Processing Agent

Overview

Burchelli is the agent responsible for text processing in the TKM AI Agency Platform. Its main function is to process and manage incoming text, coordinate its storage, and request the generation of embeddings.

Directory Structure

Burchelli/
├── data/                   # Directory for processed data storage
├── burchelli.py           # Main agent class
├── api_burchelli.py       # FastAPI Endpoints
├── tools.py               # Utility functions
├── tools_schema.py        # Pydantic schemas
├── data_validation.py     # Data validation
└── tools_definitions.py   # Tool definitions

Main Components

BurchelliAgent Class

The main class that handles text processing and coordination with other agents:

  • Initialization with mediator and event bus
  • Data path management
  • Agent-specific configuration

API Endpoints

  • /process_text: Main endpoint for text processing
    • Accepts POST requests with text to process
    • Returns processing results

Key Features

Text Processing Pipeline

  1. Conversation verification with Atta
  2. Processed text storage
  3. Embedding generation request to Bala
  4. Processed message delivery to Atta

Transcription Handling

  • Audio transcription processing capability
  • Integration with event system for asynchronous handling

Integration

Agent Communication

  • Atta: Conversation verification and message storage
  • Bala: Embedding generation for processed text

Event System

  • Asynchronous event handling
  • Transcription processing through events

Error Handling

  • Robust text processing error handling
  • Input data validation
  • Detailed error and operation logging

Performance Features

  • Asynchronous text processing
  • Efficient data storage
  • Optimized agent integration