Activity

Every service call through Sapiom is logged. Use the activity view to track costs, debug issues, and understand how your agents are using services.

Transaction History

Each transaction includes:

Field	Description
Timestamp	When the transaction occurred
Agent	Which agent made the request
Service	The capability used (verification, search, etc.)
Cost	Transaction cost in USD
Status	Success, blocked (by rule), or error
Duration	How long the service call took

Filtering

Filter the transaction list by:

• Date range — View specific time periods
• Agent — Focus on a single agent’s activity
• Service — See usage of a specific capability
• Status — Find blocked or failed transactions

Transaction Details

Click any transaction to see full details including every step of the execution: authentication, request processing, response generation, token usage, costs, and rule enforcement.

Use transaction details to:

• Debug failures — See exactly where and why a request failed
• Understand costs — Break down what contributed to the transaction cost
• Trace execution — Follow the request through the entire flow
• Review rule enforcement — See which rules were evaluated and their results

Common Tasks

Investigating Unexpected Costs

1. Filter transactions by date range covering the cost spike
2. Sort by cost (highest first)
3. Click into high-cost transactions to understand what drove the spend
4. Check if any agents are making more calls than expected

Debugging Agent Failures

1. Filter by status to show only errors
2. Click into failed transactions
3. Review the execution trace to identify the failure point
4. Check if a rule blocked the transaction or if the service returned an error

Monitoring New Deployments

1. Filter by the agent name of your new deployment
2. Watch transaction success rates
3. Check that costs align with expectations
4. Look for any rule enforcement events

Related

• Setting Up Rules — Configure spend and usage limits
• Agents & Identity — Track which agents are making calls