Quickstart Guide¶

This guide will get you up and running with your first agent execution on Kla Digital.

Prerequisites¶

• A Kla Digital tenant account.
• An API Token (get this from your administrator).
• curl or a similar tool.

Step 1: Check System Health¶

First, verify that you can reach the API.

curl https://api.kla.local/health

You should see: {"status": "ok"}.

Step 2: List Available Agents¶

See what agents are available to you.

curl -H "Authorization: Bearer <YOUR_TOKEN>" \
     https://api.kla.local/execution/v1/agents

Copy the id of an agent (e.g., agent-demo-1).

Step 3: Start an Execution¶

Run the agent with a simple prompt.

curl -X POST https://api.kla.local/execution/v1/executions \
     -H "Authorization: Bearer <YOUR_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{
           "agentId": "agent-demo-1",
           "input": {
             "prompt": "Tell me a joke about audits."
           }
         }'

Response:

{
  "executionId": "exec-12345",
  "status": "PENDING"
}

Step 4: Get Results¶

Poll the execution status until it completes.

curl -H "Authorization: Bearer <YOUR_TOKEN>" \
     https://api.kla.local/execution/v1/executions/exec-12345

When status is COMPLETED, check the output field for the agent's response.

Step 5: Verify Audit Log¶

Finally, verify that this execution was logged.

# Using the CLI
kla audit logs --execution-id exec-12345

You should see a list of events (Started, Step Completed, Finished) with their cryptographic hashes.

Next Steps: * Learn about Execution Budgets. * Configure Governance Policies.