# SDK

Користите Beeuni Computer као позадински систем за агенте вашег производа.

Canonical page: https://beeuni.ai/docs/sr/sdk

Користите `@beeuni/sdk` за управљање пројектима, покретање сесија агената и повезивање алата.

## Инсталација

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

## Креирање клијента

Креирајте API кључ у **Account → Tokens**. Серверске API кључеве чувајте на свом серверу.

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

SDK позива `getToken` при сваком захтеву. Ваша апликација управља чувањем и обнављањем токена; погледајте [Аутентификација](/docs/sr/sdk/auth).

## Позовите Connector

Пронађите алате доступне у пројекту и проверите улазну шему алата. Beeuni управља приступним подацима веза.

Поставите `BEEUNI_PROJECT_ID` на ID постојећег пројекта коме ваш 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'));
```

Замените `toolName` именом алата из резултата претраге и попуните `args` према улазној шеми. Позиви захтевају ауторизовану везу и дозволу за коришћење алата.

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

## Покрените прву сесију

```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()` покреће или наставља сесију и чека да буде спремна. Без додатних параметара, `send()` користи модел и агента подешене у пројекту. Сесије троше кредите.

За пријем догађаја и читање одговора погледајте [потпун пример](/docs/sr/sdk/example). За React интерфејс користите [React hooks](/docs/sr/sdk/react).

## Водичи

- [Пријављивање преко Beeuni](/docs/sr/sdk/sign-in)
- [Потпун пример](/docs/sr/sdk/example)
- [Аутентификација](/docs/sr/sdk/auth)
- [Сесије](/docs/sr/sdk/sessions)
- [Apps](/docs/sr/sdk/apps)
- [React куке](/docs/sr/sdk/react)
- [API референца](/docs/sr/sdk/reference)