Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

embed-avatar-assistant

/embed-avatar-assistant

Dodaje do strony pływający asystent-awatar 3D z jednym tagiem skryptu lub pakietem npm, a potem steruje nim z kodu strony.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Dodaje do strony pływający asystent-awatar 3D z jednym tagiem skryptu lub pakietem npm, a potem steruje nim z kodu strony.

Oryginalny opis (EN)

Add the three.ws 3D avatar assistant widget (floating launcher, chat mode, speak mode) to any website with one script tag or the @three-ws/assistant npm package, then drive it from page code. Use when a user wants an animated avatar chatbot or a talking avatar on a site.

Jak działa

  1. Install
  2. Options (config key or data- attribute)
  3. Page API
  4. Worked example
Sekcje z nagłówków SKILL.md, w oryginale · 63 linii, 339 słów
Podgląd SKILL.md
---
name: embed-avatar-assistant
description: Add the three.ws 3D avatar assistant widget (floating launcher, chat mode, speak mode) to any website with one script tag or the @three-ws/assistant npm package, then drive it from page code. Use when a user wants an animated avatar chatbot or a talking avatar on a site.
---

# Embed the three.ws avatar assistant

The widget is a small host-side loader. The avatar, chat and speech run in an iframe hosted on three.ws (`/assistant-frame`), so the page never sees model keys. Chat uses the platform's free model chain by default (visitors can switch to their own Groq or OpenRouter key); speak mode uses browser text-to-speech with no model.

## Install

One tag, no build:

```html
<script src="https://three.ws/assistant/v1.js" async
  data-avatar="/avatars/selfie-girl.glb"
  data-name="Atelier AI"
  data-greeting="Ask anything about Atelier."
  data-context="Atelier is a design studio for 3D artists."
  data-bg="transparent"
  data-accent="#f97316"></script>
```

Or npm:

```bash
npm install @three-ws/assistant
```

```js
import ThreeAssistant from '@three-ws/assistant';
ThreeAssistant.init({ avatar: '/avatars/selfie-girl.glb', name: 'Atelier AI', mode: 'both' });
```

## Options (config key or `data-*` attribute)

- `avatar`: an avatar id, `/avatars/*.glb`, or a GLB, GLTF or VRM URL on an allow-listed host (three.ws, R2, Ready Player Me). `agent`: a three.ws agent id whose avatar is used instead.
- `mode`: `chat`, `speak` or `both` (default). `name` (60 chars), `greeting` (200), `context` (500, what the chatbot should know about the site).
- `bg`: `transparent` (default), a `#hex`, a preset (`ember`, `ocean`, `violet`, `forest`, `dusk`, `slate`) or `gradient:#a,#b,angle`. `accent`: `#hex`. `position`: `right` or `left`.
- `voice="false"` starts muted, `badge="false"` hides the attribution badge, `open` starts open, `origin` overrides the frame host (config key only), `data-manual` stops auto-mount on the one-tag build.

Invalid values fall back to a safe default inside the frame.

## Page API

```js
ThreeAssistant.init(config);          // replaces any existing instance
ThreeAssistant.open(); ThreeAssistant.close(); ThreeAssistant.toggle();
ThreeAssistant.say('Welcome to the sale!');   // opens and speaks the line
ThreeAssistant.setMode('speak');      // only when mounted with mode 'both'
ThreeAssistant.destroy();
```

Named exports: `init`, `say`, `createAssistant({ origin })`, `VERSION`. Events fire on `window` as `three-assistant` with `detail.type` of `ready`, `open`, `close`, `message`, `speak:start`, `speak:end` or `error`.

## Worked example

```js
window.addEventListener('three-assistant', (e) => {
  if (e.detail.type === 'message') console.log(e.detail.payload.role, e.detail.payload.content);
});
ThreeAssistant.init({ avatar: '/avatars/selfie-girl.glb', name: 'Shop Guide', context: 'We sell ceramic mugs.' });
document.querySelector('#sale').addEventListener('click', () => ThreeAssistant.say('Mugs are 20 percent off today.'));
```

Keep `context` to public site facts; it is sent to the chat model.

Wersje

W bazie nie ma innych skilli o nazwie embed-avatar-assistant.

Migawka bazy z 13.11.2026 · wersja paczki df14badcb755 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100embed-assistant-widget
    Generuje gotowy do wklejenia osadzony czat z awatarem 3D three.ws, z tagiem skryptu, adresem ramki i fragmentem inicjalizacji.
  • 100embed-three-ws-avatar
    Osadza żywy, animowany awatar 3D three.ws na stronie przez komponent agent-3d, w tym sterowanie animacjami i nastrojami awatara z kodu strony.
  • 100talking-avatar-skill
    Tworzy lekką aplikację do rozmowy głosowej z awatarem postaci, z obrazu lub opisu, z synchronizacją ust z dźwiękiem.
  • 100liveavatar-integrate
    Prowadzi przez integrację LiveAvatar od początku do końca: ocenia stos użytkownika, rekomenduje ścieżkę (Embed, FULL Mode, LITE) i prowadzi wdrożenie awatara w czasie rzeczywistym.
  • 100simli
    Dodaje do agenta głosowego lub aplikacji webowej awatar wideo z synchronizacją ust przez Simli, w tym własny awatar z zdjęcia.
  • 100seer-embed
    Dodaje nowy widget embed Seer renderowany inline w markdownie przez składnię tagów: schemat, komponent, rejestracja i codegen backendu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.