> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/de/powershell-befehle/new-psuaiagent.md). # New-PSUAiAgent ## SYNOPSIS Erstellt eine neue KI-Agentendefinition. ## SYNTAX ``` New-PSUAiAgent [-Name] [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Erstellt eine KI-Agentendefinition aus den angegebenen Parametern und speichert sie dauerhaft in PowerShell Universal. Der erstellte Agent kann Modell-Metadaten, Anweisungen, eine API-Schlüssel-Variable und die Tools definieren, die der Agent aufrufen darf. ## EXAMPLES ### Beispiel 1 ```powershell PS C:\> New-PSUAiAgent -Name SupportAgent -Description "Tier 1 assistant" -Instructions "Answer from the knowledge base first." -Model gpt-4o-mini -Tool GetUsers,GetTickets ``` Erstellt einen KI-Agenten mit dem Namen SupportAgent, der die Tools GetUsers und GetTickets verwenden kann. ## PARAMETERS ### -ApiKey Gibt die PSU-Variable an, die den vom KI-Agenten verwendeten API-Schlüssel enthält. ```yaml Type: Variable Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppToken Gibt das App-Token an, das bei der Authentifizierung an der PowerShell Universal-Verwaltungs-API verwendet wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Gibt die URL oder den Hostnamen der Ziel-PowerShell Universal-Instanz an. Reine Hostnamen werden zu einer http\://:5000-URL normalisiert. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Verwendet und speichert Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung erneut. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Gibt die Anmeldeinformationen an, die für die Basic-Authentifizierung gegenüber der PowerShell Universal-Verwaltungs-API verwendet werden. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Gibt eine Beschreibung für die Ressource an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Instructions Gibt die Systemanweisungen oder Betriebsvorgaben an, denen der KI-Agent beim Generieren von Antworten folgt. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Verwendet den prozessinternen integrierten Verwaltungsclient, wenn das Cmdlet innerhalb von PowerShell Universal ausgeführt wird. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Model Gibt die Kennung des KI-Modells an, das der Agent für Completions verwenden soll. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Gibt den Namen der Ressource an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: 0 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tool Gibt die Namen der KI-Tools an, die der Agent verwenden kann. ```yaml Type: String[] Parameter Sets: (All) Aliases: Tools Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Erlaubt Verbindungen zu Servern mit nicht vertrauenswürdigen TLS-Zertifikaten. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Verwendet die aktuellen Windows-Anmeldeinformationen bei der Authentifizierung an der Verwaltungs-API. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ### Keine ## OUTPUTS ### System.Object ## NOTES ## RELATED LINKS --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/de/powershell-befehle/new-psuaiagent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.