Agent Development Overview

ZUVU Marketplace Agent Developer Guide!

🔨 High level architecture, simple by design:

%%{init: {'theme': 'base', 'themeVariables': { 'background': '#f5f5f5' }}}%%
flowchart LR
    subgraph "Agent (Docker Container)"
        E["/chat Entrypoint"]
    end

    R[Client] <-->|SendsMessagePayload && Streams Response| E 
    linkStyle 0 stroke:#fff
    
    style E fill:#f9f9f9,stroke:#666
    style R fill:#f0f0f0,stroke:#999

🎯 Agent Requirements (The Important Bits!):

🔌 Must have an HTTP endpoint that returns a stream (Default: /chat)
📦 Must be packaged as Docker images (Because portability is cool!)

📋 Must accept and validate message payload against this schema:

type MessagePayload = {
  input: string;
  history: Array<{
    role: 'agent' | 'user';
    content: string;
  }>;
  config?: Record<string, unknown>;
}

const EXAMPLE  = {
  input: "Tell me the weather from the past 10 days?", // Your awesome question!
  history: [
    {
      role: agent | user  // Who's talking?
      content: "",        // What's being said!
    }
  ]
  config: {
  ...run level config ie. max_tokens, context, // The fun stuff!
  }
}

💡 Pro Tip: Configuration at the run level gives you amazing control! But remember, always set those default values - they're your safety net!