Een assistent laten rekenen met bestanden¶

Een assistent kan vragen over een CSV- of Excel-bestand beantwoorden door er code over uit te voeren: totalen, aantallen, vergelijkingen, een grafiek of een opgeschoond bestand om te downloaden. Hij doet dat op een eigen computer, die bij elk antwoord nieuw begint, geen internet heeft en na het antwoord verdwijnt. Daarvoor heeft de assistent drie tools nodig. Deze pagina zegt waar je ze vindt en hoe je ze aan een assistent geeft, en wat je ziet als je organisatie geen code kan uitvoeren. Wat leden in de chat doen, staat in Een spreadsheet laten analyseren.

Vragen over een spreadsheet horen bij deze tools, niet bij een gegevensopslag: een gegevensopslag houdt gegevens bij die een toepassing schrijft en leest, niet een bestand waar iemand een vraag over heeft.

De drie tools¶

Geef een assistent alle drie. Met alleen Code uitvoeren rekent hij wel, en staan grafieken en tabellen in de tekst van zijn antwoord, maar komen afbeeldingen en bestanden die de code maakt niet in het antwoord.

Wie wat mag¶

• De tools in de Machinekamer zien kan wie de toolbox mag wijzigen: beheerders van de organisatie en een eigen rol met het recht om de toolbox te wijzigen.
• De tools aan een assistent geven kan wie die assistent mag wijzigen.
• Ze gebruiken kan iedereen die met de assistent mag chatten. Een regel die iemand deze tools verbiedt, geldt ook als die persoon met de assistent chat.

Waar je de tools vindt¶

De drie tools zijn alleen voor assistenten: een persoon kan ze niet zelf in de AI Toolbox gebruiken. Ze horen bij de toolbox van elke organisatie, zonder dat iemand ze eerst hoeft aan te zetten. Je vindt ze op het tabblad Tools van elke assistent, en in de Machinekamer als Alleen assistenten; kies onder Voor wie Alleen assistenten om alleen die tools te zien. Ze hebben geen schakelaar Ook voor mensen, omdat een persoon ze niet kan gebruiken.

Je kunt ze in de Machinekamer in een groep zetten om ze bij elkaar te houden; op het tabblad Tools van een assistent activeer je ze elk apart.

De tools aan een assistent geven¶

1. Open de instellingen van de assistent en kies het tabblad Tools.
2. Zoek op computer of code en kies Activeren bij Code uitvoeren, Een bestand op de computer schrijven en Een bestand van de computer lezen of exporteren. Elke keuze slaat meteen een nieuwe versie van de assistent op.
3. Controleer op het tabblad Instellingen dat Bijlagen toevoegen aan chatberichten aan staat, anders kunnen mensen de assistent geen bestanden sturen.

Een virtuele medewerker van de assistent kan dezelfde tools gebruiken voor de bestanden die zijn run meekrijgt.

Twee meldingen op het tabblad Tools¶

Boven de tools kan een van deze meldingen staan. Opslaan blijft mogelijk; ze zeggen alleen wat de assistent dan niet kan.

• De assistent kan code uitvoeren, maar geen bestanden teruggeven. De assistent heeft Code uitvoeren zonder Een bestand van de computer lezen of exporteren. Kies de knop in de melding om die tool te activeren.
• Mensen kunnen deze assistent geen bestanden sturen. Bijlagen toevoegen aan chatberichten staat uit. Kies Naar Instellingen en zet het aan, tenzij de assistent alleen hoeft te rekenen met wat in het gesprek staat.

Als de tools niet beschikbaar zijn¶

Kan je organisatie geen code uitvoeren, dan staan de drie tools grijs op het tabblad Tools, met niet beschikbaar in plaats van Activeren, en een regel die zegt waarom:

Dezelfde reden staat op Organisatie-instellingen, in de melding dat je organisatie geen Word-, Excel- of PowerPoint-bestanden maakt, met wanneer OS het laatst probeerde. OS kijkt elke dag opnieuw. Zijn computers toegestaan, dan kun je de tools meteen activeren; het kan tot ongeveer een dag duren voordat ze in de chat werken.

Verliest je organisatie de computers terwijl een assistent de tools al heeft, dan blijven ze geactiveerd en staat er Werkt nu niet: je organisatie kan geen code meer uitvoeren. In de chat ziet men waarom. Deactiveren werkt dan nog. Wie een tool probeert te activeren terwijl dat niet kan, krijgt Code uitvoeren is niet beschikbaar: je organisatie kan geen code uitvoeren.

Wat het kost¶

Een antwoord waarin de assistent code uitvoerde, gebruikt naast de tokens van het model ook computertijd: de seconden dat zijn computer draaide. Die tijd telt mee voor het verbruik van je organisatie en haar maandbudget, zoals elk verbruik. Een antwoord zonder code gebruikt geen computertijd. OS toont de computertijd nog niet: niet in de chat en niet op een eigen pagina.

Wat er wordt vastgelegd¶

• Het activeren staat in het logboek van je organisatie, als een wijziging aan de assistent, met de versie die het schreef.
• Elke computer legt Artific Core vast: wanneer hij werd gemaakt en verdween, hoe lang hij draaide, en per stap wat voor stap het was, hoe lang hij duurde en met welke exitcode. De opdrachten zelf, hun uitvoer en bestandsnamen staan daar niet in; die staan alleen in de chat en in de Sessie logs van de assistent. OS legt per antwoord niets vast, zodat niets dubbel staat.

Gegevens en netwerk¶

De computer heeft geen internet, en OS zet dat nooit aan. Code die het model schrijft kan een bestand dus nergens naartoe sturen, wat er ook in een cel staat. Een bestand uit de chat wordt gekopieerd naar een computer in de regio waar je organisatie computers krijgt; staat je beleid die regio niet toe, dan weigert elke stap en zegt de chat dat.

Via de API¶

• GET /api/v1/organisations/{id}/assistants/tool-choices geeft bij elk van de drie tools unavailable: null, not_permitted of no_computers.
• Een opslag van de assistent die een van de drie toevoegt terwijl je organisatie geen code kan uitvoeren, krijgt 422; het veld type van de fout is de reden.
• GET /api/v1/organisations/{id}/toolbox/elements?offered_to=agents geeft de drie tools mee, met fixed: false, aan wie de toolbox mag wijzigen.