Instantiation

Prerequisites

For these examples, you will need to:

• Complete the Extend section

Instantiate Digital Employee

Import the Package

from extended_digital_employee.connectors.mcps import new_google_calendar_mcp  # new MCP
from extended_digital_employee.connectors.tools import ConfigurableGenerateInterviewDateTool  # new Tool
from extended_digital_employee.digital_employee import ExtendedDigitalEmployee
from extended_digital_employee.identity import ExtendedDigitalEmployeeIdentity
from glaip_sdk import Tool

from digital_employee_core import (
    DigitalEmployeeConfiguration,
    DigitalEmployeeJob,
)

Initialize the Extended Digital Employee

job = DigitalEmployeeJob(
    title="Recruitment Coordinator",
    description="Coordinates technical interviews and manages candidate scheduling",
    instruction="When candidates pass the initial screening, schedule their technical interview. Always confirm the date clearly and provide a warm and professional response.",
)
extended_identity = ExtendedDigitalEmployeeIdentity(
    name="Alex Morgan", email="[e-mail]", job=job, employee_id="EMP-123"
)
configurations = [
    DigitalEmployeeConfiguration(key="INTERVIEW_DAYS_TO_ADD", value="10"),
    DigitalEmployeeConfiguration(key="INTERVIEW_EXCLUDED_WEEKDAYS", value="5,6"),
    DigitalEmployeeConfiguration(key="NEW_GOOGLE_CALENDAR_MCP_URL", value="https://api.bosa.id/google_calendar/mcp"),
    DigitalEmployeeConfiguration(key="NEW_GOOGLE_MCP_X_API_KEY", value="[gl-connectors-x-api-key]"),
]

# Initialize extended digital employee
extended_digital_employee = ExtendedDigitalEmployee(
    identity=extended_identity,
    mcps=[new_google_calendar_mcp],
    tools=[Tool.from_langchain(ConfigurableGenerateInterviewDateTool)],
    configurations=configurations,
)
extended_digital_employee.deploy()

In this example, we use new MCPs (mcps=[new_google_calendar_mcp]) and tools (tools=[Tool.from_langchain(ConfigurableGenerateInterviewDateTool)]) that are specifically created for the extended digital employee.

We also use INTERVIEW_DAYS_TO_ADD, INTERVIEW_EXCLUDED_WEEKDAYS, NEW_GOOGLE_CALENDAR_MCP_URL and NEW_GOOGLE_MCP_X_API_KEY configurations, which are defined in the config template of the new tool and MCP.

Run the Extended Digital Employee

# Run the extended digital employee using a prompt
result = extended_digital_employee.run(
    message="I need to schedule a technical interview for a software engineer candidate who just passed the screening round. Can you generate an interview date?",
)

Before running the sample code, replace the following placeholders:

1. Replace [gl-connectors-x-api-key] with x-api-key from GL Connectors. See below for one way to do it.

2. (Optional) Replace NEW_GOOGLE_CALENDAR_MCP_URL if you are using a different GL Connectors server instance.

🔑 Get GL Connectors x-api-key

1. Open https://api.bosa.id/console, then sign in.

2. In the Credentials section, expand the x-api-key panel and click Copy combined value button. Paste this value to replace [gl-connectors-x-api-key] .

1. If your Gmail account has not been integrated yet, continue with the steps below.

2. Under Available Modules section, find the Google_mail integration and click Add New Integration button.

1. An authorization URL will appear. Click or copy the URL, then authenticate using your Gmail account.

1. Below is an example of a successfully integrated Gmail account.