Llama API | Agents › Turn

Agents

agents

Methods

Create -> { agent_id }

post/alpha/agents/create

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

Parameters

X-LlamaStack-Client-Version: string

Optional

X-LlamaStack-Provider-Data: string

Optional

Response fields

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

AgentTurnResponseStreamChunk = { event }

Request example

curl http://any-hosted-llama-stack.com/alpha/agents/turn/create \
    -H 'Content-Type: application/json' \
    -d '{
      "agent_id": "agent_id",
      "messages": [
        {
          "content": "string",
          "role": "user"
        }
      ],
      "session_id": "session_id"
    }'

Retrieve ->

Turn

get/alpha/agents/turn/get

Domain types

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