# Esempio completo

Esegui una sessione e ricevi la risposta con Beeuni SDK.

Canonical page: https://beeuni.ai/docs/it/sdk/example

Salva lo script come `full-example.ts`. Crea una sessione in un progetto esistente, apre il flusso di eventi, invia un prompt e legge la trascrizione.

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

async function main() {
  const apiKey = process.env.BEEUNI_API_KEY;
  const projectId = process.env.BEEUNI_PROJECT_ID;
  if (!apiKey || !projectId) {
    throw new Error('Set BEEUNI_API_KEY and BEEUNI_PROJECT_ID.');
  }

  const beeuni = createBeeuni({
    backendUrl: 'https://api.beeuni.ai/v1',
    getToken: async () => apiKey,
  });
  const created = await beeuni.project(projectId).sessions.create({
    name: 'SDK example',
  });
  console.log('Session:', created.session_id);

  const session = beeuni.session(projectId, created.session_id);
  const { runtimeSessionId } = await session.ensureReady();
  let finish!: () => void;
  let failure: string | undefined;
  let submitted = false;
  const finished = new Promise<void>((resolve) => { finish = resolve; });

  const stream = await session.stream({
    onEvent: (event) => {
      const e = narrowChatEvent(event);
      if (!e || !submitted || !('sessionID' in e) || e.sessionID !== runtimeSessionId) return;
      if (e.type === 'message.part.updated') console.log(e.part);
      if (e.type === 'session.error') {
        failure = JSON.stringify(e.error ?? 'Session failed.');
        finish();
      }
      if (e.type === 'session.idle') finish();
    },
  });

  const timer = setTimeout(() => {
    failure = 'Reply timed out. Check the session for pending permissions or questions.';
    finish();
  }, 180_000);

  try {
    submitted = true;
    await session.send('Describe your capabilities in one paragraph.');
    await finished;
    if (failure) throw new Error(failure);
    console.log(JSON.stringify(await session.messages(), null, 2));
  } finally {
    clearTimeout(timer);
    stream.close();
  }
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});
```

## Esecuzione

Crea una chiave API in **Account → Tokens** e usa un progetto accessibile alla credenziale. Lo script usa il modello configurato nel progetto; le sessioni consumano crediti.

```bash
npm install @beeuni/sdk
BEEUNI_API_KEY=your-api-key BEEUNI_PROJECT_ID=your-project-id npx tsx full-example.ts
```

## Passi successivi

[Autenticazione](/docs/it/sdk/auth)

Per un'interfaccia React usa [React hooks](/docs/it/sdk/react). Per permessi, domande ed errori di avvio vedi [Sessions](/docs/it/sdk/sessions).