Creating an Istari Digital Agent API Token

You can create an Istari Digital Agent API Token through the Admin Panel (recommended) or the SDK.

note

The user creating the token must have Org Owner role and the customer_admin authorization on the istari Project in Zitadel.

Via the Istari Digital Admin Panel

An Istari Agent API token can be created through the Istari Digital Admin Panel.

1. Navigate to the Admin Panel.
   Click the Admin option in the left-hand sidebar.

2. Navigate to the Agent Configuration page.
   Click the Configure Agents panel.

3. Open the Generate Token modal.
   Click the Generate Token button in the top-right.

4. Enter a name for the token.
   Enter a name for the Istari Agent API token in the Token Name field in the modal. This name must be unique and should identify the purpose of the agent the token will be used for.

5. Generate the token.
   Click the Generate button in the bottom-right of the modal.

6. Copy the token to the config file.
   Click the Copy credential button in the bottom-right of the modal to copy the generated Istari Agent API token to the clipboard. Paste it into the istari-digital-config.yaml file as the istari_digital_agent_registry_api_token.

warning

You will not be able to access the value for the Istari Agent API token after closing the modal. You MUST copy it at this step.

Via the Istari Digital SDK

An Istari Digital Agent API token can be created using the Istari Digital Python SDK.

See the SDK setup instructions for guidance on how to set up and configure the Istari Digital SDK.

from istari_digital_client import Client, Configuration

client = Client(
  Configuration(
    registry_url="<API_URL>",            # replace with the API URL for the Istari Platform
    registry_auth_token="<AUTH_TOKEN>",  # replace with your PAT for the Istari Platform
  )
)

agent_token = client.create_agent_personal_access_token(
  name="<AGENT_TOKEN>",  # replace with a unique name for the Istari Agent API token
)
print(agent_token.token)