​
Overview

The fetch_agent function retrieves a specific AI agent by its unique identifier.

​
Function Signature

pub async fn fetch_agent(agent_id: &str) -> Result<AiAgent>

​
Parameters

​
agent_id
&str
required
The unique identifier of the agent to retrieve

​
Return Value

Returns Result<AiAgent> containing the agent details.

​
Basic Usage

use wacht::api::agents::*;

let agent = fetch_agent("52057194421551105").await?;
println!("Agent: {} ({})", agent.name, agent.id);
println!("Description: {}", agent.description);
println!("Active: {}", agent.is_active);

​
Error Handling

match fetch_agent("52057194421551105").await {
    Ok(agent) => {
        println!("Found agent: {}", agent.name);
        println!("Type: {}", agent.agent_type);
        println!("Model: {}", agent.model);
        if let Some(instructions) = agent.instructions {
            println!("Instructions: {}", instructions);
        }
    }
    Err(Error::Api { status, message, .. }) => {
        match status.as_u16() {
            404 => println!("Agent not found"),
            403 => println!("Access denied: {}", message),
            _ => println!("API error {}: {}", status, message),
        }
    }
    Err(e) => println!("Request failed: {}", e),
}

​
Rate Limits

  • Get operations: 1000 requests per minute
  • Burst limit: 50 requests per second