Skip to main content
Documentatie
Documentatie
Administrator Guide
Laatst bijgewerkt: 2026-03-13
Externe agents registreren

Externe agents registreren

Vooraf vereist

Mogelijk moet u aanvullende stappen uitvoeren om deze functie in te schakelen op basis van de service van uw organisatie. Uw organisatie is opgenomen in de Main Service Agreement (MSA) of de Universal Main Service Agreement (UMSA). Ga als volgt te werk om de service van uw organisatie te bepalen:
  1. Selecteer uw profielavatar in Workday Community .
  2. Selecteer
    Profiel
     .
  3. Selecteer op uw profielpagina de naam van uw organisatie. Deze wordt onder uw naam en naast uw functietitel weergegeven.
  4. Hiermee kunt u de waarde van uw
    abonnementsserviceovereenkomst
     weergeven.
Als de waarde is:
Flexkrediet is alleen vereist voor het registreren en gebruiken van agents in uw productietenants. U kunt pas agents in productie registreren en gebruiken als u zich hebt aangemeld voor deze overeenkomsten. UMSA is vereist voor niet-productietenants en productietenants voor door Workday gemaakte agents. UMSA is niet vereist voor niet-productietenants voor zelfgebouwde agents.
Registratie agentsysteem instellen .
Beveiliging:
  • Het domein
    Hub voor agentbeheer
     in het functionele gebied 'Agent System of Record'. Vereist om te valideren dat de agent is geregistreerd in Workday.
  • Het domein
    Manage Agents
     in het functionele gebied 'Agent System of Record'. Vereist voor activering en configuratie.
  • Het domein
    Set Up: Tenant Setup - Security
     in het functionele gebied 'System'. Vereist voor registratie.

Context

Momenteel kunt u externe agents in Workday alleen registreren en definiëren met behulp van de ASOR- API. Externe agents worden tegelijkertijd gedefinieerd en geregistreerd met behulp van de API. Het zijn geen twee afzonderlijke stappen. U kunt elke gewenste API client gebruiken om de API aan te roepen.
Registratie-eindpunten:
  • REST API Endpoint:
     https://us.agent.workday.com/asor/v1/agentDefinition.
  • Token Endpoint:
     https://us.agent.workday.com/auth/oauth2/<Tenant_Name>/token
  • Eindpunt autoriseren:
     https://us.agent.workday.com/auth/authorize/<Tenant_Name>?response_type=code&client_id=<client_id>&state=test3pagent1&redirect_uri=<redirect_uri>
Zie de documentatie bij Agent Gateway voor informatie over andere regionale beschikbaarheid buiten de VS:Referentie: regionale beschikbaarheid van agentgateway .

Verificatieopties:

Als u externe agents wilt registreren, hebt u een toegangstoken nodig in uw ASOR- API aanroep. Hieronder vindt u de verschillende opties voor het verkrijgen van een token om de ASOR API aanroep aan te roepen.
Optie 1: een API client handmatig verifiëren
  1. Open de taak
    Register- API client
     .
    • Clientnaam:
       voer een unieke identificeerbare naam in voor uw agent. U wordt aangeraden voor elke agent een afzonderlijke client te gebruiken, zodat ze eenvoudiger te beheren zijn.
    • Toekenningstype klant:
      toekenning autorisatiecode
       .
    • Type toegangstoken:
      drager
       .
    • Omleidings-URI:
       voer een URL in waarnaar gebruikers na autorisatie moeten worden omgeleid.
    • Bereik (functionele gebieden):
      geregistreerd agentsysteem
       .
    • Bereik in eigendom van Workday opnemen:
       schakel dit selectievakje in .
  2. Kopieer de waarden voor de
    client-ID
     en
    het clientgeheim
     en sla ze op. U kunt deze gebruiken om een toegangstoken op te halen om de definitie- API aan te roepen.
  3. Plak deze URL in een nieuw venster. U wordt omgeleid naar google.com met een toegevoegde code die u kunt gebruiken om de API aan te roepen:
    https://us.agent.workday.com/auth/authorize/<Tenant_Name>?response_type=code&client_id=<client_id>&state=test3pagent1&redirect_uri=<redirect_uri>
  4. Maak een nieuwe aanvraag met behulp van een externe API client (bijvoorbeeld: Bruno):
    https://<tenantHost>/ccx/oauth2/<tenantName>/ token
    • Hoofdtekst:
      Grant_type=authorization_code&code=<authorizationCode>&client_id=<clientID>&client_secret=<ClientSecret>
    • Auth: Gebruikersnaam =
      <ClientID>
       , Wachtwoord =
      <ClientSecret>
       .
    • Hiermee worden een toegangstoken en vernieuwen gegenereerd token u de ASOR Agent Definition API kunt aanroepen.
    • Houd bij het voltooien van deze stap rekening met het volgende:Concept: overwegingen voor ASU externe agent .
De gebruiker die de agent registreert, moet toegang hebben tot het domein 'Setup: Agents' in het functionele gebied 'Agent System of Record' om een agent te registreren met behulp van de ASOR- API.
Optie 2: verifiëren met Extend
Als u een Workday Extend- of Workday Orchestrate-gebruiker bent, kunt u een toegangstoken ophalen via de ontwikkelaarssite van Workday.
  1. Ga naar 'developer.workday.com' en meld u aan.
  2. Klik in de rechterbovenhoek op het gebruikersmenu. In het menu moet de huidige bedrijf worden weergegeven.
  3. Klik op
    Tenant
    aanmelden bij tenant
     .
  4. Selecteer uw omgeving en tenant en klik op
    Verbinden met tenant
     .
  5. Meld u aan bij de tenant ''. Als u een agent wilt registreren met behulp van de ASOR- API , moet u zich aanmelden met een account dat toegang heeft tot het domein
    'Setup: Agents'
     in het functionele gebied 'Agent System of Record'.

Een externe agent registreren met behulp van de ASOR- API

Vereisten:
  • Een toegangstoken voor een account dat toegang heeft tot het domein
    'Setup: Agents'
     in het functionele gebied 'Agent System of Record'.
  • Een API client naar keuze.
  • Beveiliging: de volgende domeinen in het functionele gebied 'System':
    • Custom Report Creation
    • Manage: All Custom Reports
    • Rapporttagbeheer
Context:
Als u een externe agent wilt registreren, moet u:
  • Zoek de Workday ID's (WID's) van de relevante Workday API's (SOAP en REST) die u wilt opnemen in de definitie van hulpprogramma's van uw agent door een aangepast rapport '' te maken.
  • Zoek de agentaanbieder met behulp van de taak
    voor de agentaanbieder weergeven
     .
  • ASOR REST-API aanroepen
Op SOAP- en op REST gebaseerde WID's zoeken voor definitie agenthulpprogramma's
  1. Open de taak
    Aangepast rapport maken
    .
  2. Houd bij het maken van het rapport rekening met het volgende:
    Optie
    Omschrijving
    Rapporttype
    Selecteer
    Geavanceerd
     .
    Geoptimaliseerd voor prestaties
    Schakel dit selectievakje uit.
    Gegevensbron
    Selecteer
    Openbare webservices
     voor SOAP-API's en
    Alle bewerkingen van openbare diensten
     voor REST-API's.
  3. Voor SOAP-API's: voeg op de pagina
    Aangepast rapport bewerken
     op het tabblad
    Kolommen
     van de rapportdefinitie de volgende rijen toe:
    Bedrijfsobject
    Veld
    Webservice
    Webservice
    Webservicebewerking
    Naam webservicebewerking
    Webservicebewerking
    Workday-ID
  4. Voor REST-API's: voeg op de pagina
    Aangepast rapport bewerken
     op het tabblad
    Kolommen
     van de rapportdefinitie de volgende rijen toe:
    Bedrijfsobject
    Veld
    Servicebewerking
    Service
    Servicebewerking
    Naam
    Servicebewerking
    Workday-ID
  5. Sla het rapport op en voer het uit.
Wanneer u WID's voor uw API's ophaalt, kunt u ook kruisverwijzingen naar deze lijsten maken:
Aanbieder agent zoeken
Agentaanbieders geven aan wie de agent heeft gebouwd en worden weergegeven in het veld
'Gebouwd door'
 in het profiel van de agent.
  1. Open de taak
    'Agentaanbieder weergeven'
     ( beveiligd in het domein
    'Setup: Agents'
     ) in het functionele gebied 'Agent System of Record'.
  2. Gebruik de aanbieder-ID in uw API aanroep voor agentregistratie.
Agentplatform zoeken
Agentplatforms verwijzen naar het externe platform of systeem waarop de agent is ontwikkeld en uitgevoerd. Deze worden weergegeven in het veld
'Gebouwd op'
 in het profiel van de agent.
  1. Open de taak
    'Agentplatforms weergeven'
     ( beveiligd in het domein 'Setup Agents') in het functionele gebied 'Agent System of Record'.
  2. Gebruik de platform-ID in uw API aanroep voor agentregistratie.
ASOR REST-API aanroepen
Maak een nieuwe aanvraag om uw agent te registreren met behulp van een externe API client, bijvoorbeeld: Bruno.
Houd bij het maken van de aanvraag rekening met het volgende:

Hub voor agentbeheer

Nadat u de agentdefinitie in Workday hebt geladen, kunt u controleren of de definitie is geregistreerd in de
hub voor agentbeheer
 .
  1. Open het rapport
    Hub voor agentbeheer
     .
  2. Klik op
    Agentregister
     om een lijst met uw agents weer te geven.
  3. Klik op een agent om overzichtsgegevens voor de agent weer te geven.

Volgende stappen

Configureer uw agent in Workday.