register()
Register the current agent with MeshAI. Must be called before start_heartbeat() or track_usage().
agent = client.register(
framework="crewai",
model_provider="openai",
model_name="gpt-4o",
description="Summarizes customer support tickets",
team="support-team",
tags={"env": "production", "version": "1.2.0"},
)
Agent framework: crewai, langchain, autogen, openai, anthropic, custom
LLM provider: openai, anthropic, google, nvidia, bedrock
Model identifier (e.g., gpt-4o, claude-sonnet-4-20250514)
Human-readable description of what the agent does
Team or project that owns this agent (used for cost attribution)
id, name, status, and all metadata.
list_agents()
List all agents in your tenant.
agents = client.list_agents(
status="healthy",
framework="crewai",
limit=50,
offset=0,
)
Filter by status: healthy, degraded, down, unknown
Number of results per page
Number of results to skip
get_agent()
Get a single agent by ID.
agent = client.get_agent("agt_abc123")
{
"id": "agt_abc123",
"name": "production-summarizer",
"description": "Summarizes customer support tickets",
"framework": "crewai",
"model_provider": "openai",
"model_name": "gpt-4o",
"environment": "production",
"status": "healthy",
"team": "support-team",
"risk_level": "limited",
"last_heartbeat": "2026-03-17T10:30:00Z",
"created_at": "2026-03-01T08:00:00Z"
}
update_agent()
Update an agent’s metadata.
updated = client.update_agent(
"agt_abc123",
description="Summarizes and categorizes support tickets",
model_name="gpt-4o-mini",
tags={"version": "1.3.0"},
)
Updated tags (merges with existing)
delete_agent()
Delete an agent. The agent is removed from the active registry but remains in the audit trail.
client.delete_agent("agt_abc123")
Deleting an agent is irreversible. The agent’s historical data (cost, anomalies, audit events) is preserved but the agent can no longer send heartbeats or telemetry.
