Documentation for Future AGI — the AI lifecycle platform for building, evaluating, observing, and optimizing AI applications. https://docs.futureagi.com en Mon, 17 Aug 2026 08:48:38 GMT https://docs.futureagi.com/docs/simulation https://docs.futureagi.com/docs/simulation Rehearse your agent on hard conversations, score each one, and fix what fails Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-scenarios https://docs.futureagi.com/docs/simulation/guides/explore-scenarios Find your way around a generated scenario: its flow, its simulator prompt, and its rows Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-scenarios/scenario-graph https://docs.futureagi.com/docs/simulation/guides/explore-scenarios/scenario-graph Read and edit the conversation flow your scenario runs, node by node Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-scenarios/add-rows https://docs.futureagi.com/docs/simulation/guides/explore-scenarios/add-rows Put more test cases in a scenario, generated from a description or typed by hand Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/run-voice-simulation https://docs.futureagi.com/docs/simulation/guides/run-voice-simulation Pick the version and provider dialing the calls, then read how they landed Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/run-chat-simulation https://docs.futureagi.com/docs/simulation/guides/run-chat-simulation Create a chat simulation in the UI, then answer it from your own code with the agent-simulate SDK Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/prompt-simulation https://docs.futureagi.com/docs/simulation/guides/prompt-simulation Run a prompt version from the Prompt Workbench through chat scenarios, without an agent definition or any code. Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/replay-chat https://docs.futureagi.com/docs/simulation/guides/replay-chat Turn a real production chat session into a scenario, then rerun it against your agent Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/replay-voice https://docs.futureagi.com/docs/simulation/guides/replay-voice Turn one production call into a run against your dev agent, then compare the two Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/fix-my-agent https://docs.futureagi.com/docs/simulation/guides/fix-my-agent Turn a finished run into a ranked list of issues and fixes, then hand off to an optimization Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/running-optimizations https://docs.futureagi.com/docs/simulation/guides/running-optimizations Open the optimization drawer from Fix My Agent, pick an algorithm, and start the run Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/optimization-runs https://docs.futureagi.com/docs/simulation/guides/optimization-runs Track an optimization run through its steps and trials, and apply the prompt that wins Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/reference/built-in-personas https://docs.futureagi.com/docs/simulation/reference/built-in-personas The 18 built-in personas and every persona field, voice and chat, with the values each accepts Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/reference/voice-providers https://docs.futureagi.com/docs/simulation/reference/voice-providers Credentials and supported features for the voice providers Simulation connects to Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/reference/call-metrics https://docs.futureagi.com/docs/simulation/reference/call-metrics Field-by-field reference for call metrics and transcript speaker roles Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/reference/sdk-api https://docs.futureagi.com/docs/simulation/reference/sdk-api Field-level reference for the SDK's callback contract and REST endpoints. Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/troubleshooting https://docs.futureagi.com/docs/simulation/troubleshooting Common simulation questions, and fixes for the errors you hit most Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/understanding-simulation https://docs.futureagi.com/docs/simulation/concepts/understanding-simulation What goes into a simulation, and how the test-and-fix loop runs Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/agent-definitions https://docs.futureagi.com/docs/simulation/concepts/agent-definitions The voice or chat agent you simulate against, and how versions keep runs comparable Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/scenarios https://docs.futureagi.com/docs/simulation/concepts/scenarios The test case a simulation runs: a situation, a flow, and the rows that fill it Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/personas https://docs.futureagi.com/docs/simulation/concepts/personas Give your test customer a personality, a voice, and a way of talking Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/runs-and-results https://docs.futureagi.com/docs/simulation/concepts/runs-and-results How a simulation executes, and what each run leaves behind to read and compare Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/replay https://docs.futureagi.com/docs/simulation/concepts/replay Reproduce a real production bug as a test, instead of guessing at a synthetic one Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/concepts/optimization https://docs.futureagi.com/docs/simulation/concepts/optimization Let an algorithm search for a better prompt when hand-fixing isn't enough Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/connect-your-agent https://docs.futureagi.com/docs/simulation/guides/connect-your-agent Create an agent definition for your voice or chat agent, and version it as you edit Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/create-scenarios https://docs.futureagi.com/docs/simulation/guides/create-scenarios Build the test cases a simulation runs, from a graph, a dataset, a script, or an SOP Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/create-personas https://docs.futureagi.com/docs/simulation/guides/create-personas Build a simulated customer persona to test your agent against Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-scenarios/add-columns https://docs.futureagi.com/docs/simulation/guides/explore-scenarios/add-columns Give a scenario's rows extra variables the simulator prompt can use Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/create-simulation https://docs.futureagi.com/docs/simulation/guides/create-simulation Bundle an agent version, scenarios, and evals into a run, then start it Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/edit-evals https://docs.futureagi.com/docs/simulation/guides/edit-evals Add, update, remove, or remap the evals scoring a run that already exists Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/evaluate-tool-calls https://docs.futureagi.com/docs/simulation/guides/evaluate-tool-calls Turn on tool call scoring for a run test, and see where the results land Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-results https://docs.futureagi.com/docs/simulation/guides/explore-results Find your way around a run's results page: the header, its tabs, and where each one leads Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-results/calls-and-transcripts https://docs.futureagi.com/docs/simulation/guides/explore-results/calls-and-transcripts Open one call and read its transcript, evals, cost, and recording Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/simulation/guides/explore-results/analytics https://docs.futureagi.com/docs/simulation/guides/explore-results/analytics Judge a whole execution at once, then line several up against each other Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/requirements https://docs.futureagi.com/docs/self-hosting/requirements System requirements and support for self-hosting Future AGI Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/installation https://docs.futureagi.com/docs/self-hosting/installation Install a self-hosted Future AGI instance with Docker Compose Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/configuration/system https://docs.futureagi.com/docs/self-hosting/configuration/system Configure the LLM gateway, PeerDB replication, and Temporal workers for your self-hosted instance. Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/configuration/environment https://docs.futureagi.com/docs/self-hosting/configuration/environment Complete .env reference for a self-hosted Future AGI instance Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/configuration/profiles https://docs.futureagi.com/docs/self-hosting/configuration/profiles Choosing which of the 31 services your self-hosted instance actually runs Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/configuration/launch-mode https://docs.futureagi.com/docs/self-hosting/configuration/launch-mode What the setup wizard checks, and how the two modes differ Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/production https://docs.futureagi.com/docs/self-hosting/production Hardening, backups, monitoring, and upgrades for a self-hosted instance Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/production/checklist https://docs.futureagi.com/docs/self-hosting/production/checklist The go-live pass before a self-hosted instance takes real traffic Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/production/security-tls https://docs.futureagi.com/docs/self-hosting/production/security-tls Terminate TLS in front of a self-hosted instance and lock down its secrets Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/production/backups-restore https://docs.futureagi.com/docs/self-hosting/production/backups-restore Back up and restore the data stores behind a self-hosted instance Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/production/monitoring https://docs.futureagi.com/docs/self-hosting/production/monitoring Watch a self-hosted instance with the health signals it actually exposes Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/production/upgrades-rollback https://docs.futureagi.com/docs/self-hosting/production/upgrades-rollback Pull a new release, run migrations, and roll back when one goes wrong Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/troubleshooting https://docs.futureagi.com/docs/self-hosting/troubleshooting Symptoms, causes, and fixes for a self-hosted instance Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting/support https://docs.futureagi.com/docs/self-hosting/support Where to get help running a self-hosted Future AGI instance Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/self-hosting https://docs.futureagi.com/docs/self-hosting Run the entire Future AGI platform on your own infrastructure with Docker Compose. Your traces, datasets, evaluations, and model calls stay inside your network Mon, 17 Aug 2026 08:46:26 GMT https://docs.futureagi.com/docs/sdk/tracing https://docs.futureagi.com/docs/sdk/tracing Set up OpenTelemetry tracing across Python, TypeScript, Java, and C#. Auto-instrument 45+ frameworks or create custom spans with FITracer. Mon, 17 Aug 2026 08:46:26 GMT