KI-Tools in Server verwenden
Richten Sie KI-Tools auf -Server mit einem Dienstprinzipal ein und führen Sie sie aus. Verwenden Sie diesen Leitfaden, um einen Dienstprinzipal in Alteryx One zu erstellen und Ihre KI-Tools zu verbinden. Weitere Informationen zu Dienstprinzipalen in Alteryx One finden Sie auf der Seite Dienstprinzipale.
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:e Administrator:in muss AMP über die Systemeinstellungen aktivieren. Weitere Informationen zu AMP und Server finden Sie unter Best Practices für 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 in 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 des Geheimnisses (Tage): Geben Sie einen Wert zwischen 1 und 365 ein.
Wählen Sie unter Rollen eine Vollbenutzer-Rolle oder eine benutzerdefinierte Rolle mit der Funktion für Gen-AI-Tools aus.
Wählen Sie Erstellen aus.
Nach dem Erstellen des Dienstprinzipals:
Kopieren Sie die Client-ID.
Kopieren Sie das Client Secret.
Bewahren Sie diese Werte sicher auf.
Geben Sie die LLM-Verbindung in Alteryx One frei
Gehen Sie zu Daten.
Wählen Sie 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 den Dienstprinzipal aus.
Wählen Sie im Rollenauswahlmenü Editor (oder die erforderliche Rolle) aus.
Stellen Sie sicher, dass Sie die Anmeldedatenfreigabe von Anmeldedaten nicht freigeben in Anmeldedaten freigeben ändern.
Wählen Sie Teilen aus.
Eingabeaufforderung- oder LLM-Überschreibung-Tool in Designer konfigurieren
Wählen Sie die Dienstprinzipalverbindung aus.
Öffnen Sie in Designer Ihren Workflow.
Wählen Sie das Prompt-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) + 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 Secret des Dienstprinzipals haben. Wenn Sie den Dienstprinzipal nicht erstellt haben, bitten Sie eine:n Arbeitsbereich-Administrator darum, Ihnen diese Werte bereitzustellen.
Geben Sie unter Name der Datenquelle einen Namen ein.
Geben Sie unter Client-ID die Client-ID des Dienstprinzipals ein.
Geben Sie unter Clientgeheimnis das Clientgeheimnis 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 läuft auf Server mit dem Dienstprinzipal. AI-Tools verwenden die gemeinsame LLM-Verbindung und laufen ohne Benutzerauthentifizierung.
Dienstprinzipalgeheimnisse wechseln
Clientgeheimnisse für einen Dienstprinzipal laufen nach einem Jahr ab. Wenn das Geheimnis abläuft, aktualisieren Sie die Dienstprinzipalverbindung im Datenverbindungsmanager mit einem neuen Clientgeheimnis. Weitere Informationen zur Rotation von Geheimnissen finden Sie auf der Seite Dienstprinzipale.
Anmerkung
Wenn Sie den Dienstprinzipal nicht erstellt haben, bitten Sie einen Arbeitsbereich-Administrator, ein neues Clientgeheimnis bereitzustellen.
Neues Clientgeheimnis generieren
Navigieren 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 Sie das neue Geheimnis und speichern Sie es an einem sicheren Ort.
Aktualisieren Sie die Verbindung in Designer
Wählen Sie in DesignerDatei > Verbindungen verwalten aus.
Wählen Sie auf der Seite „Verbindungen“ die Dienstprinzipalverbindung aus.
„Bearbeiten“ auswählen.
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.