Struct ToolkitService

pub struct ToolkitService { /* private fields */ }

A service that manages and runs a Toolkit.

Example

let mut service = ToolkitService::new("UNIFAI_TOOLKIT_API_KEY");

let info = ToolkitInfo {
    name: "Echo Slam".to_string(),
    description: "What's in, what's out.".to_string(),
};

service.update_info(info).await.unwrap();

service.add_action(EchoSlam);

let runner = service.start().await.unwrap();
let _ = runner.await.unwrap();

Implementations

impl ToolkitService

pub fn new(api_key: &str) -> Self

Create a Toolkit service with Unifai API Key.

Examples found in repository

examples/echo_toolkit.rs (line 70)

async fn main() {
    tracing_subscriber::fmt().init();

    let unifai_toolkit_api_key =
        env::var("UNIFAI_TOOLKIT_API_KEY").expect("UNIFAI_TOOLKIT_API_KEY not set");

    let mut service = ToolkitService::new(&unifai_toolkit_api_key);

    let info = ToolkitInfo {
        name: "Echo Slam".to_string(),
        description: "What's in, what's out.".to_string(),
    };

    service.update_info(info).await.unwrap();

    service.add_action(EchoSlam);

    let runner = service.start().await.unwrap();
    let _ = runner.await.unwrap();
}

pub async fn update_info(&self, info: ToolkitInfo) -> Result<(), ToolkitError>

Update Toolkit’s name and description.

Examples found in repository

examples/echo_toolkit.rs (line 77)

async fn main() {
    tracing_subscriber::fmt().init();

    let unifai_toolkit_api_key =
        env::var("UNIFAI_TOOLKIT_API_KEY").expect("UNIFAI_TOOLKIT_API_KEY not set");

    let mut service = ToolkitService::new(&unifai_toolkit_api_key);

    let info = ToolkitInfo {
        name: "Echo Slam".to_string(),
        description: "What's in, what's out.".to_string(),
    };

    service.update_info(info).await.unwrap();

    service.add_action(EchoSlam);

    let runner = service.start().await.unwrap();
    let _ = runner.await.unwrap();
}

pub fn add_action(&mut self, action: impl Action + 'static)

Add an action that implements the Action trait to be registered when starting.

Examples found in repository

examples/echo_toolkit.rs (line 79)

async fn main() {
    tracing_subscriber::fmt().init();

    let unifai_toolkit_api_key =
        env::var("UNIFAI_TOOLKIT_API_KEY").expect("UNIFAI_TOOLKIT_API_KEY not set");

    let mut service = ToolkitService::new(&unifai_toolkit_api_key);

    let info = ToolkitInfo {
        name: "Echo Slam".to_string(),
        description: "What's in, what's out.".to_string(),
    };

    service.update_info(info).await.unwrap();

    service.add_action(EchoSlam);

    let runner = service.start().await.unwrap();
    let _ = runner.await.unwrap();
}

pub async fn start( self, ) -> Result<JoinHandle<Result<(), ToolkitError>>, ToolkitError>

Start the Toolkit service asynchronously.

Once the service is ready, it returns a JoinHandle that keeps the service alive.

Examples found in repository

examples/echo_toolkit.rs (line 81)

async fn main() {
    tracing_subscriber::fmt().init();

    let unifai_toolkit_api_key =
        env::var("UNIFAI_TOOLKIT_API_KEY").expect("UNIFAI_TOOLKIT_API_KEY not set");

    let mut service = ToolkitService::new(&unifai_toolkit_api_key);

    let info = ToolkitInfo {
        name: "Echo Slam".to_string(),
        description: "What's in, what's out.".to_string(),
    };

    service.update_info(info).await.unwrap();

    service.add_action(EchoSlam);

    let runner = service.start().await.unwrap();
    let _ = runner.await.unwrap();
}