foundry-agents

name	foundry-agents
description	Query and inspect Foundry prompt agents and invoke Foundry tools via the Responses API. OpenClaw is the orchestrator — Foundry provides managed AI services.
metadata	{"openclaw":{"requires":{"env":["FOUNDRY_PROJECT_ENDPOINT"]},"primaryEnv":"FOUNDRY_PROJECT_ENDPOINT"}}

Foundry Services — Agent Tools via Responses API

OpenClaw is the agent orchestrator. Foundry provides managed AI services that OpenClaw agents can use via the Responses API. You do NOT create Foundry agents — you call Foundry tools directly.

Endpoint

All requests: http://localhost:8443 with ?api-version=2025-11-15-preview. Auth is automatic.

Calling Foundry Tools via Responses API

Code Interpreter (run Python)

curl -s -X POST 'http://localhost:8443/openai/responses?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4.1","input":"Calculate fibonacci(20) using Python","tools":[{"type":"code_interpreter","container":{"type":"auto"}}],"store":false}'

Web Search (Bing grounding)

curl -s -X POST 'http://localhost:8443/openai/responses?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4.1","input":"What are the latest Rust language features?","tools":[{"type":"bing_grounding"}],"store":false}'

Memory Search (cross-session recall)

curl -s -X POST 'http://localhost:8443/openai/responses?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4.1","input":"What beverage does the user prefer?","tools":[{"type":"memory_search","memory_store_name":"kars-memory","scope":"default"}],"store":false}'

Querying Foundry Infrastructure

List existing agents in the project

curl -s 'http://localhost:8443/agents?api-version=2025-11-15-preview'

List model deployments

curl -s 'http://localhost:8443/deployments?api-version=2025-11-15-preview'

When to use

• Call Foundry tools (code interpreter, web search, memory) via Responses API
• Inspect what Foundry agents or models exist in the project
• Use Foundry as a service layer for OpenClaw agent capabilities

When NOT to use

• Do NOT create Foundry agents — OpenClaw is the agent orchestrator
• For memory CRUD operations (use foundry-memory skill)
• For simple chat completions (use /v1/chat/completions directly)