Llama API | Agents

Agents

agents

Methods

Create -> { agent_id }

post/alpha/agents/create

Parameters

X-LlamaStack-Client-Version: string

Optional

X-LlamaStack-Provider-Data: string

Optional

Response fields

agent_id: string

Request example

curl http://any-hosted-llama-stack.com/alpha/agents/create \
    -H 'Content-Type: application/json' \
    -d '{
      "agent_config": {
        "enable_session_persistence": true,
        "instructions": "instructions",
        "max_infer_iters": 0,
        "model": "model"
      }
    }'

200Example

{
  "agent_id": "agent_id"
}

Delete ->

post/alpha/agents/delete

Domain types

InferenceStep = { model_response, step_id, step_type, 3 more... }

MemoryRetrievalStep = { inserted_context, memory_bank_ids, step_id, 4 more... }

ShieldCallStep = { step_id, step_type, turn_id, 3 more... }

ToolExecutionStep = { step_id, step_type, tool_calls, 4 more... }

ToolResponse = { call_id, content, tool_name }

Agents

Session

agents.session

Methods

Create -> { session_id }

post/alpha/agents/session/create

Delete ->

post/alpha/agents/session/delete

Retrieve ->

Session

post/alpha/agents/session/get

Domain types

Session = { session_id, session_name, started_at, 2 more... }

Agents

Steps

agents.steps

Methods

Retrieve -> { step }

get/alpha/agents/step/get

Agents

Turn

agents.turn

Methods

Create ->

Turn

| { event }

post/alpha/agents/turn/create

Retrieve ->

Turn

get/alpha/agents/turn/get

Domain types

Turn = { input_messages, output_attachments, output_message, 5 more... }