# Digital Employee Architecture

## Overview

<figure><img src="https://2914931754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXbRDlxflF58D1QG2tLmP%2Fuploads%2FcxwWhpJZaKNo7Al3hT29%2FDigital%20Employee%20Architecture%20Block%20Diagram%20(2).png?alt=media&#x26;token=a2dc90fc-5968-4842-8aa3-7dc10b280531" alt=""><figcaption></figcaption></figure>

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.

{% hint style="info" %}
To learn more about the digital employee, please refer to the [Digital Employee GitBook](https://gdplabs.gitbook.io/digital-employee).
{% endhint %}

## 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).

| MCP Service         | Description            | Purpose                                                                       |
| ------------------- | ---------------------- | ----------------------------------------------------------------------------- |
| **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

{% stepper %}
{% step %}
**Automation**

Significantly reduces manual intervention by enabling scheduled operations.
{% endstep %}

{% step %}
**Integration**

Offers seamless connectivity with Google Workspace and other enterprise systems.
{% endstep %}

{% step %}
**Flexibility**

Features an extensible architecture that supports both standard (Built-in) and custom (User-Defined) tools.
{% endstep %}

{% step %}
**Scalability**

The MCP-based architecture allows for the easy addition of new services and capabilities as needs evolve.
{% endstep %}
{% endstepper %}