Plugin Development Kit (PDK)

The PRX PDK is a Rust crate qui fournit the types, traits, et macros needed to build PRX plugins. It handles serialization, host function bindings, et le plugin lifecycle.

Installation

Add to your Cargo.toml:

[dependencies]
prx-pdk = "0.1"

Core Traits

Tool

Le trait Tool est utilise pour enregistrer de nouveaux outils that l'agent can call:

use prx_pdk::prelude::*;

#[prx_tool(
    name = "weather",
    description = "Get current weather for a location"
)]
fn weather(location: String) -> Result<String, PluginError> {
    let resp = http_get(&format!("https://api.weather.com/{}", location))?;
    Ok(resp.body)
}

Channel

The Channel trait adds new messaging channels:

use prx_pdk::prelude::*;

#[prx_channel(name = "my-chat")]
struct MyChatChannel;

impl Channel for MyChatChannel {
    fn send(&self, message: &str) -> Result<(), PluginError> { /* ... */ }
    fn receive(&self) -> Result<Option<String>, PluginError> { /* ... */ }
}

Filter

Le trait Filter traite les messages avant ou apres le LLM:

use prx_pdk::prelude::*;

#[prx_filter(stage = "pre")]
fn content_filter(message: &str) -> Result<FilterAction, PluginError> {
    // Return FilterAction::Pass or FilterAction::Block
}

Types

The PDK exports common types: PluginError, FilterAction, ToolResult, ChannelMessage, and PluginConfig.

Voir aussi Pages

• Developer Guide
• Host Functions
• Examples