| name | voice-agent |
| display-name | AI Voice Agent Backend |
| version | 1.0.0 |
| description | Local Voice Input/Output for Agents using the AI Voice Agent API. |
| author | trevisanricardo |
| homepage | https://github.com/ricardotrevisan/ai-conversational-skill |
| user-invocable | true |
| disable-model-invocation | false |
Voice Agent
This skill allows you to speak and listen to the user using the local Voice Agent API.
Behavior Guidelines
- Audio First: When the user communicates via audio (files), your PRIMARY mode of response is Audio File.
- Silent Delivery: When sending an audio response, DO NOT send a text explanation like "I sent an audio". Just send the audio file.
- Workflow:
- User sends audio.
- You usage
transcribe to read it.
- You think of a response.
- You usage
synthesize to generate the audio file.
- You send the file.
- STOP. Do not add text commentary.
Tools
Transcribe File
To transcribe an audio file (Speech-to-Text), run the client script with the transcribe command.
python3 {baseDir}/scripts/client.py transcribe "/path/to/audio/file.ogg"
Synthesize to File
To generate audio from text and save it to a file (Text-to-Speech), run the client script with the synthesize command.
python3 {baseDir}/scripts/client.py synthesize "Text to speak" --output "/path/to/output.mp3"
Health Check
To check if the voice agent API is running and healthy:
python3 {baseDir}/scripts/client.py health
Service Management
If the Health Check fails or you receive a connection error, the service may be stopped.
You can attempt to start it by running:
{baseDir}/scripts/start.sh