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

# Agents

> AI assistants that help automate tasks through natural conversation

<video controls loop preload="metadata">
  <source src="https://mintcdn.com/spot-16018069/GSdjXE6hvFMwIRlK/videos/coworker_video.mp4?fit=max&auto=format&n=GSdjXE6hvFMwIRlK&q=85&s=f620f2c00b42945e3140af18962f915f" type="video/mp4" data-path="videos/coworker_video.mp4" />
</video>

## What is an Agent?

An agent in Noxus is a visual AI assistant built by connecting capabilities into a conversational interface. Agents enable:

* **Natural Language Processing**: Process requests naturally, maintain context, and adapt to user needs
* **Tool Integration**: Access web research, human-in-the-loop, knowledge bases, flow execution, and file handling capabilities.
* **Context Awareness**: Remember conversation history and maintain context across interactions
* **Smart Decision Making**: Make intelligent choices based on context and available tools

## Configuration Options

Agents provide extensive configuration options to customize their
behavior, performance, and capabilities according to your specific needs.

<CardGroup cols={1}>
  <Card title="Model Settings" icon="sliders-horizontal" href="#model-settings">
    **AI Engine Control**: Configure how your agent thinks and responds
  </Card>

  <Card title="Conversation Control" icon="message-square-lock" href="#conversation-control">
    **Resource Management**: Manage usage limits and conversation flow
  </Card>

  <Card title="Tool Access" icon="wrench" href="#tool-access">
    **Capability Definition**: Define available tools and integrations
  </Card>
</CardGroup>

### Model Settings

Configure how your agent thinks and responds using our AI model settings to achieve the perfect balance of creativity, accuracy, and performance.

**Core Configuration Options:**

* **Model Selection**: Choose from various providers like OpenAI, Anthropic, and others.
* **Temperature**: Control response creativity (0.0 for focused, 1.0 for creative)
* **Max Tokens**: Set response length limits
* **Response Style**: Configure tone and formatting preferences
* **Instructions**: Define system guidance and allowed behaviors to steer responses and restrict access

<Note>
  Each provider offers unique capabilities and specializations. Learn more about
  available models in our [Models & Providers guide](/core/concepts/models).
</Note>

### Conversation Control

Manage how your agent handles conversations and resources to optimize performance while maintaining cost-effectiveness.

**Resource and Flow Control:**

* **Token Management**: Define usage budgets and per-conversation limits
* **Rate Limiting**: Set maximum request frequency to control throughput
* **Agent Timeout**: Define maximum execution time per request to prevent long-running operations
* **Generation Control**: Set safeguards like max output length, stop sequences, and sensitivity levels
* **Error Recovery**: Configure retry and fallback behaviors

### Tool Access

Agents can access various tools to enhance their capabilities, with each tool configurable for specific roles and requirements.

**Enhanced Functionality:**

* **Web Research**: Search and analyze online information
* **Knowledge Bases**: Query your organization's knowledge repositories
* **Flow Execution**: Run automated processes and workflows
* **File Operations**: Handle document processing and management
* **API Integration**: Connect with external services
* **Human Handoff**: Escalate to human operators when needed

<Warning>
  Tools can be enabled or disabled based on your agent's specific role and
  requirements. Each tool can be configured with its own permissions and usage
  limits.
</Warning>

## Reasoning Capabilities

| Level      | Description                                      |
| :--------- | :----------------------------------------------- |
| **Off**    | Direct responses without additional analysis     |
| **Low**    | Basic reasoning for simple decision-making       |
| **Medium** | Detailed analysis considering multiple factors   |
| **High**   | Comprehensive reasoning with thorough evaluation |

<Warning>
  Reasoning capabilities are available only with select AI models that support
  advanced reasoning features. Agents using these models can adjust their
  reasoning depth based on task complexity, allowing you to balance performance
  with computational requirements for optimal results.
</Warning>

## Running Agents

Each agent operates in its own secure environment, maintaining
conversation context and managing its own resources for optimal performance
and security.

Choose how to deploy and interact with your agents based on your specific integration needs:

<Tabs>
  <Tab title="🖥️ Platform Interface">
    The platform interface provides the most intuitive way to interact with your agents:

    * Real-time conversations with monitoring capabilities
    * Dynamic settings and configuration adjustments with live testing
    * Comprehensive analytics and conversation history
    * Direct management of knowledge base connections
    * Tool permissions and capability control

    <Note>
      Ideal for testing, training, and day-to-day agent management with full visibility into performance metrics.
    </Note>
  </Tab>

  <Tab title="🔌 API Integration">
    Our [REST API](/api-reference/introduction) enables complete integration into your existing systems:

    * Programmatic conversation lifecycle management
    * Fine-grained configuration control
    * Real-time performance metrics access
    * Synchronous and asynchronous operations
    * Custom integration scenarios support

    <Info>
      Perfect for building customer service platforms, internal automation
      systems, and custom applications with full programmatic control.
    </Info>
  </Tab>

  <Tab title="⚡ SDK Implementation">
    The Noxus [SDK](/sdk/api-reference/introduction) empowers sophisticated application development:

    * Custom chat interfaces with brand matching
    * Type-safe access to all agent capabilities
    * Built-in lifecycle management and event processing
    * Custom tool integrations and specialized interfaces
    * Accelerated development with best practices

    <Note>
      Enables developers to focus on application logic while leveraging the full
      power of agents with enterprise-grade reliability.
    </Note>
  </Tab>
</Tabs>

## Next Steps

* Learn about [Knowledge Bases](/core/concepts/knowledge-bases)
* Explore [Flows](/core/concepts/flows)