> 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/da/powershell-kommandoer/invoke-psuaiagent.md).

# Invoke-PSUAiAgent

Invoke-PSUAiAgent starter et promptjob for en AI-agent i PowerShell Universal og returnerer det oprettede job til sporing af dets fremdrift.

## Synopsis

Kalder en PowerShell Universal-AI-agent.

## Syntaks

```
Invoke-PSUAiAgent [-AiAgent] <Object> [-Prompt] <String> [-Parameters <Hashtable>] [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [-Wait] [-WaitTimeout <Int32>] [<CommonParameters>]
```

## Beskrivelse

Starter et promptjob for en AI-agent og returnerer det oprettede job. Parameteren `AiAgent` accepterer enten navnet på en AI-agent eller et AI-agentobjekt fra `Get-PSUAiAgent`. Yderligere værdier, der angives via `Parameters`, serialiseres og overføres til agentjobbet som supplerende parametre. PowerShell Universal håndhæver stadig kørselstilladelsen og eventuelle roller, der er tildelt direkte til den pågældende AI-agent.

## Eksempler

### Eksempel 1

```powershell
PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status."
```

Starter et promptjob for AI-agenten `SupportAgent`.

### Eksempel 2

```powershell
PS C:\> Get-PSUAiAgent -Name SupportAgent | Invoke-PSUAiAgent -Prompt "Draft a response for the ticket." -Parameters @{ TicketId = 42; Customer = 'Contoso' }
```

Kalder det AI-agentobjekt, der er sendt via pipelinen, og sender yderligere jobparametre, som agenten kan bruge, når den opbygger sit svar.

### Eksempel 3

```powershell
PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." -Wait
```

Starter et promptjob for AI-agenten `SupportAgent` og venter på, at det fuldføres, og returnerer agentens svar i stedet for jobobjektet.

### Eksempel 4

```powershell
PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." -Wait -WaitTimeout 60
```

Venter op til 60 sekunder på, at agentjobbet fuldføres. Kaster en timeout-undtagelse, hvis jobbet ikke afsluttes inden for den afsatte tid.

## Parametre

### -AiAgent

Angiver den AI-agent, der skal kaldes. De kan sende navnet på AI-agenten direkte eller pipe et AI-agentobjekt, der returneres af `Get-PSUAiAgent`.

```yaml
Type: Object
Parameter Sets: (All)
Aliases: Name

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
```

### -Prompt

Angiver den prompt, der skal sendes til AI-agenten.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

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

### -Parameters

Angiver yderligere brugerdefinerede parametre, der skal sendes til AI-agentjobbet. Hver nøgle bliver en jobparameter, og hver værdi serialiseres som PowerShell CliXml før udførelse.

```yaml
Type: Hashtable
Parameter Sets: (All)
Aliases:

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

### -ComputerName

HTTP-adressen for PSU-administrations-API-serveren.

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

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

### -AppToken

Et app-token til at få adgang til PSU-administrations-API'en.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

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

### -Credential

Angiver den legitimationsoplysning, der bruges ved godkendelse til PSU-administrations-API'en.

```yaml
Type: PSCredential
Parameter Sets: (All)
Aliases:

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

### -UseDefaultCredentials

Bruger den aktuelle Windows-identitet ved godkendelse mod PSU-administrations-API'en.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

### -Integrated

Udfører kommandoen internt i stedet for at bruge administrations-API'en. Dette fungerer kun, når den køres inde i PowerShell Universal.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

### -TrustCertificate

Deaktiverer TLS-certifikatvalidering for anmodninger til administrations-API'en.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

### -Cookies

Bruger den aktuelle PSU-cookiebeholder til godkendelse.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

### -Wait

Venter på, at AI-agentjobbet fuldføres, og returnerer dets output i stedet for jobobjektet. Når dette er angivet, blokerer kommandoen, indtil jobbet afsluttes, eller timeouten nås.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

### -WaitTimeout

Angiver det maksimale antal sekunder, der skal ventes på, at jobbet fuldføres, når `-Wait` bruges. Hvis timeouten nås, kaster kommandoen en timeout-undtagelse.

```yaml
Type: Int32
Parameter Sets: (All)
Aliases:

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

## Input

### System.Object

De kan pipe et AI-agentobjekt fra `Get-PSUAiAgent` eller sende en streng med et agentnavn.

## Output

### PowerShellUniversal.Job

Returnerer det promptjob, der er oprettet til AI-agentkaldet.

## Noter

Yderligere forbindelsesparametre er nedarvet fra `GrpcCommand`.

## Tilladelser

Adgangstokenet kræver `intelligence.agents/execute` for at køre denne cmdlet eksternt.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/da/powershell-kommandoer/invoke-psuaiagent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.