Skip to main content

General Questions

What is an Agent?

An Agent is a logical grouping of AI functionality. It represents a type of AI service you offer, such as a LangGraph agent for customer support, a CrewAI agent for research, or a custom AI application.

What is an Agent Instance?

An Agent Instance is a specific deployment or customer-specific version of an Agent. Each instance has its own Agent Key used in SDK calls, allowing you to track usage and costs per instance.

How does Pricing Simulation work?

The Pricing Simulator lets you test pricing models with sample usage data before deploying them to customers. Enter sample usage (tokens, API calls, etc.) and see calculated charges, costs, and margins.

When should I use Extensions vs Webhooks?

Extensions are pre-built integrations that handle common workflows (Stripe payments, QuickBooks sync, etc.). Webhooks are for custom integrations where you want to receive events and handle them yourself. Use extensions for:
  • Common integrations (Stripe, QuickBooks, HubSpot)
  • Standard workflows
  • Quick setup
Use webhooks for:
  • Custom integrations
  • Complex workflows
  • Full control over event handling

How does cost allocation work?

Cost allocation attributes your expenses (LLM costs, API costs, infrastructure) to specific agents, actions, or customers. LLM costs are automatically calculated when you include model and provider metadata. Other costs can be manually configured or allocated proportionally.

What is the difference between blended and itemized costs?

Blended costs show average cost across all usage (e.g., $0.01 per 1K tokens). Itemized costs break down costs by component (LLM costs, API costs, infrastructure). Itemized costs provide better visibility into cost drivers.

How do I handle multiple LLM providers?

Include provider and model in action metadata. The system automatically applies the correct pricing based on provider rates. You can also create separate charges for different models if you want different customer pricing.

Can I bill in multiple currencies?

Yes, Valmi Value supports multi-currency pricing and billing. You can set prices in different currencies and generate invoices in customer’s preferred currency.

How do I test my integration?

  1. Use a test/staging environment
  2. Send test events from your agent
  3. Verify events appear in Live Data
  4. Test pricing with Pricing Simulator
  5. Generate test invoices

What happens if the API is down?

The SDK automatically buffers events locally when the API is unavailable. Events are retried when the connection is restored. No data is lost.

How do I rotate API keys?

  1. Create a new API key
  2. Update all applications with the new key
  3. Test to verify everything works
  4. Revoke the old key
There’s a 24-hour grace period where both keys work, giving you time to update.

Can I use Valmi Value for non-AI services?

While Valmi Value is optimized for AI agents, you can use it for any consumption-based billing use case. The flexible metadata system allows you to meter and price any type of usage.

How do I get support?

Is there a free tier?

Yes, Valmi Value offers a free tier for development and testing. See pricing for details.

What compliance certifications does Valmi Value have?

Valmi Value is SOC 2 Type II compliant and GDPR compliant. Additional certifications (HIPAA, ISO 27001) are coming in 2024.