> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exulu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> GraphQL types for AI agent configurations and capabilities

## agent

AI agent configurations and instances.

```graphql theme={null}
type agent {
  id: ID!
  name: String!
  description: String
  backend: String!
  type: String!
  createdAt: Date!
  updatedAt: Date!

  # Backend-specific fields
  provider: String
  providerName: String
  modelName: String
  systemInstructions: String
  authenticationInformation: String

  # Configuration
  rateLimit: RateLimiterRule
  streaming: Boolean
  capabilities: AgentCapabilities
  maxContextLength: Int

  # Workflows
  workflows: AgentWorkflows

  # Access control (if RBAC enabled)
  RBAC: RBACData

  # Routing
  slug: String
}
```

**Example query:**

```graphql theme={null}
query {
  agentById(id: "agent-123") {
    id
    name
    provider
    modelName
    capabilities {
      text
      images
      files
    }
    workflows {
      enabled
      queue {
        name
      }
    }
  }
}
```

## AgentCapabilities

Defines what content types the agent can process.

```graphql theme={null}
type AgentCapabilities {
  text: Boolean
  images: [String]    # e.g., [".png", ".jpg"]
  files: [String]     # e.g., [".pdf", ".docx"]
  audio: [String]
  video: [String]
}
```

## RateLimiterRule

Rate limiting configuration for agent requests.

```graphql theme={null}
type RateLimiterRule {
  name: String
  rate_limit: RateLimiterRuleRateLimit
}

type RateLimiterRuleRateLimit {
  time: Int    # Time window in seconds
  limit: Int   # Max requests per time window
}
```

## Related Types

<CardGroup cols={2}>
  <Card title="Session Types" icon="comments" href="/api-reference/core-types/session-types">
    Agent sessions and messages
  </Card>

  <Card title="Workflow Types" icon="workflow" href="/api-reference/core-types/workflow-types">
    Agent workflow configurations
  </Card>

  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
    View all core types
  </Card>
</CardGroup>