Egenverk Babbla · Dokumentation
Referens
Babbla är i tidig utveckling (0.x). Namnen nedan kan ändras före 1.0.
Konstanter i wp-config.php
En konstant går före fältet på inställningssidan och håller nyckeln utanför databasen. Fältet visar då "Satt i wp-config.php." och går inte att ändra. Äldre installationer kan ha BBL_ANTHROPIC_KEY eller BBL_OPENAI_KEY; de fungerar fortfarande, men EGVB_-namnet vinner om båda finns.
| Konstant | Värde |
|---|---|
EGVB_ANTHROPIC_KEY | API-nyckel för Anthropic |
EGVB_OPENAI_KEY | API-nyckel för OpenAI |
EGVB_GOOGLE_SERVICE_ACCOUNT | Tjänstekontots JSON-nyckel, eller en absolut sökväg till JSON-filen. Fältet för Google-nyckeln stängs av. |
define( 'EGVB_ANTHROPIC_KEY', '...' );
define( 'EGVB_OPENAI_KEY', '...' );
define( 'EGVB_GOOGLE_SERVICE_ACCOUNT', '/absolut/sokvag/nyckel.json' );
Behörigheter
| Behörighet | Ger |
|---|---|
egvb_chat | Chattbehörighet |
egvb_manage | Babbla-administration: inställningar, användning och diagnostik |
Behörigheterna ges via fliken Behörigheter. De ger aldrig någon WordPress- eller WooCommerce-behörighet.
Filter
| Filter | Gör | Standard |
|---|---|---|
egvb_capability | Behörighet som också ger chattbehörighet | egvb_chat |
egvb_admin_capability | Behörighet som också ger Babbla-administration | egvb_manage |
egvb_tool_capability | Behörighet som assistentens butiksverktyg kräver | manage_woocommerce |
egvb_rate_limit | Antal meddelanden en användare får skicka per minut | 30 |
egvb_upload_rate_limit | Antal uppladdningar per tio minuter och användare | 30 |
egvb_agent_concurrency | Antal frågor till assistenten som besvaras samtidigt, minst 1 | 2 |
egvb_poll_interval | Minsta antal sekunder en stängd chatt väntar mellan sina schemalagda anrop, 0–600; ett sätt för en hårt belastad webbplats att glesa ut anropen | 0 |
egvb_files_dir | Mappen där bifogade filer sparas | Se Data och integritet |
egvb_agent_tools | Låter ett annat tillägg lägga till verktyg för assistenten | |
egvb_integrations | Låter tillägget deklarera sin integration: namn, version, verktyg och vad de läser | |
egvb_redacted_keys | Fler fältnamn att ta bort ur verktygsresultat | |
egvb_tool_status_label | Texten chatten visar medan ett verktyg körs | |
egvb_anthropic_request, egvb_openai_request | Innehållet i anropet till respektive leverantör, precis innan det skickas |
Verktyg som läggs till via egvb_agent_tools används först när en administratör slagit på integrationen under Inställningar. Verktyg utan deklaration grupperas som verktyg från ett odeklarerat tillägg och går också att stänga av.
Ett verktygs callback får argumenten och den frågande användarens id, fn( array $args, int $user_id ). Ett verktyg som läser användarens egna data ska använda det id:t, eftersom jobbet körs i bakgrunden utan inloggad användare.
WP-CLI
| Kommando | Gör |
|---|---|
wp egvb job list | Listar assistentens 20 senaste jobb, valfritt filtrerade med --status |
wp egvb job run med ett jobb-id | Kör ett jobb direkt. Gränsen för samtidiga frågor gäller inte här. |
wp egvb lean on, off, status | Slår på, stänger av eller visar lätta chattläsningar |
REST API
Chatten använder REST-namnrymden babbla/v1 med WordPress inloggningskaka och nonce. Alla routes kräver chattbehörighet och följer samma regler för vem som ser vad som chatten.