Skip to main content

agent_sessions

Conversation sessions between users and agents.
type agent_sessions {
  id: ID!
  agent: ID!
  user: ID
  name: String
  createdAt: Date!
  updatedAt: Date!
  RBAC: RBACData
}
Example query:
query {
  agent_sessionsPagination(
    limit: 20
    filters: [{ agent: { eq: "agent-123" } }]
  ) {
    items {
      id
      name
      createdAt
    }
  }
}

agent_messages

Individual messages within a session.
type agent_messages {
  id: ID!
  session: ID!
  role: String!       # "user" | "assistant" | "system"
  content: String!
  createdAt: Date!
  updatedAt: Date!
}

Usage

Sessions track conversation history between users and agents. Each session contains multiple messages with different roles:
  • user - Messages from the user
  • assistant - Responses from the AI agent
  • system - System instructions or context