{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Lists sessions in which the specified agent participated, ordered by most recent activity. A session is identified by gen_ai.conversation.id and includes authorized activity from every agent in that conversation during the requested time range. Agent invocation and chat spans without a conversation ID are attributed only when their trace is associated with exactly one observed conversation.","properties":{"path":{"type":"object","properties":{"account_id":{"type":"string","description":"Your Cloudflare account ID."}},"required":["account_id"],"additionalProperties":false},"query":{"type":"object","properties":{"service":{"description":"Worker service name associated with the participating agent.","type":"string","maxLength":512,"minLength":1},"agent":{"description":"Agent name reported in gen_ai.agent.name. The request is limited to conversations in which this service and agent participated.","type":"string","maxLength":512,"minLength":1},"from":{"description":"Start of the requested time range, as Unix epoch milliseconds. Values earlier than the 7-day retention boundary are clamped.","type":"integer","minimum":0},"to":{"description":"End of the requested time range, as Unix epoch milliseconds. Must be later than from.","type":"integer","minimum":0},"cursor":{"description":"Opaque cursor from result_info.cursors.after in the previous response.","type":"string","maxLength":2048,"minLength":1},"per_page":{"description":"Maximum number of items to return. Defaults to 20 and cannot exceed 100.","type":"integer","maximum":100,"minimum":1}},"required":["service","agent","from","to"],"additionalProperties":false}},"required":["path","query"],"additionalProperties":false},"name":"List Agent sessions","id":"cloudflare.agents.sessions.list","example":{"path":{"account_id":"example"},"query":{"service":"example","agent":"example","from":1,"to":1}},"maxRequests":1,"summary":false}}