---
title: SDK
description: "Utilisez Beeuni Computer comme backend d’agents pour votre produit."
---

Utilisez `@beeuni/sdk` pour gérer vos projets, exécuter des sessions d’agents et connecter vos outils.

## Installation

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

## Créer un client

Créez une clé API dans **Account → Tokens**. Conservez les clés API du serveur sur votre serveur.

```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();
```

Le SDK appelle `getToken` à chaque requête. Votre application gère le stockage et le renouvellement des tokens ; voir [Authentification](/docs/fr/sdk/auth).

## Appeler un Connector

Recherchez les outils disponibles dans votre projet, puis consultez le schéma d’entrée d’un outil. Beeuni gère les identifiants des connexions.

Définissez `BEEUNI_PROJECT_ID` avec l’identifiant d’un projet existant accessible à votre clé API.

```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'));
```

Remplacez `toolName` par un nom renvoyé par la recherche et remplissez `args` selon son schéma d’entrée. Les appels nécessitent une connexion autorisée et la permission d’utiliser l’outil.

```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);
```

## Démarrer votre première session

```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()` démarre ou reprend la session et attend qu’elle soit prête. Sans paramètres de remplacement, `send()` utilise le modèle et l’agent configurés dans le projet. Les sessions consomment des crédits.

Pour recevoir les événements et lire la réponse, consultez l’[exemple complet](/docs/fr/sdk/example). Pour une interface React, utilisez [React hooks](/docs/fr/sdk/react).

## Guides

- [Se connecter avec Beeuni](/docs/fr/sdk/sign-in)
- [Exemple complet](/docs/fr/sdk/example)
- [Authentification](/docs/fr/sdk/auth)
- [Sessions](/docs/fr/sdk/sessions)
- [Apps](/docs/fr/sdk/apps)
- [Hooks React](/docs/fr/sdk/react)
- [Référence de l’API](/docs/fr/sdk/reference)