Skip to content
All capabilities

Build

Conversations and tasks

Connect messages, replies and task state to your own application.

Example run
import { BeeOSClient } from "@beeos-ai/cloud-sdk";
const cloud = new BeeOSClient({
  baseURL: process.env.BEEOS_CLOUD_API_URL!,
  apiKey: process.env.BEEOS_API_KEY!,
}).withExternalUser(process.env.BEEOS_EXTERNAL_USER_ID!);

const response = await cloud.responses.create({
  input: "Reconcile this month's invoices and flag issues",
  metadata: { harness_id: harness.hermes },
}, crypto.randomUUID());
console.log(response.output);
Output
    1. 01

      Create a conversation in your product

    2. 02

      Send a message through your backend

    3. 03

      Receive the runtime reply and update task state

    A practical use case

    Send a user message through your backend, receive the agent reply and retain product ownership of the conversation.

    • Message and reply contracts
    • Cancellation handling
    • Product-owned conversation identity

    Start integrating

    Start integrating

    Read the integration guide, then connect your runtime and backend.

    Documentation