aidroid

This tool helps you deploy and export AI agents using configuration files, making it easier to work with various AI service providers. Other advantages;

• Improved collaboration - Beeing able to collaborate on changes before they are applied & review them
• Auditability - Who changed what & when
• Testability - Being able to deploy changes to dedicated test account & test them before they are applied in production
• Reduced vendor lock-in - Ability to transfer all data to another vendor if needed

Providers supported currently:

• retell
• vapi

Installation

npm install aidroid

Environment Variables

Before using the tool, make sure to set up the required environment variables:

• RETELL_API_KEY: Your Retell API key (required for Retell provider)
• VAPI_API_KEY: Your Vapi API key (required for Vapi provider)

Available Commands

Import

Import data to a specified provider:

aidroid import <file>

File needs to be in YAML format. You're able to use the -dir property to create a configuration file per agent:

# yaml-language-server: $schema=https://aidroid.mdekker.net/schemas/schema.json
provider: retell

voice-agent-dir: agents

Example of an agent configuration store in the agents subfolder:

# yaml-language-server: $schema=https://aidroid.mdekker.net/schemas/voice-agent.json
name: English Inbound
model: gpt-4o-mini
prompt: >-
  ##🎙️ "Jan's" personality:

  - Friendly, polite, professional, and clear.

  - His statements are brief and precise, yet natural and human.

  - Conveys competence and understanding.
begin_message: >-
  Hello, this is Jan from the Garage. Thank you for your call. How can I help
  you?
language: en-US
voice_provider: vapi
voice_id: Elliot

If you're using vscode, its recommend to use the YAML extension for better validation & autocomplete.

Export

Export agents from a specified provider to a local YAML file:

aidroid export <provider>

The exported agents will be saved to agents.yml in the current directory.

License

MIT