Egenverk Babbla · Dokumentation
Assistenten
Assistenten svarar på frågor om butiken, till exempel "Hur mycket sålde vi i går?" eller "Vilken produkt sålde bäst i september?". Den använder en fast uppsättning verktyg som bara läser, kör aldrig fri SQL och kan inte ändra något.
Var assistenten svarar
- I din assistentkonversation svarar den på varje meddelande. Konversationen är bara din.
- I ett rum svarar den en gång när någon nämner den med
@, antingen via listan, där den står först med texten "Svarar en gång i det här rummet", eller genom att skriva@följt av assistentens namn. Svaret syns för alla i rummet och kan innehålla butiksuppgifter som frågeställaren har tillgång till. Chatten visar en varning om det. - I direktmeddelanden svarar den aldrig.
Assistenten svarar på webbplatsens språk och skriver i Markdown, som chatten visar som rubriker, listor och fetstil. Medan den arbetar visar chatten vad den gör, till exempel "Söker i chatten…".
I din assistentkonversation ser den bilderna i ditt senaste meddelande, högst tre, nedskalade till 1 568 px. Äldre bilder och andra filer når den bara som en rad med filnamnet.
Verktygen
Verktygen kör med frågeställarens egna rättigheter. Verktygen för chatten och butikens sidor kräver chattbehörighet; övriga verktyg kräver att användaren får hantera WooCommerce.
| Verktyg | Läser |
|---|---|
shop_info | Grunduppgifter om butiken |
sales_summary | Försäljning för en period |
top_products | Mest sålda produkter |
analytics_report | Försäljning och återbetalningar per dag, vecka, månad, produkt, kategori, land, betalsätt eller kund, och antal kunder, nya och återkommande |
order_lookup | En order i taget, med upp till tio återbetalningar, de tio senaste noteringarna och de orderfält du tillåter |
calculate | Räknar ut tal med ett eget, säkert uttrycksverktyg |
list_conversations, search_chat, read_conversation | Chattkonversationer som frågeställaren redan kan öppna; sökningen gäller de senaste 90 dagarna om inget annat anges |
list_documents, read_document | Butikens villkor, integritetspolicy och sidor du valt |
ga4_report, search_console_report, merchant_product_issues | Google-källorna, om du slagit på dem |
Försäljningsverktygen läser WooCommerce Analytics och räknar bara betalda ordrar. En period får vara högst 400 dagar. Assistenten är instruerad att räkna med calculate i stället för att räkna själv; det är en instruktion, inte något koden tvingar fram.
En fråga får använda verktyg i högst åtta omgångar och ska vara klar inom en och en halv minut. Högst två frågor besvaras samtidigt på hela webbplatsen; en tredje väntar i kö och chatten visar att assistenten är upptagen.
Inställningar
Fliken Inställningar under Inställningar → Babbla är en sida med korten Översikt, Leverantör, Beteende, Google, Gränser och kostnad och Data. Panelen Hjälp uppe till höger har flikarna API-nycklar, Modeller, Kostnad och gränser och Vad som skickas.
Översikt
Visar om en nyckel finns och varifrån den kommer, vilken modell som är angiven och dagsbudgeten. Under Kom igång finns fyra steg från tom installation till fungerande assistent; de är utfällda så länge ingen nyckel är sparad.
Leverantör
| Inställning | Standard | Vad den gör |
|---|---|---|
| Leverantör | Anthropic | Anthropic eller OpenAI. Bara vald leverantörs fält visas. |
| API-nyckel för Anthropic / OpenAI | Tom | Din egen nyckel. Efter sparning står bara de fyra sista tecknen, till exempel "Sparad (…abcd).". Bocka i Ta bort nyckeln för att ta bort den. En konstant i wp-config.php går före fältet, som då står "Satt i wp-config.php." och inte går att ändra. |
| Modell för Anthropic | Sonnet 5 | Valfritt modell-id som leverantören dokumenterar, så en modell som släpps senare fungerar också. |
| Modell för OpenAI | gpt-5.6-terra | Samma sak för OpenAI. |
Spara allt och testa anslutningen sparar formuläret och ställer en testfråga utan verktyg till leverantören. Du ser vilken modell som svarade och hur lång tid det tog, eller leverantörens felmeddelande ordagrant. Att testa en leverantör byter inte den som används.
Beteende
| Inställning | Standard | Vad den gör |
|---|---|---|
| Assistentens namn | Agent | Högst 40 tecken. Visas i chatten och används när någon skriver @ och namnet. Lämnas det tomt används Agent. |
| Systemprompt | Medföljande text | Högst 4 000 tecken. Den medföljande texten ber assistenten svara på webbplatsens språk. Tömmer du fältet och sparar återgår den till standardtexten. En prompt du ändrat rörs aldrig vid uppdateringar. |
| Behörighet för assistenten | Tom | Vilka som får prata med assistenten. Tomt betyder samma som chattbehörighet. Fyll i namnet på en WordPress-behörighet, gemener och understreck. |
| Flytande bubbla | På | Sidans standard för bubblan, se Chatten. |
| Bubbelstorlek | Normal | Liten, Normal eller Stor. |
| Läsbara sidor | Inga | Publicerade sidor som assistenten får citera, till exempel frakt, retur och garanti. Villkoren och integritetspolicyn går alltid att läsa. Håll ned Ctrl (Cmd på Mac) för att välja flera; högst 20 sparas. |
| Läsbara orderfält | Inga | En metadatanyckel per rad, högst 30. Se nedan. |
| Integrationer | Alla av | En brytare per tillägg som erbjuder assistenten egna verktyg. |
Läsbara sidor: en sida som avpubliceras eller lösenordsskyddas slutar genast gå att läsa. Kortkoder och dynamiska block körs inte, så text som bara finns i ett dynamiskt block syns inte för assistenten.
Läsbara orderfält: bara de nycklarna läses, och bara för den order som frågan gäller. En nyckel får bestå av bokstäver, siffror och tecknen _ . : -, högst 64 tecken; andra rader tas bort när du sparar. E-postadresser och telefonnummer maskeras. Uppslaget tar också med de senaste ordernoteringarna och orsakerna till återbetalningar, som är fritext och kan innehålla kundnamn eller adresser; de skickas till AI-leverantören. Lämna fältet tomt för att inte dela någon metadata.
Integrationer: varje integration visar vad den lägger till, vilka verktyg den har och vad den skickar. En ny integration är av tills en administratör slår på den. Verktyg som ett tillägg lagt till utan att anmäla sig samlas under "Verktyg från ett plugin som inte anmält sig".
Gränser och kostnad
| Inställning | Standard | Vad den gör |
|---|---|---|
| Frekvensgräns (frågor/min/användare) | 10 | 1–60 frågor till assistenten per användare och minut. Den som når gränsen får svaret "För många frågor till assistenten. Vänta en minut." |
| Dagsbudget för tokens (0 = ingen budget) | 500 000 | Summan av tokens in och ut för hela webbplatsen. När den passeras svarar assistenten "Dagsbudgeten för assistenten är förbrukad." resten av dygnet räknat i UTC. 0 betyder ingen budget. Högst 10 000 000. |
| Verktygscachens TTL (sekunder) | 300 | Hur länge, 0–3 600 s, ett verktygsresultat återanvänds innan butiken frågas igen. Högre blir billigare men mindre färskt. Orderuppslag, beräkningar och läsning av chatt och sidor cachas aldrig. |
| Pris in per 1M tokens | 0 | Vad leverantören tar per miljon tokens, i butikens valuta (valutakoden står i etiketten). Upp till fyra decimaler, kommatecken går bra. |
| Pris ut per 1M tokens | 0 | Samma för tokens ut. Med båda på 0 visas ingen kostnad någonstans. Leverantörerna anger oftast sina priser i US-dollar; räkna om innan du sparar. |
Data
| Inställning | Standard | Vad den gör |
|---|---|---|
| Diagnostiklogg | Bara fel | Av, Bara fel, Fel och varningar, Allt assistenten gör eller Felsökning (utförlig). Se Felsökning. |
| Rensa data vid avinstallation | Av | Raderar Babblas data när tillägget tas bort. Se Data och integritet. |
Spara
När något har ändrats visas raden Osparade ändringar längst ned med knappen Spara ändringar, och "Inställningarna sparades." bekräftar. Enter i ett textfält sparar också, utan att köra anslutningstestet.
Kortet Google låter assistenten svara på frågor om trafik i Google Analytics 4, sökningar i Search Console och produktproblem i Merchant Center.
- Skapa ett tjänstekonto i Google Cloud och ladda ner dess JSON-nyckel.
- Aktivera Analytics Data API, Search Console API och Merchant API för projektet.
- Lägg till tjänstekontots e-postadress som läsare i GA4 (Admin, Property access), som användare i Search Console (Settings, Users and permissions) och som användare i Merchant Center (Settings, People and access).
- Klistra in hela nyckelfilen i Tjänstkontots nyckel och fyll i de källor du vill använda:
- GA4-egenskapens id: bara siffror, inte mätnings-id:t som börjar med G-.
- Search Console-egenskap:
sc-domain:example.comför en domänegenskap, eller adressen med avslutande/för en egenskap med URL-prefix. - Merchant Center-kontots id: bara siffror.
- Spara och klicka på Testa anslutningen. Testet använder de sparade inställningarna, hämtar en token och gör ett litet anrop per källa. Du ser OK eller Googles fel för var och en.
- Slå på integrationen Google (Analytics, Search Console, Merchant Center) under Integrationer i kortet Beteende. Tills dess används inte verktygen.
Assistenten får bara verktyg för de källor du fyllt i. Googles resultat cachas i fem minuter.
Nyckeln går bara att skriva: efter sparning står bara "Nyckel sparad för" och tjänstekontots e-postadress. För att byta nyckel klistrar du in en ny; Ta bort nyckeln tar bort den. På en produktionsmiljö kan nyckeln i stället ligga i wp-config.php, se Referens.
Användning
Fliken Användning visar hur assistenten används. Välj Period: Senaste dygnet, Senaste 7 dagarna eller Senaste 30 dagarna, och klicka på Visa.
- Frågor, Misslyckade, Tokens in och Tokens ut, och en uppskattad Kostnad när priser är angivna.
- Per användare: frågor, misslyckade, tokens in och ut, snittsvarstid i sekunder och kostnad.
- Tokens per dag (senaste 30 dagarna): ett diagram mot dagsbudgeten. En dag över budgeten är röd.
- Senaste jobben: de 50 senaste frågorna med tid, användare, status, tokens och fel.
Fliken visar bara uppgifter om frågorna, aldrig meddelandetext eller kanalnamn.