Skip to main content

Create a customer simulator (twin) based on a set of real conversations.

Project description

Agentune Simulate

CI PyPI version License Twitter Follow Discord


Launching an AI Agent? Stop guessing, start simulating.

Many developers and data scientists struggle to test and validate AI agents effectively. Some deploy directly to production, testing on real customers! Others perform A/B testing, which also means testing on real customers. Many rely on predefined tests that cover main use cases but fail to capture real user intents.

Agentune Simulate creates a customer simulator (twin) based on a set of real conversations. It captures the essence of your customers' inquiries and the way they converse, allowing you to simulate conversations with your AI agent, ensuring it behaves as expected before deployment.

Ready to deploy your improved AI agent? Use Agentune Simulate to validate it first against real customer interactions!

Need help? Please contact us. We are committed to assist early adopters in making the most of it!

How Does It Work?

Running a simulation with Agentune Simulate generates realistic conversations between your AI agent and simulated customers. This lets you evaluate your agent's performance, identify edge cases, and validate behavior before real deployment.

Agentune Simulate Workflow

How do we validate the twin customer simulator? We create a twin AI-Agent and let them converse. we then evaluate the conversations to check that the customer simulator behaves as the real customer:

  1. Capture Conversations - Collect real conversations between customers and your existing AI-agent
  2. Create Simulator - Create twin Customer Simulator and AI-Agent from the captured conversations
  3. Simulate & Evaluate - Simulate interactions to evaluate if the twin Customer Simulator behaves as your real customers

Agentune Simulate Workflow

Quick Start

Install Agentune Simulate

pip install agentune-simulate

Basic usage example

from agentune.simulate import SimulationSessionBuilder
from langchain_openai import ChatOpenAI

# Load your conversations and create outcomes
session = SimulationSessionBuilder(
    default_chat_model=ChatOpenAI(model="gpt-4o"),
    outcomes=outcomes,
    vector_store=vector_store
).build()

# Run simulation
results = await session.run_simulation(real_conversations=conversations)

Learn with examples

  1. Quick Start - getting_started.ipynb for a quick getting started example
  2. Production Setup - persistent_storage_example.ipynb for a closer to real life, scalable, persistent example
  3. Validate Your Data - Adapt the 2nd example to load your conversations data and validate the simulation. Here is an example of how to load conversations from tabular data: load_conversations_from_csv.ipynb
  4. Connect Real Agent - real_agent_integration.ipynb for integrating your existing agent systems

📧 Need help? Have feedback? Contact us at agentune-dev@sparkbeyond.com

Contributing

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentune_simulate-0.0.3.tar.gz (41.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentune_simulate-0.0.3-py3-none-any.whl (68.9 kB view details)

Uploaded Python 3

File details

Details for the file agentune_simulate-0.0.3.tar.gz.

File metadata

  • Download URL: agentune_simulate-0.0.3.tar.gz
  • Upload date:
  • Size: 41.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for agentune_simulate-0.0.3.tar.gz
Algorithm Hash digest
SHA256 6253923c42377bb554291a27c687d818ba05a793a87f8597270cf8069babdecb
MD5 063c6345ba2cade7cfd428fe6e9ff7be
BLAKE2b-256 7b76de8df9371d18dbb3370dcbd9dc5903d897601f4bbb745144c6394ba4dc85

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentune_simulate-0.0.3.tar.gz:

Publisher: publish.yml on SparkBeyond/agentune

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentune_simulate-0.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for agentune_simulate-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 12990799c81bae7e132324d4ec78cddd0bf2ac125a02fe752c5374bd0722a163
MD5 8f6b503704db0ed04d97ea158fa44bf5
BLAKE2b-256 abaf1347932cfc2944f4945797dbcfa60600eee5e128caa8883f098d767a7ae0

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentune_simulate-0.0.3-py3-none-any.whl:

Publisher: publish.yml on SparkBeyond/agentune

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page