ReplyRabbitin vianmääritys
Useimmat ReplyRabbit-ongelmat johtuvat yhdestä kolmesta asiasta: puuttuva tai väärä API-avain, suunnitelmasi tason sallimaton palveluntarjoaja tai vanhentunut FreeScout-välimuisti. Käy läpi alla oleva vastaava osio, jossa jokainen ongelma luettelee ensin oireen ja sitten korjauksen.
Luonnosta ei luoda
Oire: avaat keskustelun, mutta AI-luonnosta ei ilmesty eikä mitään näytä tapahtuvan.
Korjaus: avaa postilaatikon ReplyRabbit-asetukset (Postilaatikko > Asetukset > ReplyRabbit) ja varmista, että palveluntarjoaja on valittu ja sen API-avain on asetettu. Ilmaisella tasolla ainoa saatavilla oleva palveluntarjoaja on OpenAI, joten jos valitsit toisen, vaihda takaisin OpenAI:hin tai päivitä. Tarkista sitten, että ReplyRabbit on käytössä postilaatikossa, jossa työskentelet, sillä luonnoksia luodaan vain käytössä oleville postilaatikoille.
Virheellinen API-avain tai palveluntarjoajan virhe
Oire: näet virheen, joka mainitsee virheellisen avaimen, todennuksen epäonnistumisen tai tavoittamattoman palveluntarjoajan.
Korjaus: tarkista avain kirjoitusvirheiden ja ylimääräisten välilyöntien varalta, varmista että se on valitsemasi palveluntarjoajan avain (OpenAI-avain ei toimi Anthropicin kanssa) ja varmista, että avaimella on edelleen saldoa ja käyttöoikeus palveluntarjoajan hallintapaneelissa. Avain, jolla ei ole jäljellä saldoa tai jonka käyttöoikeus on peruutettu, tuottaa saman virheen.
Virheet PHP-päivityksen jälkeen
Oire: palvelimen päivityksen jälkeen (esimerkiksi Ubuntu 26.04:ään PHP 8.5:llä), Testaa yhteys epäonnistuu tai taustatyöt pysähtyvät, ja FreeScout-loki näyttää viestejä, jotka päättyvät is deprecated since 8.5.
Korjaus: pidä ReplyRabbit ja muut moduulisi ajan tasalla kohdasta Hallinnoi > Moduulit, suorita sitten php artisan freescout:clear-cache ja php artisan queue:restart. ReplyRabbit tukee PHP-versioita 8.0–8.5. Katso Korjaa "deprecated since 8.5" -virheet FreeScoutissa löytää, mistä moduulista viesti tulee.
ReplyRabbit-valikko puuttuu
Oire: ReplyRabbit ei näy FreeScoutin valikoissa tai asetuksissa asennuksen jälkeen.
Korjaus: varmista ensin, että moduuli on aktivoitu kohdassa Hallinnoi > Moduulit. Tyhjennä sitten välimuisti FreeScoutin juuresta:
php artisan freescout:clear-cacheJos se puuttuu edelleen, tarkista käyttäjän käyttöoikeudet: käyttäjä, jolla ei ole pääsyä asianomaiseen postilaatikkoon tai ylläpitoasetuksiin, ei näe ReplyRabbit-asetuksia.
Luonnokset pysähtyivät jonkin ajan kuluttua
Oire: luonnokset toimivat aluksi, mutta lakkasivat myöhemmin kuukauden aikana.
Korjaus: Free-taso sallii 10 luonnosta kuukaudessa. Kun saavutat rajan, luonnokset keskeytyvät seuraavaan kuukauteen asti. Pro- ja Team-tasoilla ei ole luonnosrajaa. Kaikilla tasoilla luonnokset keskeytyvät myös, jos postilaatikon Kuukausittainen tunnusbudjetti on käytetty, joten tarkista myös tämä asetus (0 tarkoittaa ei budjettia).
Kehotevälimuistitus ei muuta kuukausittaista token-määrää
Oire: toistuvat luonnokset vaikuttavat kelvollisilta palveluntarjoajan kehotteiden välimuistiin, mutta ReplyRabbitin token-käyttö näyttää silti täyden syöte- ja tulostemäärän.
Korjaus: tämä on odotettua. ReplyRabbit pitää kuukausibudjetit maltillisina ja laskee kokonaistokenit, vaikka tarjoaja laskuttaisi välimuistiin tallennetun syötteen eri tavalla. Tarjoajan välimuistisäästöt riippuvat tarjoajasta, mallista, toistuvista kehoteprefikseistä ja tarjoajan raportoinnista. Anthropic-välimuistin hallintaa käytetään vain kelvolliseen toistuvaan luonnostyöhön, ja se palaa normaaliin generointiin, kun sitä ei tueta.
Linear-tehtäviä ei luoda
Oire: seuraavat toimet havaitaan, mutta Linear-tikettiä ei luoda.
Korjaus: ReplyRabbit-asetuksissa tarkista Linear API -avain, valittu tiimi ja ovatko tiketit odottavassa tilassa vahvistusta varten. Varmista myös, että tasosi sisältää Linearin: manuaalinen Linear-tiketin luonti on Pro-ominaisuus ja automaattinen tiketin luonti on Team-ominaisuus.
Jira-tehtäviä ei luoda
Oire: keskustelu vaatii insinöörityötä, mutta Jira-tehtävää ei luoda.
Korjaus: ReplyRabbit-asetuksissa varmista, että Jira on valittu postilaatikon ongelmanseurannaksi. Tarkista Jira Cloud -sivuston URL, tilin sähköposti, API-token, oletusprojekti ja oletusongelmatyyppi. Varmista myös, että tasosi sisältää ongelmien luonnin: manuaalinen Jira-ongelman luonti on Pro-ominaisuus ja automaattinen ongelman luonti on Team-ominaisuus. Koko asennuspolun osalta katso Jira-integraatio.
Workflow-tageja ei sovelleta
Oire: odottamasi tunnisteet, kuten rr_priority_critical, rr_no_reply_needed, tai rr_linear_issue_created, mutta keskustelussa ei ole ReplyRabbit-tunnisteita.
Korjaus: avaa postilaatikon ReplyRabbit-asetukset ja varmista Ota työnkulun synkronointi käyttöön ja Käytä FreeScout-tunnisteita ovat käytössä Workflow-tagit osio. Jos signaalitagit puuttuvat, varmista AI-signaalit on päällä ja keskustelu on analysoitu. Jos Linear-tunnisteet puuttuvat, varmista, että keskustelulla on ReplyRabbitin luoma Linear-ongelma.
Jos FreeScout Workflows -reseptit eivät käynnisty, varmista ensin, että ReplyRabbit lisää odotetun FreeScout-tunnisteen. Testaa sitten, reagoiko asennettu Workflows-moduuli ohjelmallisiin tunnisteen muutoksiin. ReplyRabbit voi lisätä tunnisteet, mutta Workflows-moduuli määrittää, käynnistyykö resepti kyseisestä tunnisteen muutoksesta.
Tietolähteet: luonnos ei käyttänyt ohjesivujani, tietopankkia, tuotteita tai aiempia vastauksia
Oire: luonnos jätti huomiotta tietoja, joiden tiedät olevan ohjesivuillasi, Knowledge Basessa, tuoteluettelossa tai aiemmissa vastauksissa.
Korjaus: aloita vastauseditorin luonnoksen alla olevasta rivistä. Se listaa, mitä luonnos käytti, esimerkiksi "Sisältyy: 2 ohjesivua, 1 Knowledge Base -artikkeli, 3 aiempaa vastausta tälle asiakkaalle". Napsauta sitä nähdäksesi linkit sekä huomautuksen jokaisesta päälle kytketystä lähteestä, joka ei lisännyt mitään:
- Kytketty päälle, mutta mitään ei ole vielä indeksoitu: indeksointi ei ole valmistunut. Tarkista jonotyöntekijä (katso alla) ja odota indeksoinnin valmistumista.
- Ei hyvää osumaa tälle viestille: lähde on kunnossa, mutta mikään siinä ei vastannut tämän asiakkaan viestiä riittävän tarkasti. Lisää tai paranna sisältöä, joka vastaa tämänkaltaiseen kysymykseen.
- Indeksi yli hakurajan: kun indeksi ylittää 6 000 indeksoitua osiota, vain avainsanahaku toimii, ei merkityspohjainen täsmäytys. Poista tarpeettomat lähteet saadaksesi sen takaisin rajan alle.
- Tilauksesi ei sisällä sitä: että lähde ei ole saatavilla nykyisellä tililläsi.
- Tietopankki-moduulia ei ole asennettu tai aktivoitu: asenna tai aktivoi se kohdassa Hallinnoi > Moduulit.
Asennuksen tilan varoitukset
Postilaatikon asetusten asennustilan banneri varoittaa nyt, kun:
- Jonotyöntekijä ei näytä olevan käynnissä. Indeksointi ja automaattiset luonnokset eivät koskaan valmistu ilman sitä. FreeScout ajaa jonon cron-työn kautta
php artisan schedule:runtaiqueue:workprosessi, joten varmista, että yksi niistä on määritetty. - Tietolähdettä ei ole kytketty päälle. Kytke päälle vähintään yksi kohdassa Mailbox settings, Knowledge sources.
- Lähde on kytketty päälle, mutta sitä ei ole vielä indeksoitu. Anna indeksoinnin valmistua.
Verkkosivustolähteet
- Ryömintä pysähtyy oletuksena 200 sivuun, ja lähde kertoo sen nyt, sekä painikkeen rajan nostamiseksi. Tallenna asetuksesi sen jälkeen ja ryömi uudelleen.
- Sivut, joita ei voi lukea, lasketaan syyn kanssa, esimerkiksi sivusto esti (403), ei löytynyt (404), liikaa pyyntöjä (429), palvelinvirhe, liian suuri tai ei luettavaa tekstiä (usein JavaScriptillä rakennettu sivu). Pyydä palvelintasi päästämään crawler läpi tai osoita lähde sivuille, jotka eivät vaadi JavaScriptiä.
- Erittäin pitkät sivut lyhennetään noin 24 000 merkkiin. Kun semanttinen sovitus on päällä, lähde näyttää, kuinka monta sivua lyhennettiin. Jaa pitkät sivut, jos tarvitsemasi osa on lähellä loppua.
Ääriviivat ja merkitykseen perustuva täsmäytys
- Outlinen synkronointi pysähtyy 1 000 asiakirjaan. Sen yli meneviä asiakirjoja ei synkronoida.
- Merkitykseen perustuva (semanttinen) yhdistäminen vaatii upotuspalveluntarjoajan. Jotkin upotusmallit eivät ole vielä kalibroituja pelkkiin merkitysosumiin ja näyttävät varoituksen, joten vaihda toiseen upotusmalliin, jos näet sen.
Vielä jumissa?