Einen Assistenten mit Dateien rechnen lassen¶

Ein Assistent kann Fragen zu einer CSV- oder Excel-Datei beantworten, indem er Code darüber ausführt: Summen, Anzahlen, Vergleiche, ein Diagramm oder eine bereinigte Datei zum Herunterladen. Er tut das auf einem eigenen Computer, der bei jeder Antwort neu beginnt, kein Internet hat und nach der Antwort verschwindet. Dafür braucht der Assistent drei Tools. Diese Seite zeigt, wo Sie sie finden und wie Sie sie einem Assistenten geben, und was Sie sehen, wenn Ihre Organisation keinen Code ausführen kann. Was Mitglieder im Chat tun, steht unter Eine Tabelle auswerten lassen.

Fragen zu einer Tabelle gehören zu diesen Tools, nicht zu einem Datenspeicher: Ein Datenspeicher hält Datensätze, die eine Anwendung schreibt und liest, keine Datei, zu der jemand eine Frage hat.

Die drei Tools¶

Tool	Was es tut
Code ausführen	Führt einen Befehl auf dem Computer des Assistenten aus, etwa ein Python-Skript über eine im Chat gesendete Datei, und liest zurück, was es ausgegeben hat.
Eine Datei auf dem Computer schreiben	Schreibt eine Textdatei auf den Computer, etwa ein Skript, das der Assistent danach ausführt.
Eine Datei vom Computer lesen oder exportieren	Liest eine Datei vom Computer oder gibt sie in der Antwort zum Herunterladen mit, etwa ein Diagramm oder eine bereinigte Tabelle.

Geben Sie einem Assistenten alle drei. Mit nur Code ausführen rechnet er zwar, und Diagramme und Tabellen stehen im Text seiner Antwort, aber Bilder und Dateien, die der Code erstellt, gelangen nicht in die Antwort.

Wer was darf¶

Die Tools im Maschinenraum sehen kann, wer die Toolbox ändern darf: die Administratoren der Organisation und eine eigene Rolle mit dem Recht, die Toolbox zu ändern.
Die Tools einem Assistenten geben kann, wer diesen Assistenten ändern darf.
Sie nutzen kann jeder, der mit dem Assistenten chatten darf. Eine Regel, die jemandem diese Tools verbietet, gilt auch, wenn diese Person mit dem Assistenten chattet.

Wo Sie die Tools finden¶

Die drei Tools sind nur für Assistenten: Eine Person kann sie nicht selbst in der AI Toolbox nutzen. Sie gehören zur Toolbox jeder Organisation, ohne dass jemand sie zuerst einschalten muss. Sie finden sie auf dem Tab Tools jedes Assistenten und im Maschinenraum als Nur Assistenten; wählen Sie unter Für wen Nur Assistenten, um nur diese Tools zu sehen. Sie haben keinen Schalter Auch für Personen, weil eine Person sie nicht nutzen kann.

Sie können sie im Maschinenraum in eine Gruppe legen, um sie beisammenzuhalten; auf dem Tab Tools eines Assistenten aktivieren Sie jedes einzeln.

Die Tools einem Assistenten geben¶

Öffnen Sie die Einstellungen des Assistenten und wählen Sie den Tab Tools.
Suchen Sie nach Computer oder Code und wählen Sie Aktivieren bei Code ausführen, Eine Datei auf dem Computer schreiben und Eine Datei vom Computer lesen oder exportieren. Jede Wahl speichert sofort eine neue Version des Assistenten.
Prüfen Sie auf dem Tab Einstellungen, dass Anhänge zu Chat-Nachrichten hinzufügen eingeschaltet ist; sonst kann niemand dem Assistenten Dateien senden.

Ein virtueller Mitarbeiter des Assistenten kann dieselben Tools für die Dateien nutzen, die sein Run mitbekommt.

Zwei Hinweise auf dem Tab Tools¶

Über den Tools kann einer dieser Hinweise stehen. Speichern geht weiterhin; sie sagen nur, was der Assistent dann nicht kann.

Der Assistent kann Code ausführen, aber keine Dateien zurückgeben. Der Assistent hat Code ausführen ohne Eine Datei vom Computer lesen oder exportieren. Wählen Sie die Schaltfläche im Hinweis, um dieses Tool zu aktivieren.
Niemand kann diesem Assistenten Dateien senden. Anhänge zu Chat-Nachrichten hinzufügen ist ausgeschaltet. Wählen Sie Zu den Einstellungen und schalten Sie es ein, es sei denn, der Assistent soll nur mit dem rechnen, was im Gespräch steht.

Wenn die Tools nicht verfügbar sind¶

Kann Ihre Organisation keinen Code ausführen, stehen die drei Tools ausgegraut auf dem Tab Tools, mit nicht verfügbar statt Aktivieren, und einer Zeile, die sagt, warum:

Zeile	Was sie bedeutet	Wen Sie fragen
Nicht verfügbar: Ihre Organisation kann keinen Code ausführen.	Computer sind für Ihre Organisation nicht erlaubt.	Die Administratoren der übergeordneten Organisation, oder Artific, wenn es keine gibt.
Nicht verfügbar: Diese Installation von Artific Core betreibt keine Computer.	Die Installation, auf der OS für Ihre Organisation läuft, hat keine Computer.	Artific.

Derselbe Grund steht unter Organisationseinstellungen, im Hinweis, dass Ihre Organisation keine Word-, Excel- oder PowerPoint-Dateien erstellt, mit dem Zeitpunkt, zu dem OS es zuletzt versucht hat. OS prüft jeden Tag erneut. Sind Computer erlaubt, können Sie die Tools sofort aktivieren; es kann bis zu etwa einem Tag dauern, bis sie im Chat funktionieren.

Verliert Ihre Organisation die Computer, während ein Assistent die Tools schon hat, bleiben sie aktiviert, und auf der Karte steht Funktioniert gerade nicht: Ihre Organisation kann keinen Code mehr ausführen. Im Chat steht, warum. Deaktivieren funktioniert dann weiterhin. Wer ein Tool zu aktivieren versucht, während das nicht geht, erhält Code ausführen ist nicht verfügbar: Ihre Organisation kann keinen Code ausführen.

Was es kostet¶

Eine Antwort, in der der Assistent Code ausgeführt hat, verbraucht neben den Tokens des Modells auch Rechenzeit: die Sekunden, die sein Computer lief. Diese Zeit zählt zum Verbrauch Ihrer Organisation und zu ihrem Monatsbudget, wie jeder Verbrauch. Eine Antwort ohne Code verbraucht keine Rechenzeit. OS zeigt die Rechenzeit noch nicht an: weder im Chat noch auf einer eigenen Seite.

Was aufgezeichnet wird¶

Das Aktivieren steht im Prüfprotokoll Ihrer Organisation, als Änderung am Assistenten, mit der Version, die es geschrieben hat.
Jeden Computer zeichnet Artific Core auf: wann er erstellt wurde und verschwand, wie lange er lief, und für jeden Schritt, welche Art Schritt es war, wie lange er dauerte und mit welchem Exit-Code. Die Befehle selbst, ihre Ausgabe und Dateinamen stehen dort nicht; sie stehen nur im Chat und auf dem Tab Sitzungsprotokolle des Assistenten. OS zeichnet pro Antwort nichts auf, damit nichts doppelt steht.

Daten und Netzwerk¶

Der Computer hat kein Internet, und OS schaltet es nie ein. Code, den das Modell schreibt, kann eine Datei also nirgendwohin senden, was auch immer in einer Zelle steht. Eine Datei aus dem Chat wird auf einen Computer in der Region kopiert, in der Ihre Organisation Computer erhält; erlaubt Ihre Richtlinie diese Region nicht, wird jeder Schritt abgelehnt, und der Chat sagt das.

Über die API¶

GET /api/v1/organisations/{id}/assistants/tool-choices liefert bei jedem der drei Tools unavailable: null, not_permitted oder no_computers.
Ein Speichern des Assistenten, das eines der drei hinzufügt, während Ihre Organisation keinen Code ausführen kann, erhält 422; das Feld type des Fehlers ist der Grund.
GET /api/v1/organisations/{id}/toolbox/elements?offered_to=agents liefert die drei Tools mit, mit fixed: false, für alle, die die Toolbox ändern dürfen.