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
- 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?
Includeprovider 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?
- Use a test/staging environment
- Send test events from your agent
- Verify events appear in Live Data
- Test pricing with Pricing Simulator
- 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?
- Create a new API key
- Update all applications with the new key
- Test to verify everything works
- Revoke the old key
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?
- Documentation: Check our comprehensive documentation
- Slack Community: Join our Slack Community
- GitHub Issues: Report issues on GitHub
- Email: Contact support@valmi.io