Open Configure > AI Agents and choose Create Agent.
Choose an Incoming agent for inbound connections and website voice widgets, or a Flow Agent for a visual workflow.
Enter a name, first message, and system prompt. Define what the agent should do, what information it can use, and how it should handle missing information.
In Voice Provider, select an option available to your account. Provider selection controls the voice transport and compatible settings; it is separate from model selection.
Not every account sees all four options. Availability depends on administrator enablement, provider readiness, SIP engine configuration, account plan entitlements, feature flags, and your permissions. Read any unavailable reason before changing settings. Plivo is not a current production Voice Provider choice.
The names and subtitles below match the Voice Provider cards. The direction column describes phone-call capability when the required number, account access, and provider configuration are ready.
Choose a compatible model, voice, and language from the lists shown for your selected provider. Model availability is separately controlled; selecting a provider does not enable every model.
Use the model list returned by the application. OpenAI Realtime includes gpt-realtime-2.1 and gpt-realtime-2.1-mini in the current catalog; availability is controlled by active catalog entries and account access. Realtime models are separate from the language models used with ElevenLabs or Chat Agents.GPT Live 1 (gpt-live-1) is a separately gated OpenAI voice runtime with a GPT-6 Luna delegation backend. Its presence in source does not mean it is enabled for your account. Check the model selector’s unavailable reason. GPT Live SIP permits read-only tools and ending the call; actions such as transfer remain blocked where playback confirmation cannot be verified.Temperature is disabled for OpenAI Realtime voice models and for GPT Live on Realtime AI. Use supported conversation and attentiveness controls instead of assuming every provider accepts the same settings.
The supported speech catalog includes Flash v2.5, v3 Conversational, and v4 Turbo, alongside supported earlier models. v4 Turbo requires explicit administrator enablement and compatible provider access. The effective speech model comes from the saved agent setting or administrator default.Deployments using the earlier settings editor expose a Speech model control with the administrator default and models allowed for the account. The current unified settings editor does not expose that selector. If the control is absent, ask your administrator to verify the effective model rather than looking for an invented menu.Choose the language from the current provider/model-specific list. A language supported by v3 or v4 may be unavailable with Flash. Preview a voice in Configure > Tools > Voice Library, then select it on the agent. See Voice Library.When available, voice settings include stability, similarity boost, and speed. Expressive Speech and response eagerness control different behavior: expression changes delivery; eagerness changes when the agent takes its turn. v4 Turbo uses prompt guidance for audio tags; its v3 Expressive Mode switch does not apply.
Premium AI and Realtime AI use compatible Twilio phone-number configurations for supported inbound connections and outbound workflows. Premium AI via SIP uses ElevenLabs SIP for inbound and outbound calling.Realtime AI via SIP uses OpenAI SIP and supports inbound only. It does not support outbound calling. Do not select it for an outbound campaign or assume its capabilities match Premium AI via SIP.
For phone calls, configure a compatible owned number and the relevant routing before testing. Use Deploy > Phone Numbers for available rentals and Deploy > Connections for supported inbound assignments.SIP providers additionally require an enabled SIP Engine feature, plan permission for the engine, a configured trunk, a registered number, and compatible agent assignment. Follow SIP Trunks and its provider-side routing instructions. A saved agent or trunk alone does not prove that a phone route is ready. Browser Talk to Agent tests do not require a phone number.
Select existing Knowledge Base items from Configure > Knowledge Base to make them available to the agent. Depending on provider support, the editor also offers conversation style, attentiveness, language detection, maximum duration, ending behavior, transfer, appointment booking, privacy, monitoring, and guardrails.Enabling a setting does not make every channel support it. Realtime monitoring checks the ElevenLabs account used by the agent and may be unavailable. Recording and retention follow the saved provider privacy settings. Integration actions also require the connection and explicit action permissions described in Integrations.
Save the configuration, then open Configure > AI Agents > Talk to Agent. Review the configured mode, provider, model, readiness messages, credits, and any recording consent before starting. Talk to Agent is a credit-consuming Voice Only browser test; it does not validate a phone route or real external actions. A workflow Test places a phone call and has separate requirements.
Save the agent after selecting knowledge and supported conversation settings. Switching Voice Provider can change valid models, voices, languages, and capabilities; review the resulting configuration before saving again.Search the agent list, edit an agent, or open Version History to inspect and restore an earlier saved configuration. Check connections, workflows, and widgets that use an agent before deleting it. Creation limits, credits, and available actions remain subject to your plan and permissions.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Callgency","colors":{"primary":"#171717","light":"#FAFAFA","dark":"#666666"},"logo":{"light":"https://mintcdn.com/callgencyai/BxrV0SixbgixyZMD/logo/light.png?fit=max\u0026auto=format\u0026n=BxrV0SixbgixyZMD\u0026q=85\u0026s=369beef9ddd6b47998ee1fbc05968ea7","dark":"https://mintcdn.com/callgencyai/BxrV0SixbgixyZMD/logo/dark.png?fit=max\u0026auto=format\u0026n=BxrV0SixbgixyZMD\u0026q=85\u0026s=b5a11b1d4d9f4762597a172c6b0f54ec"},"favicon":"https://mintcdn.com/callgencyai/BxrV0SixbgixyZMD/favicon.ico?fit=max\u0026auto=format\u0026n=BxrV0SixbgixyZMD\u0026q=85\u0026s=470981f7a41011c793713938a2552345","appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FAFAFA","dark":"#0A0A0A"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.callgency.ai"}},"footer":{"socials":{"x":"https://x.com/callgency","linkedin":"https://linkedin.com/company/callgency","discord":"https://discord.gg/w5Z2Qpvw6c"}},"fonts":{"family":"Inter"},"styling":{"codeblocks":{"theme":{"light":"min-light","dark":"min-dark"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://callgency.ai"},{"anchor":"Discord Community","icon":"discord","href":"https://discord.gg/w5Z2Qpvw6c"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"callgencyai","hasAudioNarration":false,"actualSubdomain":"callgencyai","customDomains":["docs.callgency.ai"],"gitSource":{"type":"github","owner":"teamfyai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ad5671548dbd63c0fc236b5","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"User Guide","count":33},{"language":"default","tag":"Configure","count":16},{"language":"default","tag":"Tools","count":9},{"language":"default","tag":"Deploy","count":5},{"language":"default","tag":"Monitor","count":4},{"language":"default","tag":"API Reference","count":3},{"language":"default","tag":"API Documentation","count":3},{"language":"default","tag":"Workflows","count":3},{"language":"default","tag":"Billing","count":3},{"language":"default","tag":"Documentation Resources","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--docs-focus: #171717;--docs-code: #171717}.dark{--docs-focus: #fafafa;--docs-code: #f5f5f5}.callout{background:#f5f5f5!important;border-color:#a3a3a3!important}.callout [data-component-part=\"callout-icon\"],.callout [data-component-part=\"callout-content\"],.callout svg{color:#262626!important}.dark .callout{background:#171717!important;border-color:#737373!important}.dark .callout [data-component-part=\"callout-icon\"],.dark .callout [data-component-part=\"callout-content\"],.dark .callout svg{color:#f5f5f5!important}a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline:2px solid var(--docs-focus);outline-offset:3px}.prose a{text-decoration:underline;text-underline-offset:3px}.prose pre{overflow-x:auto}.prose pre code,pre.shiki code{font-family:\"JetBrains Mono\", Menlo, Consolas, monospace}pre.shiki{background:#f5f5f5!important}.dark pre.shiki{background:#171717!important}pre.shiki,pre.shiki span{color:var(--docs-code)!important;--shiki-dark: var(--docs-code) !important}@media (max-width: 640px){.prose table{display:block;overflow-x:auto}.prose pre{max-width:100%}}"}],"page":{"pagePath":"ai-agents","slug":"/ai-agents","pageMetadata":{"title":"AI Agents","description":"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.","href":"/ai-agents"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Info,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`An AI Agent stores the instructions and voice configuration used by your calling and browser channels.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-voice-agent`,children:`Create a voice agent`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Configure > AI Agents`}),` and choose `,_jsx(_components.strong,{children:`Create Agent`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Choose an `,_jsx(_components.strong,{children:`Incoming`}),` agent for inbound connections and website voice widgets, or a `,_jsx(_components.strong,{children:`Flow Agent`}),` for a visual workflow.`]}),`\n`,_jsx(_components.li,{children:`Enter a name, first message, and system prompt. Define what the agent should do, what information it can use, and how it should handle missing information.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`choose-a-voice-provider`,children:`Choose a Voice Provider`}),`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Voice Provider`}),`, select an option available to your account. Provider selection controls the voice transport and compatible settings; it is separate from model selection.`]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Not every account sees all four options. Availability depends on administrator enablement, provider readiness, SIP engine configuration, account plan entitlements, feature flags, and your permissions. Read any unavailable reason before changing settings. Plivo is not a current production Voice Provider choice.`})}),`\n`,_jsx(Heading,{level:`2`,id:`understand-the-provider-options`,children:`Understand the provider options`}),`\n`,_jsxs(_components.p,{children:[`The names and subtitles below match the `,_jsx(_components.strong,{children:`Voice Provider`}),` cards. The direction column describes phone-call capability when the required number, account access, and provider configuration are ready.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Voice Provider`}),_jsx(_components.th,{children:`Display subtitle`}),_jsx(_components.th,{children:`Underlying service`}),_jsx(_components.th,{children:`Phone-call direction`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Premium AI`}),_jsx(_components.td,{children:`ElevenLabs + Twilio`}),_jsx(_components.td,{children:`ElevenLabs voice with Twilio telephony`}),_jsx(_components.td,{children:`Inbound + Outbound`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Realtime AI`}),_jsx(_components.td,{children:`OpenAI + Twilio`}),_jsx(_components.td,{children:`OpenAI voice with Twilio telephony`}),_jsx(_components.td,{children:`Inbound + Outbound`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Premium AI via SIP`}),_jsx(_components.td,{children:`Inbound + Outbound`}),_jsx(_components.td,{children:`ElevenLabs SIP`}),_jsx(_components.td,{children:`Inbound + Outbound`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Realtime AI via SIP`}),_jsx(_components.td,{children:`Inbound Only`}),_jsx(_components.td,{children:`OpenAI SIP`}),_jsx(_components.td,{children:`Inbound Only`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`select-a-voice-and-model`,children:`Select a voice and model`}),`\n`,_jsx(_components.p,{children:`Choose a compatible model, voice, and language from the lists shown for your selected provider. Model availability is separately controlled; selecting a provider does not enable every model.`}),`\n`,_jsx(Heading,{level:`3`,id:`openai-voice-models`,children:`OpenAI voice models`}),`\n`,_jsxs(_components.p,{children:[`Use the model list returned by the application. OpenAI Realtime includes `,_jsx(_components.code,{children:`gpt-realtime-2.1`}),` and `,_jsx(_components.code,{children:`gpt-realtime-2.1-mini`}),` in the current catalog; availability is controlled by active catalog entries and account access. Realtime models are separate from the language models used with ElevenLabs or Chat Agents.`]}),`\n`,_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`GPT Live 1 (`,_jsx(_components.code,{children:`gpt-live-1`}),`)`]}),` is a separately gated OpenAI voice runtime with a GPT-6 Luna delegation backend. Its presence in source does not mean it is enabled for your account. Check the model selector’s unavailable reason. GPT Live SIP permits read-only tools and ending the call; actions such as transfer remain blocked where playback confirmation cannot be verified.`]}),`\n`,_jsx(_components.p,{children:`Temperature is disabled for OpenAI Realtime voice models and for GPT Live on Realtime AI. Use supported conversation and attentiveness controls instead of assuming every provider accepts the same settings.`}),`\n`,_jsx(Heading,{level:`3`,id:`elevenlabs-speech-configuration`,children:`ElevenLabs speech configuration`}),`\n`,_jsxs(_components.p,{children:[`The supported speech catalog includes `,_jsx(_components.strong,{children:`Flash v2.5`}),`, `,_jsx(_components.strong,{children:`v3 Conversational`}),`, and `,_jsx(_components.strong,{children:`v4 Turbo`}),`, alongside supported earlier models. v4 Turbo requires explicit administrator enablement and compatible provider access. The effective speech model comes from the saved agent setting or administrator default.`]}),`\n`,_jsxs(_components.p,{children:[`Deployments using the earlier settings editor expose a `,_jsx(_components.strong,{children:`Speech model`}),` control with the administrator default and models allowed for the account. The current unified settings editor does not expose that selector. If the control is absent, ask your administrator to verify the effective model rather than looking for an invented menu.`]}),`\n`,_jsxs(_components.p,{children:[`Choose the language from the current provider/model-specific list. A language supported by v3 or v4 may be unavailable with Flash. Preview a voice in `,_jsx(_components.strong,{children:`Configure > Tools > Voice Library`}),`, then select it on the agent. See `,_jsx(_components.a,{href:`/voices-library`,children:`Voice Library`}),`.`]}),`\n`,_jsx(_components.p,{children:`When available, voice settings include stability, similarity boost, and speed. Expressive Speech and response eagerness control different behavior: expression changes delivery; eagerness changes when the agent takes its turn. v4 Turbo uses prompt guidance for audio tags; its v3 Expressive Mode switch does not apply.`}),`\n`,_jsx(Heading,{level:`2`,id:`understand-inbound-and-outbound-calling`,children:`Understand inbound and outbound calling`}),`\n`,_jsx(_components.p,{children:`Premium AI and Realtime AI use compatible Twilio phone-number configurations for supported inbound connections and outbound workflows. Premium AI via SIP uses ElevenLabs SIP for inbound and outbound calling.`}),`\n`,_jsx(_components.p,{children:`Realtime AI via SIP uses OpenAI SIP and supports inbound only. It does not support outbound calling. Do not select it for an outbound campaign or assume its capabilities match Premium AI via SIP.`}),`\n`,_jsx(Heading,{level:`2`,id:`prepare-numbers-and-sip-trunks`,children:`Prepare numbers and SIP trunks`}),`\n`,_jsxs(_components.p,{children:[`For phone calls, configure a compatible owned number and the relevant routing before testing. Use `,_jsx(_components.strong,{children:`Deploy > Phone Numbers`}),` for available rentals and `,_jsx(_components.strong,{children:`Deploy > Connections`}),` for supported inbound assignments.`]}),`\n`,_jsxs(_components.p,{children:[`SIP providers additionally require an enabled SIP Engine feature, plan permission for the engine, a configured trunk, a registered number, and compatible agent assignment. Follow `,_jsx(_components.a,{href:`/sip-trunks`,children:`SIP Trunks`}),` and its provider-side routing instructions. A saved agent or trunk alone does not prove that a phone route is ready. Browser `,_jsx(_components.a,{href:`/talk-to-agent`,children:`Talk to Agent`}),` tests do not require a phone number.`]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-advanced-settings`,children:`Configure advanced settings`}),`\n`,_jsxs(_components.p,{children:[`Select existing `,_jsx(_components.a,{href:`/knowledge-base`,children:`Knowledge Base`}),` items from `,_jsx(_components.strong,{children:`Configure > Knowledge Base`}),` to make them available to the agent. Depending on provider support, the editor also offers conversation style, attentiveness, language detection, maximum duration, ending behavior, transfer, appointment booking, privacy, monitoring, and guardrails.`]}),`\n`,_jsxs(_components.p,{children:[`Enabling a setting does not make every channel support it. Realtime monitoring checks the ElevenLabs account used by the agent and may be unavailable. Recording and retention follow the saved provider privacy settings. Integration actions also require the connection and explicit action permissions described in `,_jsx(_components.a,{href:`/integrations`,children:`Integrations`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`test-with-talk-to-agent`,children:`Test with Talk to Agent`}),`\n`,_jsxs(_components.p,{children:[`Save the configuration, then open `,_jsx(_components.strong,{children:`Configure > AI Agents > Talk to Agent`}),`. Review the configured mode, provider, model, readiness messages, credits, and any recording consent before starting. `,_jsx(_components.a,{href:`/talk-to-agent`,children:`Talk to Agent`}),` is a credit-consuming `,_jsx(_components.strong,{children:`Voice Only`}),` browser test; it does not validate a phone route or real external actions. A workflow `,_jsx(_components.strong,{children:`Test`}),` places a phone call and has separate requirements.`]}),`\n`,_jsx(Heading,{level:`2`,id:`save-and-manage-agents`,children:`Save and manage agents`}),`\n`,_jsx(_components.p,{children:`Save the agent after selecting knowledge and supported conversation settings. Switching Voice Provider can change valid models, voices, languages, and capabilities; review the resulting configuration before saving again.`}),`\n`,_jsxs(_components.p,{children:[`Search the agent list, edit an agent, or open `,_jsx(_components.strong,{children:`Version History`}),` to inspect and restore an earlier saved configuration. Check connections, workflows, and widgets that use an agent before deleting it. Creation limits, credits, and available actions remain subject to your plan and permissions.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"min-light","dark":"min-dark"}},"config":{},"pageMetadata":{"title":"AI Agents","description":"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.","href":"/ai-agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create a voice agent","slug":"create-a-voice-agent","depth":2,"children":[]},{"title":"Choose a Voice Provider","slug":"choose-a-voice-provider","depth":2,"children":[]},{"title":"Understand the provider options","slug":"understand-the-provider-options","depth":2,"children":[]},{"title":"Select a voice and model","slug":"select-a-voice-and-model","depth":2,"children":[{"title":"OpenAI voice models","slug":"openai-voice-models","depth":3,"children":[]},{"title":"ElevenLabs speech configuration","slug":"elevenlabs-speech-configuration","depth":3,"children":[]}]},{"title":"Understand inbound and outbound calling","slug":"understand-inbound-and-outbound-calling","depth":2,"children":[]},{"title":"Prepare numbers and SIP trunks","slug":"prepare-numbers-and-sip-trunks","depth":2,"children":[]},{"title":"Configure advanced settings","slug":"configure-advanced-settings","depth":2,"children":[]},{"title":"Test with Talk to Agent","slug":"test-with-talk-to-agent","depth":2,"children":[]},{"title":"Save and manage agents","slug":"save-and-manage-agents","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/callgencyai/75525d29a1e4bf8f/server.js","/_mintlify/custom/callgencyai/959dfd27502bcc9d/chat-widget.js"],"subdomain":"callgencyai","siteName":"Callgency","title":"AI Agents - Callgency","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T00:40:58.052Z","originalFileLocation":"ai-agents.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Callgency\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"AI Agents - Callgency\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Callgency\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.callgency.ai/ai-agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://callgencyai.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=AI+Agents\u0026amp;description=Create+voice+agents%2C+choose+an+available+Voice+Provider%2C+and+configure+models%2C+knowledge%2C+and+conversation+settings.\u0026amp;theme=c618fe6d7bc35548f09d0d08\u0026amp;signature=ff94c03ec544e60e21e82ca389bd9f0c032bbe9e3facf53d6a31771b8afeb2fa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"AI Agents - Callgency\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://callgencyai.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=AI+Agents\u0026amp;description=Create+voice+agents%2C+choose+an+available+Voice+Provider%2C+and+configure+models%2C+knowledge%2C+and+conversation+settings.\u0026amp;theme=c618fe6d7bc35548f09d0d08\u0026amp;signature=ff94c03ec544e60e21e82ca389bd9f0c032bbe9e3facf53d6a31771b8afeb2fa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/callgencyai/E7tVFtRhxszvP29X/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Callgency\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#171717\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.callgency.ai/ai-agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai-agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.callgency.ai/#organization\",\"name\":\"Callgency\",\"url\":\"https://docs.callgency.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/callgencyai/BxrV0SixbgixyZMD/logo/light.png?fit=max\u0026auto=format\u0026n=BxrV0SixbgixyZMD\u0026q=85\u0026s=369beef9ddd6b47998ee1fbc05968ea7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.callgency.ai#website\",\"name\":\"Callgency\",\"url\":\"https://docs.callgency.ai\",\"publisher\":{\"@id\":\"https://docs.callgency.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.callgency.ai/ai-agents#webpage\",\"url\":\"https://docs.callgency.ai/ai-agents\",\"name\":\"AI Agents\",\"description\":\"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.\",\"dateModified\":\"2026-10-19T00:40:58.052Z\",\"isPartOf\":{\"@id\":\"https://docs.callgency.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.callgency.ai/ai-agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.callgency.ai/ai-agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configure\",\"item\":\"https://docs.callgency.ai/talk-to-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AI Agents\",\"item\":\"https://docs.callgency.ai/ai-agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.callgency.ai/ai-agents#article\",\"headline\":\"AI Agents\",\"name\":\"AI Agents\",\"description\":\"Create voice agents, choose an available Voice Provider, and configure models, knowledge, and conversation settings.\",\"url\":\"https://docs.callgency.ai/ai-agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.callgency.ai/ai-agents#webpage\"},\"dateModified\":\"2026-10-19T00:40:58.052Z\",\"publisher\":{\"@id\":\"https://docs.callgency.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.callgency.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Callgency\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Callgency","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://callgency.ai"},{"anchor":"Discord Community","icon":"discord","href":"https://discord.gg/w5Z2Qpvw6c"}]},"tabs":[{"tab":"User Guide","groups":[{"group":"Dashboard","pages":[{"title":"Dashboard","description":"Review call activity, contacts, campaigns, and recent conversations from your workspace home.","href":"/dashboard"}]},{"group":"Configure","pages":[{"group":"AI Agents","root":{"title":"AI Agents","href":"/ai-agents"},"pages":[{"title":"Talk to Agent","description":"Check a saved voice agent in the browser with Voice Only, consent, and explicit session controls.","href":"/talk-to-agent"}]},{"title":"Chat Agents","href":"/chat-agents"},{"title":"Knowledge Base","href":"/knowledge-base"},{"group":"Workflows","pages":[{"title":"Workflows","sidebarTitle":"My Flows","href":"/flows"},{"title":"Flow Logs","href":"/flow-logs"},{"title":"Templates","href":"/templates"}]},{"title":"Integrations","href":"/integrations"},{"group":"Tools","pages":[{"title":"Voice Library","href":"/voices-library"},{"title":"Prompt Templates","href":"/prompt-templates"},{"title":"Appointments","href":"/appointments"},{"title":"Forms","href":"/forms"},{"title":"Webhooks","href":"/webhooks"},{"title":"Custom REST API","url":"https://docs.callgency.ai/integrations#custom-rest-api","href":"/custom-rest-api-link"},{"group":"Web Widgets","root":{"title":"Web Widgets","href":"/widgets"},"pages":[{"title":"VoiceWidget Host API v1","sidebarTitle":"VoiceWidget Host API","href":"/widget-host-api"}]},{"title":"Leads","href":"/crm-leads"},{"title":"Contacts","href":"/contacts"}]}]},{"group":"Monitor","pages":[{"title":"Analytics","href":"/analytics"},{"title":"Live Calls","href":"/live-call-monitoring"},{"title":"Call Logs","href":"/calls"},{"title":"Chat Logs","href":"/chat-logs"}]},{"group":"Deploy","pages":[{"title":"Phone Numbers","href":"/phone-numbers"},{"title":"Connections","href":"/incoming-connections"},{"title":"Batch Calling","href":"/campaigns"},{"title":"SIP Trunks","href":"/sip-trunks"},{"title":"Softphone","href":"/softphone"}]},{"group":"Billing","pages":[{"title":"Plan","href":"/plan"},{"title":"Subscription","href":"/subscription"},{"title":"Transactions","href":"/transactions"}]},{"group":"Account","pages":[{"title":"Settings \u0026 Profile","href":"/settings"},{"title":"Team Management","href":"/team-management"}]},{"group":"Documentation Resources","pages":[{"title":"Welcome","href":"/index"},{"title":"Getting Started","href":"/getting-started"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"AI Agents - Callgency","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":[],"chunks":[]}