KI-Tools in Server verwenden
Richten Sie KI-Tools in Server 2026.1 mit einem Dienstprinzipal ein und führen Sie sie aus. Verwenden Sie diesen Leitfaden, um ein Dienstprinzipal in Alteryx One zu erstellen und Ihre KI-Tools zu verbinden. Weitere Informationen zu Dienstprinzipalen in Alteryx One finden Sie auf der Seite Dienstprinzipal.
Anforderungen
Ein Arbeitsbereich-Administrator muss Dienstprinzipale erstellen und verwalten.
Um KI-Tools verwenden zu können, müssen Sie Vollbenutzer sein oder eine benutzerdefinierte Rolle mit der Gen AI-Tools-Funktion haben.
AMP muss für Server aktiviert sein. Ein Administrator muss AMP über die Systemeinstellungen aktivieren. Weitere Informationen zu AMP und Server finden Sie unter AMP Engine.
Erste Einrichtung
Führen Sie diese Schritte einmal durch, damit KI-Tools eine Verbindung zu Ihrer LLM-Verbindung in Alteryx One herstellen können.
Dienstprinzipal in Alteryx One erstellen
Anmerkung
Sie müssen ein Arbeitsbereich-Administrator sein, um diesen Schritt abzuschließen.
Öffnen Sie im Alteryx One Ihr Profilmenü.
Gehen Sie zu Arbeitsbereich-Admin > Dienstprinzipale.
Wählen Sie Neu aus.
Geben Sie Werte ein:
Name: Geben Sie einen eindeutigen Namen ein.
Beschreibung: Geben Sie eine Beschreibung ein.
Lebensdauer für Geheimnis (Tage): Geben Sie einen Wert zwischen 1 und 365 ein.
Wählen Sie unter Rollen eine Vollbenutzer-Rolle oder eine benutzerdefinierte Rolle mit der Gen AI-Tools-Funktion aus.
Wählen Sie Erstellen aus.
Nach dem Erstellen des Dienstprinzipals:
Kopieren Sie die Client-ID.
Kopieren Sie das Client-Geheimnis.
Bewahren Sie diese Werte sicher auf.
LLM-Verbindung in Alteryx One freigeben
Gehen Sie zu Daten.
Wählen Sie Connections (Verbindungen) aus.
Finden Sie die LLM-Verbindung.
Wählen Sie das Drei-Punkte-Menü und dann Freigeben aus.
Wählen Sie unter Benutzer oder Dienstprinzipale auswählen das Dienstprinzipal aus.
Wählen Sie im Rollenauswahlmenü Editor (oder die erforderliche Rolle) aus.
Stellen Sie die Anmeldedaten auf Anmeldedaten freigeben ein.
Wählen Sie Freigeben aus.
Eingabeaufforderung- oder LLM-Überschreibung-Tool in Designer konfigurieren
Wählen Sie die Dienstprinzipalverbindung aus.
Öffnen Sie Ihren Workflow in Designer.
Wählen Sie das Eingabeaufforderung-Tool aus.
Wählen Sie im Abschnitt Verbindungsoptionen die Option Dienstprinzipal (für Server) aus.
Eine Verbindung erstellen
Wählen Sie Neue Verbindung erstellen aus.
Wählen Sie im Data Connection Manager (DCM) die Option + Neu aus.
Wählen Sie im Auswahlmenü Technologie auswählen die Option Alteryx One OAuth-Anwendung aus.
Anmeldedaten eingeben
Anmerkung
Um diese Anmeldedaten einzugeben, müssen Sie Zugriff auf die Client-ID und das Client-Geheimnis des Dienstprinzipals haben. Wenn Sie das Dienstprinzipal nicht erstellt haben, bitten Sie einen Arbeitsbereich-Administrator um Angabe dieser Werte.
Geben Sie unter Datenquellenname einen Namen ein.
Geben Sie unter Client-ID die Client-ID des Dienstprinzipals ein.
Geben Sie unter Client-Geheimnis das Client-Geheimnis des Dienstprinzipals ein.
Wählen Sie Speichern aus.
Workflow in Server veröffentlichen
Nachdem Sie die Dienstprinzipalverbindung konfiguriert haben, veröffentlichen Sie Ihren Workflow in Server.
Der Workflow wird in Server unter Verwendung des Dienstprinzipals ausgeführt. KI-Tools nutzen die freigegebene LLM-Verbindung und werden ohne Benutzerauthentifizierung ausgeführt.
Dienstprinzipalgeheimnisse rotieren
Client-Geheimnisse für ein Dienstprinzipal laufen nach einem Jahr ab. Wenn das Geheimnis abläuft, aktualisieren Sie die Dienstprinzipalverbindung mit einem neuen Client-Geheimnis im Data Connection Manager. Weitere Informationen zur automatischen Rotation finden Sie auf der Seite Dienstprinzipale.
Anmerkung
Wenn Sie den Dienstprinzipal nicht erstellt haben, bitten Sie einen Arbeitsbereich-Administrator, ein neues Client-Geheimnis zu erstellen.
Neues Client-Geheimnis generieren
Gehen Sie von Alteryx One zu Arbeitsbereich-Administrator > Dienstprinzipale.
Wählen Sie auf der Seite „Dienstprinzipale“ ein Dienstprinzipal aus, um die zugehörige Detailseite zu öffnen.
Wählen Sie Geheimnis generieren aus.
Kopieren und bewahren Sie das neue Geheimnis sicher auf.
Verbindung in Designer Desktop aktualisieren
Wählen Sie in Designer DesktopDatei > Verbindungen verwalten aus.
Wählen Sie auf der Seite „Verbindungen“ die Dienstprinzipalverbindung aus.
Wählen Sie Bearbeiten aus.
Geben Sie das Client-Geheimnis ein und wählen Sie dann Speichern aus.
Überprüfen Sie die Verbindung, um sicherzustellen, dass sie wie erwartet funktioniert, bevor Sie sie in Workflows verwenden.