---
title: SDK
description: "Nutze Beeuni Computer als Agent-Backend für dein Produkt."
---

Mit `@beeuni/sdk` verwaltest du Projekte, führst Agent-Sitzungen aus und verbindest deine Tools.

## Installation

```bash
npm install @beeuni/sdk
```

## Client erstellen

Erstelle einen API-Schlüssel unter **Account → Tokens**. Bewahre Server-API-Schlüssel auf deinem Server auf.

```ts
import { createBeeuni } from '@beeuni/sdk';

const beeuni = createBeeuni({
  backendUrl: 'https://api.beeuni.ai/v1',
  getToken: async () => process.env.BEEUNI_API_KEY ?? null,
});

const projects = await beeuni.projects.list();
```

Das SDK ruft `getToken` bei jeder Anfrage auf. Deine Anwendung verwaltet Tokens und ihre Erneuerung; siehe [Authentifizierung](/docs/de/sdk/auth).

## Connector aufrufen

Finde die verfügbaren Tools deines Projekts und prüfe das Eingabeschema eines Tools. Beeuni verwaltet die Zugangsdaten der Verbindungen.

Setze `BEEUNI_PROJECT_ID` auf ein bestehendes Projekt, auf das dein API-Schlüssel zugreifen darf.

```ts
const projectId = process.env.BEEUNI_PROJECT_ID!;
const connectors = beeuni.project(projectId).connectors;

console.log(await connectors.catalog());
console.log(await connectors.search('search email'));
```

Ersetze `toolName` durch einen Namen aus den Suchergebnissen und fülle `args` gemäß dem Eingabeschema aus. Aufrufe benötigen eine autorisierte Verbindung und die Berechtigung für das Tool.

```ts
const toolName = 'your_connector.your_action';
console.log(await connectors.describe(toolName));

const args = {};
const result = await connectors.call(toolName, args);
console.log(result);
```

## Erste Sitzung starten

```ts
const created = await beeuni.project(projectId).sessions.create({
  name: 'My first SDK session',
});
const session = beeuni.session(projectId, created.session_id);

await session.ensureReady();
await session.send('Describe your capabilities in one paragraph.');
```

`ensureReady()` startet oder setzt die Sitzung fort und wartet auf Bereitschaft. Ohne Überschreibungen verwendet `send()` das konfigurierte Modell und den Agenten des Projekts. Sitzungen verbrauchen Guthaben.

Ereignisse und Antworten zeigt das [vollständige Beispiel](/docs/de/sdk/example). Für eine React-Oberfläche nutze [React hooks](/docs/de/sdk/react).

## Anleitungen

- [Mit Beeuni anmelden](/docs/de/sdk/sign-in)
- [Vollständiges Beispiel](/docs/de/sdk/example)
- [Authentifizierung](/docs/de/sdk/auth)
- [Sitzungen](/docs/de/sdk/sessions)
- [Apps](/docs/de/sdk/apps)
- [React-Hooks](/docs/de/sdk/react)
- [API-Referenz](/docs/de/sdk/reference)