> 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/intelligens/ai-agents.md).

# AI Agents

Opret og kør AI-agenter i PowerShell Universal for at udføre promptjobs med konfigurerbare udbydere, modeller, instruktioner og AI-værktøjer.

AI Agents giver Dem mulighed for at køre promptjobs direkte i PowerShell Universal. En agent kombinerer en model, udbyderindstillinger, instruktioner, autorisation og valgfrie AI Tools, så brugere kan køre gentagelige prompts i PSU-jobsystemet.

De kan køre agenter fra brugergrænsefladen, arbejdsflows, administrations-API'en eller PowerShell Universal-modulet.

## Opret en AI-agent

### Udbydere og modeller

Gå til **Build > AI > Agents**, og klik på Create AI Agent.

Vælg en udbyder:

* Anthropic
* OpenAI
* Custom

Angiv derefter modelnavnet. For eksempel:

* `gpt-5.5`
* `claude-sonnet-4.6`
* `qwen3.6-27B`

For hostede modeller skal De angive en API-nøglevariabel, så PSU kan godkende på Deres vegne. For `Custom` skal De angive en absolut OpenAI-kompatibel slutpunkts-URL. Det er nyttigt til lokale eller selvhostede modeller.

Typiske brugerdefinerede slutpunkter omfatter lokale gateways som vLLM eller Ollama-kompatible API'er.

### Kontekst

Hver agent kan indeholde instruktioner, der bruges til hver prompt. Når De har oprettet agenten, klik på blyantikonet for at redigere dens Markdown-instruktionsfil.

Brug denne fil til stabil vejledning som f.eks.:

* tone og skrivestil
* forventet outputformat
* driftsregler
* referencer til tilgængelige værktøjsnavne

Hold instruktionerne fokuserede. Placer anmodningsspecifikke data i selve prompten frem for at indbygge dem i agenten.

### Værktøjer

Agenter kan kalde [AI Tools](/powershell-universal/da/intelligens/ai-tools.md) under kørsel.

I feltet AI Tools skal De tildele et eller flere værktøjsnavne eller jokertegnsmønstre som f.eks.:

* `Get Running Processes`
* `ticket_*`
* `weather*`
* `*`

Lad feltet være tomt for at deaktivere værktøjsadgang for den pågældende agent.

### Autorisation

Ligesom andre PSU-ressourcer kan agenter definere roller, der har lov til at køre dem. Kalderen skal være autoriseret til både agenten og ethvert værktøj, som agenten forsøger at bruge.

## Kørsel af prompts

De kan køre prompts ad hoc, i arbejdsflows, via administrations-API'en eller med PowerShell-cmdletter.

### Ad hoc

Klik på kørselsikonet ved siden af en agent for at starte et promptjob. Prompten kører som et normalt PSU-job, så De kan inspicere jobhistorik og output fra siden Jobs.

### Arbejdsflows

De kan tilføje trin af typen AI Prompt til arbejdsflows. Data fra det forrige trin er tilgængelige for agenten i parameteren `PSUItem` som PowerShell CliXml.

For eksempel beder denne prompt agenten om at inspicere arbejdsflowinput og returnere JSON:

{% code overflow="wrap" %}

```
Return the top 5 processes by CPU usage as JSON.
The list of all processes is available in PSUItem as CliXml.
```

{% endcode %}

Outputtet sendes derefter til den næste aktivitet i arbejdsflowet som `PSUItem` til endnu et prompttrin eller `$PSUItem` til et PowerShell-trin.

### Invoke-PSUAiAgent

Brug PowerShell Universal-modulet til at oprette, gennemgå, opdatere og kalde agenter.

Almindelige cmdlets omfatter:

* `Get-PSUAiAgent`
* `New-PSUAiAgent`
* `Set-PSUAiAgent`
* `Remove-PSUAiAgent`
* `Invoke-PSUAiAgent`

Opret en agent:

{% code overflow="wrap" %}

```powershell
$apiKey = Get-PSUVariable -Name 'OpenAIKey'

New-PSUAiAgent -Name 'SupportAgent' `
	-Description 'Summarizes incidents and drafts operator-facing responses.' `
	-Provider OpenAI `
	-Model 'gpt-5.5' `
	-ApiKey $apiKey `
	-Tool @('ticket_*', 'Get Running Processes') `
	-Role @('HelpDesk', 'Operator')
```

{% endcode %}

Kald en agent, og vent på det endelige svar:

{% code overflow="wrap" %}

```powershell
Invoke-PSUAiAgent -AiAgent 'SupportAgent' `
	-Prompt 'Summarize the last deployment and call out any failures.' `
	-Wait
```

{% endcode %}

Overfør yderligere parametre til promptjobbet:

{% code overflow="wrap" %}

```powershell
Invoke-PSUAiAgent -AiAgent 'SupportAgent' `
	-Prompt 'Draft a status update for the incident.' `
	-Parameters @{
		IncidentId = 42
		Customer   = 'Contoso'
		Severity   = 'High'
	} `
	-Wait
```

{% endcode %}

Disse yderligere parametre serialiseres som CliXml og føjes til promptkonteksten for agenten.

### Management API

De kan også køre en agent via administrations-API'en på `/api/v1/aiagent/run`.

{% code overflow="wrap" %}

```powershell
Invoke-RestMethod -Method Post `
	-Uri 'http://localhost:5000/api/v1/aiagent/run' `
	-Headers @{ Authorization = '******' } `
	-Body (@{
		agentName = 'SupportAgent'
		prompt    = 'Summarize the deployment status for today.'
	} | ConvertTo-Json) `
	-ContentType 'application/json'
```

{% endcode %}

API'en returnerer det oprettede job-id eller kørsels-id, som De kan bruge til at læse joboutput.

## Adgang til værktøjer

Agenter kan bruge AI Tools til at forespørge PSU-data eller udføre en handling ved at køre godkendte PowerShell-scripts.

Adgang til værktøjer evalueres ved kørsel. Selv om en agent har lov til at køre, mislykkes et værktøjskald, hvis kalderen ikke opfylder værktøjets krav til godkendelse eller rolle.

Ved planlagte udførelser af arbejdsflow er kalderen PSU-systemkontoen, så planlagte kørsler kan få adgang til alle tildelte værktøjer, som systemet har tilladelse til at bruge.


---

# 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/intelligens/ai-agents.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.