Digital Employee Architecture
Overview
The Digital Employee system is an AI-powered automation platform built upon the AI Agent Platform (AIP). It enables autonomous workflow execution through intelligent agents. AIP manages agent operations, configurations, and orchestration of these digital employees.
The current implementation features a specific digital employee: the HR Recruiter, designed to streamline recruitment pipeline operations.
To learn more about the digital employee, please refer to the Digital Employee GitBook.
Core Components
The architecture consists of three primary layers: the User Interaction Layer, the Digital Employee instance, and the underlying AI Agent Platform (AIP).
1. User Interaction Layer
This layer facilitates communication between human users and the digital employee.
Claudia UI: A manual interface that allows users to provide direct instructions and interact via prompts.
WhatsApp: A mobile interface enabling direct user instructions and prompt-based interactions, where users can send prompts and receive answers directly through the messaging app.
2. Digital Employee
The digital employee is the core component and contains multiple agents with diverse capabilities.
Function: Operates as an intelligent agent utilizing specialized capabilities to execute tasks.
Current Application: The HR Recruiter digital employee processes candidates throughout the entire recruitment lifecycle.
3. AI Agent Platform (AIP)
AIP is the foundation for the system.
Role: Manages creation, configuration, and orchestration of all agents and digital employees.
Environment: All agents are created and maintained within the AIP environment.
Integration Architecture: Model Context Protocol (MCP)
The Digital Employee application uses Model Context Protocol (MCP) services to enable agents to interact securely with external systems and services. MCPs are managed through the AIP and use HTTP transport.
Google Workspace Integration
The system integrates with Google Workspace services using API Key authentication (X-API-Key header).
Google Calendar
Calendar Operations
Manages calendar events, schedules interviews, and coordinates meetings.
Google Docs
Document Operations
Handles document creation, editing, and management for recruitment workflows.
Google Drive
File Operations
Enables storage, retrieval, and management of recruitment documents.
Google Mail
Email Operations
Facilitates sending candidate communications and managing recruitment emails.
Google Sheets
Spreadsheet Operations
Manages recruitment data tracking and reporting via spreadsheets.
External Platform Integration
In addition to Google Workspace, the system connects to specialized enterprise platforms.
SQL Tool MCP
Description: Connects to CATAPA's digital_employee PostgreSQL database.
Transport: HTTP.
Authentication: Custom Headers (Bearer token, X-Api-Key, and X-Bosa-Integration headers).
Purpose: Provides direct access to query and manage recruitment data stored in CATAPA's database system.
Evalground MCP
Description: Handles operations for the Evalground platform.
Transport: HTTP.
Authentication: Bearer Token (Authorization header).
Purpose: Enables candidate evaluation and assessment operations, specifically for practical test processes.
Tools Framework
Digital employees utilize "Tools" to interact with applications outside the scope of MCPs (for example, the CATAPA API). Tools are categorized into two types: Built-in Tools and User-Defined Tools.
Built-in Tools
Generic, pre-configured collections provided by the AI Agent Platform. Designed for ease of use without coding. These are some of the built-in tools:
date_range_tool: Utility for handling date ranges.cv_extractor_tool: Utility for extracting information from Curricula Vitae.time_tool: Utility for time management.
User-Defined Tools
Custom tools created to handle specific tasks not covered by generic tools. Implemented as single-file Python code. These are some of the user-defined tools:
get_employee_info_tool: Retrieves specific employee information.update_candidate_phase_tool: Updates the recruitment phase of a candidate.detect_sister_company_tool: Logic to detect associated sister companies.
Key Benefits
Automation
Significantly reduces manual intervention by enabling scheduled operations.
Integration
Offers seamless connectivity with Google Workspace and other enterprise systems.
Flexibility
Features an extensible architecture that supports both standard (Built-in) and custom (User-Defined) tools.
Scalability
The MCP-based architecture allows for the easy addition of new services and capabilities as needs evolve.
Last updated