Tilin täsmäytysagentin (tuotantovalmis esikatselu) määrittäminen ja määrittäminen

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Tässä artikkelissa kerrotaan, miten järjestelmänvalvojat voivat määrittää ja määrittää tilin täsmäytysagentin Microsoft Dynamics 365 Financeissa. Asiakkaat voivat Power Platform -hallintakeskuksen avulla määrittää ja määrittää tilin yhteensovitteluagentin. Lisätietoja on kohdassa Deploy Dynamics 365 agenteille ohjatun agentin käyttöönottotoiminnon avulla.

Edellytykset

Ennen kuin käytät tilin täsmäytysagenttia, varmista, että järjestelmä täyttää seuraavat vaatimukset:

• Käytät Dynamics 365 Finance -versiota 10.0.46 tai uudempaa.

• Voit ottaa käyttöön seuraavat ominaisuudet ominaisuuksien hallinnassa. Jos ominaisuudet eivät näy järjestelmässäsi, valitse Tarkista päivitykset.

  • Mukaansatempaava aloitussivu
  • Agenttien hallinta
  • (Tuotantovalmis esiversio) Tilin täsmäytysagentti

• Suoritat seuraavia paketteja Power Platform -hallintakeskuksessa:

  • Copilot talous- ja toimintosovelluksille -versio 1.0.3048.2 tai uudempi
  • Copilot Microsoft Dynamics 365 Finance:ssä, versio 1.0.3049.1 tai uudempi

Microsoft Copilot Studio -agentit, joita tarvitaan tilin täsmäytysagentin suorittamiseen, julkaistaan automaattisesti. Ympäristössäsi saattaa kuitenkin olla tietojen menetyksen estämisen (DLP) käytäntöjä, jotka estävät näiden agenttien julkaisemisen. Jos haluat tarkistaa, onko agenttien julkaisu onnistunut, toimi seuraavasti:

1. Siirry Copilot Studioon ja etsi ympäristösi.
2. Vahvista, että ympäristössä julkaistaan seuraavat Microsoft Copilot Studio -agentit:

• Tilin täsmäytysagentti

Jos agentteja ei ole julkaistu, katso Copilot Studion tietokäytäntöjen valvonnan vianmääritys. Vahvista, että agentit on jaettu organisaation kanssa.

Lisätietoja on kohdassa Älykkään kotisivun yleiskatsaus. 

Agentin tunnistetietojen määrittäminen

Määritä agentin tunnistetietojen käyttäjät ja käyttöoikeusroolit

Luo agentin tunnistetietojen käyttäjätilit sekä Dataversessa että Financessa.

Määritä käyttäjätileille seuraavat käyttöoikeusroolit:

• Vaaditut Dataverse-käyttäjäroolit:

  • Talous- ja toimintosovellusten peruskäyttäjä
  • Tilin täsmäytysagentin rooli
  • Ympäristön tekijä

• Vaaditut Finance-käyttäjäroolit:

  • Tilin täsmäytysagentti
  • Järjestelmän käyttäjä

Ota agentti käyttöön

Käyttöönotto ohjatun Agent-käyttöönottotoiminnon kautta

Ohjattu Agentin käyttöönotto yksinkertaistaa prosessia, jossa agentille määritetään tarvittavat yhteydet ja aktivoidaan tarvittavat työnkulut.

Ohjatun käyttöönottotoiminnon käyttäminen

Voit käyttää ohjattua käyttöönottoa seuraavasti:

1. Avaa Copilot Hub Power Platform -hallintakeskuksessa ja valitse Dynamics 365.
2. Jos et näe Copilot Hubia Power Platform -hallintakeskuksessa, tarkista, onko ominaisuusmerkintä ShowDynamics365ERPInCopilotHub käytössä.
3. Valitse kohdeympäristö.
4. Valitse Tilien täsmäytys -agentti.
5. Käynnistä agentin ohjattu käyttöönotto valitsemalla Lisää .

Ota agentti käyttöön ohjatun toiminnon avulla

Edellytykset – Ohjattu toiminto tarkistaa, täyttääkö kohdeympäristö kaikki tilien täsmäytysagentin pakolliset edellytykset. Se sisältää myös valinnaisen toiminnon virtuaalisten entiteettien päivittämiseksi Tilien täsmäytysagentille. Vaikka tämä vaihe on valinnainen, on suositeltavaa päivittää virtuaaliset entiteetit tilien täsmäytysagentin asianmukaista aktivointia varten.

Valitse Agentin käyttäjätiedot

Jokainen agentti toimii varatun agentin käyttäjätietojen alla. Tässä vaiheessa valitset aiemmin luodun käyttäjän osana Määritä agentin käyttäjätiedot -vaihetta.

Yhteyden muodostaminen agenttiin

Tässä vaiheessa ohjattu toiminto pyytää sinua valitsemaan yhteysviittauksen Microsoft Dataverselle ja Copilot Studiolle. Jos yhteysviittausta ei ole, voit luoda sen. Luo yhteysviittaus valitsemalla Plus-kuvake yhteysviittauksen avattavan valikon vierdestä. Luo yhteysviittauksia käyttämällä aiemmin määrittämiäsi agentin käyttäjätietoja, kuten käyttöliittymässä mainittiin.

Kun olet valinnut tai luonut yhteysviittauksen kullekin resurssille tai sovellukselle, valitse Yhdistä agentti määrittääksesi agentin yhteysviittaukset.

Aktivoi sitten kaikki Power Automate työnkulut, joita agentti käyttää osana tämän sivun toista vaihetta.

Agentin käyttöönotto

Viimeisessä vaiheessa agentti on käytettävissä. Ota agentti käyttöön seuraavasti:

1. Julkaise agenttibotti Copilot Studiossa.
2. Varmista, että agentti on käytössä ja käytettävissä kohdeympäristössä.
3. Kun otat agentin käyttöön, se aktivoituu ja on valmis käytettäväksi.

Lisätietoja agentin käyttöönoton ohjatusta toiminnosta on kohdassa Deploy Dynamics 365 agentin ohjattua käyttöönottoa.

Agentin manuaalinen käyttöönotto

Luo tarvittavat yhteydet

Tilin täsmäytysagentti käyttää liitintä Dataverseen ja Microsoft Copilot Studioon. Määritä liittimet ennen agentin käyttöä.

Määritä liittimet seuraavasti:

1. Kirjaudu sisään Power Apps käyttämällä juuri luotua agentin käyttäjätietokäyttäjää.

2. Valitse vasemmanpuoleisessa ruudussa Yhteydet.

3. Valitse sivun ylälaidasta Uusi yhteys.

4. Kirjoita Search -kenttään Microsoft Dataverse.

5. Etsi hakutuloksista yhteys Microsoft Dataverse, valitse Luo ja luo se näytön ohjeiden mukaan.

6. Kun järjestelmä kehottaa kirjautumaan sisään, kirjaudu sisään aiotuilla agentin tunnistetiedoilla.

   Sinut palautetaan Yhteydet-sivulle. Uusi liitin näkyy luettelon alaosassa, ja sen nimi tulee sen agentin tunnistetietojen mukaan, jona olet kirjautunut sisään luodessasi sen.

7. Valitse sivun ylälaidasta Uusi yhteys.

8. Etsi Microsoft Copilot Studio (esikatselu)yhteys, valitse Luo ja luo liitin näytön ohjeiden mukaisesti. Kun järjestelmä kehottaa kirjautumaan sisään, kirjaudu sisään aiotuilla agentin tunnistetiedoilla.

   Sinut palautetaan Yhteydet-sivulle. Uusi liitin näkyy luettelon alaosassa, ja sen nimi tulee sen agentin tunnistetietojen mukaan, jona olet kirjautunut sisään luodessasi sen.

Päivitä yhteysviitteet ja aktivoi laukaisutyönkulut

Viimeistele agentin käyttäjätietojen määrittäminen päivittämällä agentin yhteysviittaukset niin, että ne osoittavat luomiesi yhteyksien kautta. Sinun on aktivoitava myös käynnistävät Power Automate -työnkulut. Tässä osassa on esimerkki PowerShell-komentosarjasta, jota voit käyttää molempien tehtävien suorittamisessa.

Jos haluat käyttää PowerShell-esimerkkikomentosarjaa, toimi seuraavasti:

1. Kopioi komentosarja ja tallenna se .ps1-tiedostona.

2. Määritä ennen komentosarjan ajoa seuraavat neljä parametria:

   • environmentId – Määritä Dataverse-ympäristön tunnus. Löydät tämän tunnuksen Power Platform -hallintakeskuksesta.
   • dataverseUrl – Määritä Dataverse-ympäristön URL-osoite. Löydät tämän URL-osoitteen Power Platform -hallintakeskuksesta.
   • DVConnectionName – Määritä käytettävän Dataverse-yhdistimen nimi. Liitin on nimetty sen agentin tunnistetietojen mukaan, jona olet kirjautunut sisään luodessasi sen. Löydät nimen Power Apps Connections -sivulta.
   • MCSConnectionName – Määritä käytettävän Copilot Studio -yhdistimen nimi. Liitin on nimetty sen agentin tunnistetietojen mukaan, jona olet kirjautunut sisään luodessasi sen. Löydät nimen Power Apps Connections -sivulta.

3. Mukauta komentosarjaa tarpeen mukaan.

4. Suorita komentosarja mistä tahansa PowerShell-konsolista. Kun järjestelmä kehottaa kirjautumaan sisään, kirjaudu sisään järjestelmänvalvojana.

Esimerkkikomentosarja, joka päivittää yhteysviitteet ja ottaa käyttöön käynnistävät työnkulut

Param(
    [Parameter(Mandatory=$true, HelpMessage="Dataverse environment id")]
    [string]$environmentId = "", 
    [Parameter(Mandatory=$true, HelpMessage="Dataverse environment URL")]
    [string]$dataverseUrl = "",
    [Parameter(Mandatory=$true, HelpMessage="Microsoft Dataverse connection name")]
    [string]$DVConnectionName = "",
    [Parameter(Mandatory=$true, HelpMessage="Microsoft Copilot Studio connection name")]
    [string]$MCSConnectionName = ""
)
# Check PS version
if ($PSVersionTable.PSVersion.Major -lt 7) {
    Write-Error 'This script requires at least PowerShell version 7' -ErrorAction Stop
}

# Install the required modules if not already installed
if (-not (Get-Module -ListAvailable -Name Microsoft.PowerApps.PowerShell)) {
    Write-Warning -Message 'Installing module Microsoft.PowerApps.PowerShell'
    Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUser
}

# Install the required modules if not already installed
if (-not (Get-Module -ListAvailable -Name Az.Accounts)) {
    Write-Warning -Message 'Installing module Az.Accounts'
    Install-Module -Name Az.Accounts -AllowClobber -Scope CurrentUser
}

# Import required modules
Import-Module Az.Accounts
Import-Module Microsoft.PowerApps.PowerShell
function Get-AccessToken {
    try {
    # Retrieve the access token for the Dataverse environment
    $accessToken = Get-AzAccessToken -ResourceUrl "$dataverseUrl" -AsSecureString
    $token = $accessToken.Token
    $userId = $accessToken.UserId

    Write-Host "Access token for $userId retrieved successfully." -ForegroundColor Green
    } catch {
        Write-Host "Failed to retrieve access token. Error: $($_.Exception.Message)" -ForegroundColor Red
    }
    return $token
}

function Get-ConnectionId {
    param (
        [string]$userProvidedName,
        [string]$providerName
    )
    $matchedConnectionId = $null
    $connections = Get-PowerAppConnection -EnvironmentName $environmentId -ConnectorNameFilter $providerName
    foreach ($con in $connections) {
        if (($con.ConnectionName -eq $userProvidedName) -or ($con.DisplayName -eq $userProvidedName))
        {
            $matchedConnectionId = $con.ConnectionName
            break
        }
    }
    if ($null -eq $matchedConnectionId)
    {
        Write-Error -Message "Unable to find connection $userProvidedName ($providerName)" -ErrorAction Stop
    }
    Write-Host "Found connection id $matchedConnectionId for connection $userProvidedName"
    return $matchedConnectionId
}

function Get-ConnectionReferenceId {
    param(
        [string]$connectionReferenceLogicalName,
        [securestring]$accessToken
    )
    $uri = "$dataverseUrl/api/data/v9.2/connectionreferences?`$filter=connectionreferencelogicalname eq '$connectionReferenceLogicalName'"
    $response = Invoke-RestMethod -Method Get `
        -Uri $uri `
        -Authentication Bearer -Token $accessToken `
        -ContentType 'application/json'        
    
    if ($null -eq $response) {
        Write-Error -Message "Connection reference not found for logical name $connectionReferenceLogicalName" -ErrorAction Stop
    }
    $connectionReferenceDisplayName = $response.value[0].connectionreferencedisplayname
    $connectionReferenceId = $response.value[0].connectionreferenceid
    Write-Host "Found connection reference id $connectionReferenceId for $connectionReferenceDisplayName ($connectionReferenceLogicalName)"
    return $connectionReferenceId
}

function Set-ConnectionReferenceConnection {
    param (
        [string]$connectionReferenceLogicalName,
        [string]$userProvidedConnectionName,
        [string]$providerName,
        [securestring]$accessToken
    )
    Write-Host "Updating connection reference ${connectionReferenceLogicalName}..."
    $connectionReferenceId = Get-ConnectionReferenceId -connectionReferenceLogicalName $connectionReferenceLogicalName -accessToken $accessToken
    $connectionId = Get-ConnectionId -userProvidedName $userProvidedConnectionName -providerName $providerName
    $body = @{
        "connectionid" = "$connectionId"
    } | ConvertTo-Json -Depth 1
    $uri = "$dataverseUrl/api/data/v9.2/connectionreferences($connectionReferenceId)"
    Write-Host "Updating connection reference URI: $uri with connection id $connectionId"
    Invoke-RestMethod -Method Patch `
        -Uri $uri `
        -Authentication Bearer -Token $accessToken `
        -ContentType 'application/json' `
        -Body $body
   
    Write-Host "Connection reference updated successfully." -ForegroundColor Green
    Write-Host
}

function ValidateUserEnvironment {
    param (
        [string]$environmentId
    )
   $env = Get-PowerAppEnvironment -EnvironmentName $environmentId
    
    if ($null -eq $env) {
        Write-Error -Message "Environment $environmentId was not found" -ErrorAction Stop
    }
    $displayName = $env.DisplayName
    Write-Host "Connected to environment: $displayName ($environmentId)"
}

function Enable-TriggerFlow {
    param (
        [string]$flowId,
        [securestring]$accessToken
    )
    $flowUri = "$dataverseUrl/api/data/v9.2/workflows($flowId)"
    $flow = $null
    Write-Host "Enabling flow $flowId with uri $flowUri"
    try {
        $flow = Invoke-RestMethod -Method Get `
            -Uri $flowUri `
            -Authentication Bearer -Token $accessToken `
            -ContentType 'application/json'
    }
    catch {
        Write-Error -Message $_.Exception -ErrorAction Stop
    }
    $displayName = $flow.name
    Write-Host "Activating flow $displayName for id $flowId"
    $body = @{
        "statecode" = 1  # Activated
        "statuscode" = 2 # Activated
    } | ConvertTo-Json -Depth 1 -Compress
    
    try {
        Invoke-RestMethod -Method Patch `
            -Uri $flowUri `
            -Authentication Bearer -Token $accessToken `
            -ContentType 'application/json' `
            -Body $body
    }
    catch {
        Write-Error -Message $_.Exception -ErrorAction Stop
    }
    Write-Host "Activated flow $displayName" -ForegroundColor Green
    Write-Host
}

# Actual script body
Write-Host
Write-Host "Authenticating interactively..."
Write-Host

Connect-AzAccount -UseDeviceAuthentication
$accessToken = Get-AccessToken
ValidateUserEnvironment -environmentId $environmentId

Write-Host
Write-Host 'Setting up connection references...'
Write-Host

Set-ConnectionReferenceConnection `
    -userProvidedConnectionName $DVConnectionName `
    -providerName "/providers/Microsoft.PowerApps/apis/shared_commondataserviceforapps" `
    -connectionReferenceLogicalName "msdyn_sharedcommondataserviceforapps_f9321" `
    -accessToken $accessToken
Set-ConnectionReferenceConnection `
    -userProvidedConnectionName $MCSConnectionName `
    -providerName "/providers/Microsoft.PowerApps/apis/shared_microsoftcopilotstudio" `
    -connectionReferenceLogicalName "msdyn_sharedmicrosoftcopilotstudio_462f2" `
    -accessToken $accessToken

Write-Host
Write-Host 'Activating flows...'
Write-Host

Enable-TriggerFlow -flowId '570a7d17-ac0a-f011-bae1-6045bd0139fb' -accessToken $accessToken # Account reconciliation - Complete agent activity request
Enable-TriggerFlow -flowId '75c311f8-1880-ef11-ac21-000d3a5aa6e6' -accessToken $accessToken # Account reconciliation - Determine work to be done
Enable-TriggerFlow -flowId '13dd7af5-f73b-f111-bec6-0022480882fa' -accessToken $accessToken # Account reconciliation - Generate and log recommended action
Enable-TriggerFlow -flowId 'd3314698-792b-f111-88b5-00224808ca0b' -accessToken $accessToken # Account reconciliation - Agent execution is triggered

Write-Host
Write-Host 'Account reconciliation agents are ready for use' -ForegroundColor Green