moss-voice-agent-manager 1.0.0b3

Python SDK for managing and deploying voice agents to Moss platform

Moss Voice Agent Manager

Python SDK for managing and deploying voice agents using the Moss platform.

Installation

pip install moss-voice-agent-manager

Or install from source:

cd python-sdk
pip install -e .

Quick Start

1. Get Your Credentials

You need three pieces of information:

1. MOSS_PROJECT_ID - Your project UUID
2. MOSS_PROJECT_KEY - Your project read key
3. MOSS_VOICE_AGENT_ID - Voice agent UUID to deploy to

2. Simple Deployment

from moss_voice_agent_manager import MossVoiceClient

# Create client
client = MossVoiceClient(
    project_id="your-project-uuid",
    project_key="your-project-read-key"
)

# Deploy agent
response = client.deploy(
    voice_agent_id="voice-agent-uuid",
    prompt="You are a helpful AI assistant"
)

print(f"Deployed to: {response.deployment_url}")

3. Deploy with Custom Tools

def get_weather(city: str) -> str:
    """Get weather for a city."""
    return f"Weather in {city} is sunny"

response = client.deploy(
    voice_agent_id="voice-agent-uuid",
    prompt="You are a weather assistant",
    function_tools=[get_weather]
)

Environment Variables

Set these for easier testing:

export MOSS_PROJECT_ID="your-project-uuid"
export MOSS_PROJECT_KEY="your-project-read-key"
export MOSS_VOICE_AGENT_ID="voice-agent-uuid"

API Reference

MossVoiceClient

client = MossVoiceClient(
    project_id: str,        # Your Moss project ID (required)
    project_key: str,       # Your Moss project key (required)
    timeout: int            # Request timeout in seconds (default: 300)
)

deploy()

response = client.deploy(
    voice_agent_id: str,        # Voice agent UUID (required)
    prompt: str,                # System prompt (required)
    initial_greeting: str,      # Optional greeting message
    function_tools: List,       # Optional list of Python functions
    tool_refs: List[str],       # Optional importable tool references
    project_name: str           # Optional project name
)

Returns DeploymentResponse:

• ok: bool - Success flag
• project_name: str - Project name
• deployment_url: str - URL to view in dashboard
• cli_stdout: str - Deployment logs
• cli_stderr: str - Error logs if any
• error: str - Error message if failed

Requirements

• Python 3.9+
• No external dependencies (uses standard library)

License

MIT

Support

For issues and questions, visit: https://github.com/your-org/python-sdk