agent-configuration — Claude Code subagent: setup
agent-configuration — a reference subagent for configuring conversational agents with LLM prompts, speech input, voice output, and turn-taking rules.
AGPL-3.0 ★ 78,316 updated 2026-10-24
.claude/agents/agent-configuration.mdWhat agent-configuration does
This subagent maps the configuration used by client.conversational_ai.agents.create. It covers the opening message, language, system prompt, LLM selection, temperature, tools, and knowledge-base settings.
The configuration is split into sections for voice synthesis, speech recognition, turn handling, call behavior, voice activity detection, and language-specific overrides. TTS settings include a voice, model, speed, and expressiveness; ASR settings cover the provider, quality, keywords, and input audio format.
It assumes an API client that exposes client.conversational_ai.agents.create, so the reference alone does not create a working agent.
What it helps with
- define a
conversation_configstructure - set an LLM prompt and model
- configure speech synthesis
- tune audio transcription
- control turn timeouts and silence
Example prompts for the agent
- Configure a conversational agent with an opening message,
enlanguage, andgemini-2.0-flashas the LLM. - Set up TTS with a
voice_id,model_id, speech speed, and expressive output. - Add ASR keywords for
ElevenLabsandTechCorp, then configure turn timeouts.
How to install agent-configuration
Manually: put the files in place
.claude/agents/agent-configuration.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/agent-configuration.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/agent-configuration.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about agent-configuration
How do I install agent-configuration in Claude Code?
Place the subagent file at .claude/agents/agent-configuration.md in the project.
What does agent-configuration do?
It guides the setup of a conversational agent, including its prompt, LLM, tools, voice output, speech recognition, and turn behavior.
What API does agent-configuration use?
The configuration is built around client.conversational_ai.agents.create. It includes settings for models such as gemini-2.0-flash and eleven_flash_v2_5, plus voice and transcription options.