moss-voice-agent-manager 1.0.0b2

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(
    agent_id="my-agent",
    prompt="You are a helpful AI assistant",
    voice_agent_id="voice-agent-uuid"
)

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(
    agent_id="weather-bot",
    prompt="You are a weather assistant",
    voice_agent_id="voice-agent-uuid",
    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(
    agent_id: str,              # Unique agent identifier (required)
    prompt: str,                # System prompt (required)
    voice_agent_id: str,        # Voice agent UUID (required)
    initial_greeting: str,      # Optional greeting message
    function_tools: List,       # Optional list of Python functions
    tool_refs: List[str],       # Optional importable tool references
)

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