Documentation for Future AGI — the AI lifecycle platform for building, evaluating, observing, and optimizing AI applications. https://docs.futureagi.com en Thu, 15 Oct 2026 07:58:35 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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. Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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. Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 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 Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/requirements https://docs.futureagi.com/docs/self-hosting/requirements Hardware, software, platform and port requirements for self-hosting Future AGI with Docker Compose (Standalone or Distributed) or Helm on Kubernetes. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/user-management https://docs.futureagi.com/docs/self-hosting/user-management Create accounts, invite your team, reset passwords, understand sign-in lockouts and set up single sign-on on a self-hosted Future AGI instance. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/production/checklist https://docs.futureagi.com/docs/self-hosting/production/checklist The go-live pass for a self-hosted Future AGI instance: real secrets, production mode, public URLs, pinned images, isolation, backups, managed stores. Thu, 15 Oct 2026 07:57:27 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 Future AGI instance, close its plaintext ports, keep its secrets in a manager, and isolate code evals. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/production/monitoring https://docs.futureagi.com/docs/self-hosting/production/monitoring Watch a self-hosted Future AGI instance with the signals it exposes: container health checks, health endpoints, the setup checks, and gateway metrics. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/production/upgrades-rollback https://docs.futureagi.com/docs/self-hosting/production/upgrades-rollback Upgrade a self-hosted Future AGI install to a new release, roll back a bad one, and upgrade installs made before Standalone became the default. Thu, 15 Oct 2026 07:57:27 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 Future AGI install: installer and startup errors, sign-in, LLM gateway provider URLs, PeerDB, Temporal, upgrades. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/support https://docs.futureagi.com/docs/self-hosting/support Where to get help with a self-hosted Future AGI install, what to include so the team can answer, and how to report a security vulnerability privately. Thu, 15 Oct 2026 07:57:27 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, as the Standalone setup (the default) or the Distributed setup, using the ./bin/install script. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/helm https://docs.futureagi.com/docs/self-hosting/helm Install Future AGI on Kubernetes from the signed OCI Helm chart: the Distributed topology, with evaluation and production setups, upgrades and backups. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/images https://docs.futureagi.com/docs/self-hosting/images The Future AGI images: what each runs, tags, sizes, labels, health checks, users, base images and build arguments, and how to verify one. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/configuration/launch-mode https://docs.futureagi.com/docs/self-hosting/configuration/launch-mode What the first-run setup screen checks on a new self-hosted install, how Production and Test flight report each result, and how to fix a failed check. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/configuration/system https://docs.futureagi.com/docs/self-hosting/configuration/system Route more LLM providers through the gateway, reach local model servers, and tune PeerDB replication and the Temporal workers of a self-hosted install. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/configuration/reference https://docs.futureagi.com/docs/self-hosting/configuration/reference Every environment variable of a self-hosted Future AGI install: its default in each setup, which setups read it, and what breaks when it is wrong. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/configuration/profiles https://docs.futureagi.com/docs/self-hosting/configuration/profiles Turn on optional services with COMPOSE_PROFILES: model serving and the nsjail code sandbox in Standalone, extra workers and admin UIs in Distributed. Thu, 15 Oct 2026 07:57:27 GMT https://docs.futureagi.com/docs/self-hosting/configuration/telemetry https://docs.futureagi.com/docs/self-hosting/configuration/telemetry What a self-hosted Future AGI install sends to Future AGI and to other hosts, what it never sends, and how to turn deployment telemetry off or block it. Thu, 15 Oct 2026 07:57:27 GMT