# agent-configuration

agent-configuration — a reference subagent for configuring conversational agents with LLM prompts, speech input, voice output, and turn-taking rules.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/agent-configuration.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/agent-configuration

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/agent-configuration.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/agent-configuration.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/agent-configuration.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/agents/references/agent-configuration.md

## When to use it
- define a `conversation_config` structure
- set an LLM prompt and model
- configure speech synthesis
- tune audio transcription
- control turn timeouts and silence

## Example prompts
- Configure a conversational agent with an opening message, `en` language, and `gemini-2.0-flash` as the LLM.
- Set up TTS with a `voice_id`, `model_id`, speech speed, and expressive output.
- Add ASR keywords for `ElevenLabs` and `TechCorp`, then configure turn timeouts.

## Similar
- [agents](https://affpapa.org/en/nevibecode/skills/agents.md) — skill · 14700 installs
- [bailian-gen](https://affpapa.org/en/nevibecode/skills/bailian-gen.md) — skill · 9400 installs
- [nemotron-speech](https://affpapa.org/en/nevibecode/skills/nemotron-speech.md) — skill · 2100 installs
- [twilio-voice-conversation-relay](https://affpapa.org/en/nevibecode/skills/twilio-voice-conversation-relay.md) — skill · 1 install
- [three.ws Audio](https://affpapa.org/en/nevibecode/mcp/threews-audio.md) — MCP server · ★ 284 repo stars
- [Talkies](https://affpapa.org/en/nevibecode/mcp/talkies.md) — MCP server · ★ 7 repo stars

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
