azure_ai_foundry_core

Core types, authentication, and HTTP client for the Azure AI Foundry Rust SDK.

This crate provides the foundational building blocks used by all other azure_ai_foundry_* crates.

Features

• FoundryClient — HTTP client with builder pattern (get, post, delete, post_multipart, get_bytes)
• FoundryCredential — Authentication via API key or Microsoft Entra ID
• FoundryError — Typed error handling with thiserror
• Retry logic — Automatic retries with exponential backoff for transient errors
• Tracing — Full instrumentation with tracing spans
• Security — HTTPS validation, error sanitization, token refresh hardening

Installation

[dependencies]
azure_ai_foundry_core = "0.8"
tokio = { version = "1", features = ["full"] }

Usage

API Key Authentication

use azure_ai_foundry_core::client::FoundryClient;
use azure_ai_foundry_core::auth::FoundryCredential;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = FoundryClient::builder()
        .endpoint("https://your-resource.services.ai.azure.com")
        .credential(FoundryCredential::api_key("your-api-key"))
        .build()?;
    Ok(())
}

Microsoft Entra ID Authentication

use azure_ai_foundry_core::client::FoundryClient;
use azure_ai_foundry_core::auth::FoundryCredential;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = FoundryClient::builder()
        .endpoint("https://your-resource.services.ai.azure.com")
        .credential(FoundryCredential::developer_tools()?)
        .build()?;
    Ok(())
}

Environment Variables

The SDK automatically checks these environment variables:

export AZURE_AI_FOUNDRY_ENDPOINT="https://your-resource.services.ai.azure.com"
export AZURE_AI_FOUNDRY_API_KEY="your-key"  # Falls back to Entra ID if not set

use azure_ai_foundry_core::client::FoundryClient;
use azure_ai_foundry_core::auth::FoundryCredential;

# fn main() -> Result<(), Box<dyn std::error::Error>> {
let endpoint = std::env::var("AZURE_AI_FOUNDRY_ENDPOINT")?;
let client = FoundryClient::builder()
    .endpoint(endpoint)
    .credential(FoundryCredential::from_env()?)
    .build()?;
# Ok(())
# }

Modules

Related Crates

• azure_ai_foundry_models — Chat completions and embeddings
• azure_ai_foundry_agents — Agent Service (agents, threads, runs, files, vector stores)
• azure_ai_foundry_tools — Vision and Document Intelligence

License

This project is licensed under the MIT License.