A Developer's Guide to the .do SDK: Programming Your Digital Worker

The conversation around AI has evolved from simple chatbots to the promise of true digital colleagues. But how do we move from theory to practice? How can developers harness this power to automate not just simple, repetitive actions, but complex, end-to-end business objectives?

Enter Lena, your autonomous digital teammate, powered by the .do platform.

Lena isn't just another automation script. She is an Autonomous Digital Worker designed to understand high-level goals, plan a course of action, and execute complex knowledge-based work. For developers, this opens up a new frontier: the ability to program business outcomes, not just software functions. This guide will walk you through the .do SDK, showing you just how easy it is to assign your first task to Lena.

From Brittle Automation to Agentic Workflows

Traditional automation and RPA (Robotic Process Automation) are powerful but often rigid. They follow a strict set of predefined rules. If a website's layout changes or an unexpected error occurs, the script breaks. It lacks the ability to reason or adapt.

Lena operates on a different principle: agentic workflows. Instead of giving her a rigid script, you give her a goal. She then uses her reasoning capabilities to:

1. Plan: Break down the high-level objective into a series of logical steps.
2. Execute: Utilize a suite of tools—like web browsing, data analysis, and API calls—to perform those steps.
3. Adapt: If one approach fails, she can dynamically re-plan and try another way to achieve the goal.
4. Deliver: Synthesize the results into a final, coherent deliverable.

This makes Lena a dynamic problem-solver, capable of handling the unpredictability of real-world business tasks.

Getting Hands-On: Your First Task with the .do SDK

The true power of Lena is unlocked through the .do SDK. It provides a clean, intuitive interface for integrating this autonomous capability directly into your applications and workflows.

Let's look at how you can assign a market research task to Lena using just a few lines of TypeScript.

import { Do } from '@do-sdk/core';

// Initialize the .do client
// Assumes your API key is configured in your environment
const dispatch = new Do();

// Get a client for the Lena agent
const lena = dispatch.agent('lena');

// Assign a high-level goal to Lena
const project = await lena.assign({
  goal: 'Analyze market trends for solar energy in Q3',
  deliverable: 'A comprehensive report with key findings and data visualizations.'
});

console.log(`Project assigned to Lena. ID: ${project.id}`);

Deconstructing the Code

Let's break down what's happening here:

• const dispatch = new Do();: This is your entry point to the .do platform. It initializes the main client that will manage communication with the agents.
• const lena = dispatch.agent('lena');: The platform can host multiple specialized agents. Here, we're specifically requesting a client to interact with lena.
• const project = await lena.assign({...});: This is where the magic happens. The assign method is the core of the interaction. You pass it an object containing:
  • goal: A plain-English description of the high-level objective. This is about intent, not a list of commands.
  • deliverable: A clear description of the final output you expect.
• console.log(...): The assign method immediately returns a project object with an id. You can use this ID to track the status and retrieve the results of Lena's work asynchronously.

You’ve just transformed a complex, multi-hour research task into a single, asynchronous API call. This is the essence of Business-as-Code.

Defining Work with Goals and Deliverables

The goal and deliverable primitives are the foundation of working with Lena. This model allows you to stay focused on the "what" and "why," while empowering Lena to figure out the "how."

Think of the possibilities:

• Lead Enrichment:
  • goal: "For the company 'Acme Inc.' (acme.com), find their industry, key executives, and recent news."
  • deliverable: "A JSON object with fields for 'industry', 'executives', and 'recentNews'."
• Data Analysis:
  • goal: "Analyze the attached CSV of user sign-ups and identify the top 3 geographic regions by growth percentage month-over-month."
  • deliverable: "A summary document with a table and a bar chart showing the findings."
• Content Creation:
  • goal: "Write a draft blog post about the benefits of agentic workflows for software development teams."
  • deliverable: "A markdown file with the draft."

By packaging these complex business processes into programmable API calls, you begin to create Services-as-Software. A process that once required a team of analysts can now be an on-demand, scalable service in your technology stack.

Getting Started: Add Lena to Your Team

Ready to delegate your first task? Here’s how you can get up and running in minutes.

1. Install the SDK: Open your terminal and run the command to add the SDK to your project.

   npm install @do-sdk/core
   

2. Get Your API Key: Sign up on lena.do to get your unique API key. You'll need to configure this in your environment for the SDK to authenticate.

3. Write the Code: Create a new TypeScript file and use the code example from above as your template. Customize the goal and deliverable to fit a task you have in mind.

4. Run and Delegate: Execute your script. You'll see the project ID logged to your console. While you work on other things, Lena is already planning and executing the task you assigned.

Conclusion: The Future of Work is Programmable

Lena and the .do platform represent a fundamental shift in how we approach business automation. As a developer, you are no longer limited to scripting rigid, step-by-step instructions. You can now delegate entire business outcomes to an autonomous agent that can reason, adapt, and deliver.

By acting as a force multiplier, Lena frees up your human team to focus on strategic initiatives, creativity, and high-value problems that only they can solve.

What complex objective will you automate first? Get started with the .do SDK today and add an autonomous teammate to your stack.