New-PSUAiAgent

SINOSSI

Crea una nuova definizione di agente AI.

SINTASSI

New-PSUAiAgent [-Name] <String> [-Description <String>] [-Instructions <String>] [-Model <String>]
 [-ApiKey <Variable>] [-Tool <String[]>] [-ComputerName <String>] [-AppToken <String>]
 [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

DESCRIZIONE

Crea una definizione di agente AI dai parametri forniti e la rende persistente in PowerShell Universal. L'agente creato può definire i metadati del modello, le istruzioni, una variabile per la chiave API e gli strumenti che l'agente può invocare.

ESEMPI

Esempio 1

PS C:\> New-PSUAiAgent -Name SupportAgent -Description "Tier 1 assistant" -Instructions "Answer from the knowledge base first." -Model gpt-4o-mini -Tool GetUsers,GetTickets

Crea un agente AI denominato SupportAgent che può utilizzare gli strumenti GetUsers e GetTickets.

PARAMETRI

-ApiKey

Specifica la variabile PSU che contiene la chiave API utilizzata dall'agente AI.

Type: Variable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AppToken

Specifica il token dell'app da utilizzare per l'autenticazione all'API di gestione di PowerShell Universal.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

Specifica l'URL o il nome host dell'istanza di PowerShell Universal di destinazione. I nomi host semplici vengono normalizzati in un URL http://<host>:5000.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Riutilizza e rende persistenti i cookie di autenticazione per la sessione PowerShell corrente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Specifica le credenziali da utilizzare per l'autenticazione di base verso l'API di gestione di PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Description

Specifica una descrizione per la risorsa.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Instructions

Specifica le istruzioni di sistema o le linee guida operative che l'agente AI segue durante la generazione delle risposte.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Utilizza il client di gestione integrato in-process quando il cmdlet viene eseguito all'interno di PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Model

Specifica l'identificatore del modello AI che l'agente deve utilizzare per i completamenti.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Specifica il nome della risorsa.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Tool

Specifica i nomi degli strumenti AI che l'agente può utilizzare.

Type: String[]
Parameter Sets: (All)
Aliases: Tools

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Consente le connessioni a server con certificati TLS non attendibili.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Utilizza le credenziali Windows correnti durante l'autenticazione all'API di gestione.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per maggiori informazioni, veda about_CommonParameters.