Įskiepio dokumentacija

Kaip įdėti agentlab DI asistentą į savo svetainę. Pamatyti, kaip jis veikia, galite įskiepio puslapyje.

Pradžia
Nustatymai
JavaScript
Reikalavimai
Privatumas
Ribos
Jei neveikia

Pradžia

Įklijuokite šią eilutę į kiekvieną puslapį, kuriame norite asistento, prieš uždarantį </body>:

<script src="https://agentlab.lt/widget.js" data-agent="health" data-lang="lt" async></script>

Apačioje dešinėje atsiras apvalus mygtukas. Jį paspaudus atsidaro pokalbio langas: lankytojas pasirenka temą ir spaudžia „Susirašinėti“ arba „Kalbėti“. Susirašinėjant rašoma, o balsą galima įjungti mikrofono mygtuku bet kada. Kalbant pokalbis vyksta balsu, kaip telefonu, o jo metu galima ir rašyti; jei mikrofono nėra arba lankytojas jo neleidžia, pokalbis vyksta raštu. Telefone langas užima visą ekraną.

Suskleidus langą pokalbis nesibaigia: mygtuke rodomas žalias taškas, o atidarius pokalbis tęsiasi. Pokalbis baigiasi paspaudus raudoną mygtuką arba išėjus iš puslapio.

Nustatymai

Nustatymai rašomi kaip <script> žymos atributai.

Atributas	Reikšmė	Numatyta
`data-agent`	Temos, atskirtos kableliais: `health`, `business`, `dijorus`, `anekdotai`, `chatgpt`, arba jūsų asistento raktas iš paskyros, pvz. `a-1f2e3d4c5b6a`. Su viena tema įskiepyje rodoma tik ji.	agentlab.lt pradžios puslapio asistentai
`data-lang`	Įskiepio kalba: `lt` arba `en`. Asistentas atsako ta kalba, kuria į jį kreipiamasi.	`lt`
`data-position`	Kampas: `right` arba `left`.	`right`
`data-color`	Mygtuko ir antraštės spalva, šešioliktainiu kodu, pvz. `#277ba9`.	`#e5484d`
`data-manual`	Mygtukas nerodomas, kol jo nesukursite patys su `AgentlabWidget.mount()`.	nėra

<script src="https://agentlab.lt/widget.js"
  data-agent="health,chatgpt"
  data-lang="lt"
  data-position="left"
  data-color="#277ba9"
  async></script>

JavaScript

Įkėlus skriptą, puslapyje yra objektas window.AgentlabWidget:

Funkcija	Ką daro
`open()`	Atidaro pokalbio langą, pvz. iš jūsų mygtuko „Klauskite DI“.
`close()`	Suskleidžia langą. Pokalbis tęsiasi.
`toggle()`	Atidaro arba suskleidžia.
`mount(options)`	Sukuria įskiepį iš naujo su kitais nustatymais. Vykstantis pokalbis baigiasi.
`unmount()`	Pašalina įskiepį iš puslapio ir baigia pokalbį.

mount priima tuos pačius nustatymus kaip atributai, be data-:

<script src="https://agentlab.lt/widget.js" data-manual async></script>
<script>
  window.addEventListener('load', () => {
    AgentlabWidget.mount({ agent: ['business'], lang: 'lt', position: 'right', color: '#737731' });
    document.querySelector('#ask-ai').addEventListener('click', () => AgentlabWidget.open());
  });
</script>

Reikalavimai svetainei

HTTPS. Naršyklės mikrofoną leidžia tik saugiuose puslapiuose. Per HTTP įskiepis veiks tik raštu.
Content-Security-Policy. Jei svetainė jį siunčia, leiskite agentlab.lt skriptą ir langą: script-src https://agentlab.lt; frame-src https://agentlab.lt. Stiliai įdedami be inline CSS, todėl style-src keisti nereikia.
Permissions-Policy. Jei svetainė riboja mikrofoną, leiskite jį agentlab.lt: microphone=(self "https://agentlab.lt").
Naršyklės. Naujausios Chrome, Safari, Edge ir Firefox versijos, kompiuteryje ir telefone.

Privatumas

Pokalbis vyksta atskirame lange (iframe) iš agentlab.lt. Jūsų svetainė nemato, ką lankytojas sako ar rašo, o įskiepis neskaito jūsų puslapio turinio ir slapukų ir pats jų nekuria. Įskiepio langas užkraunamas tik paspaudus mygtuką.

Pokalbiams galioja agentlab privatumo politika: balsas ir tekstas apdorojami per OpenAI ir Anthropic, pokalbio tekstas saugomas 30 dienų, garso neįrašome. Lankytojas su tuo sutinka pradėdamas pokalbį. Savo privatumo politikoje paminėkite, kad svetainėje yra agentlab DI asistentas.

Ribos

Pokalbiai vyksta kasdien nuo 07:00 iki 24:00 Lietuvos laiku.
Pokalbiai galimi tik iš Europos Sąjungos ir Jungtinės Karalystės.
Pokalbių laikas per valandą yra bendras visiems lankytojams, ir agentlab.lt, ir įskiepiuose. Ratas įskiepyje rodo, kiek jo liko. Rašant laikas skaičiuojamas taip pat kaip kalbant.
Viena žinutė yra iki 500 ženklų.

Jei neveikia

Mygtukas nepasirodo

Patikrinkite naršyklės konsolę. Dažniausia priežastis yra Content-Security-Policy, neleidžianti https://agentlab.lt skripto.

Langas tuščias

Svetainės CSP neleidžia agentlab.lt lango: pridėkite frame-src https://agentlab.lt.

Neveikia mikrofonas

Puslapis turi būti HTTPS, o Permissions-Policy turi leisti mikrofoną agentlab.lt. Lankytojas taip pat turi leisti mikrofoną naršyklėje. Rašyti galima bet kuriuo atveju.

Rašoma, kad pokalbiai negalimi

Tai ribos aukščiau: naktis, šalis arba šios valandos laikas jau išnaudotas. Įskiepis pats vėl leis pradėti, kai bus galima.

Klausimų? Rašykite hello@agentlab.lt.