> ## 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.

# Overview

> Deploy and manage agents in production

Deploy agents through multiple channels to meet your integration needs.

<img src="https://mintcdn.com/spot-16018069/aIe-Q8xSXPJ4vFiE/images/agents/deployments.png?fit=max&auto=format&n=aIe-Q8xSXPJ4vFiE&q=85&s=83c56d62d11a5551a3a90deb71452407" alt="Agent Deployments Interface" width="1085" height="660" data-path="images/agents/deployments.png" />

## Deployment Options

<Tabs>
  <Tab title="Platform Interface" icon="browser">
    **Deploy agents directly in the Noxus platform**

    <CardGroup cols={2}>
      <Card title="Features" icon="star">
        * Web-based chat interface
        * Real-time conversation testing
        * Performance monitoring
        * Configuration management
      </Card>

      <Card title="Use Cases" icon="lightbulb">
        * Internal team assistants
        * Testing and development
        * Admin tools
        * Training and demos
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="API Integration" icon="code">
    **Integrate agents into your applications via REST API**

    <CardGroup cols={2}>
      <Card title="Features" icon="star">
        * Programmatic conversation management
        * Webhook notifications
        * Custom UI integration
        * Multi-channel deployment
      </Card>

      <Card title="Use Cases" icon="lightbulb">
        * Customer-facing chatbots
        * Mobile app integration
        * Custom interfaces
        * Multi-platform deployment
      </Card>
    </CardGroup>

    **Example:**

    ```bash theme={null}
    # Create conversation
    curl -X POST https://api.noxus.ai/v1/conversations \
      -H "Authorization: Bearer ${API_KEY}" \
      -d '{"agent_id": "agent_123"}'

    # Send message
    curl -X POST https://api.noxus.ai/v1/conversations/conv_456/messages \
      -H "Authorization: Bearer ${API_KEY}" \
      -d '{"content": "Hello, I need help"}'
    ```
  </Tab>

  <Tab title="SDK Integration" icon="python">
    **Embed agents in Python applications**

    <CardGroup cols={2}>
      <Card title="Features" icon="star">
        * Type-safe Python interface
        * Async/await support
        * Streaming responses
        * Event handling
      </Card>

      <Card title="Use Cases" icon="lightbulb">
        * Python applications
        * Data science workflows
        * Backend services
        * Automation scripts
      </Card>
    </CardGroup>

    **Example:**

    ```python theme={null}
    from noxus_sdk.client import Client

    client = Client(api_key="your_api_key")

    # Create conversation
    conversation = client.conversations.create(
        agent_id="agent_123",
        name="Support Session"
    )

    # Chat with agent
    response = conversation.chat("How do I reset my password?")
    print(response.content)

    # Stream responses
    for chunk in conversation.chat_stream("Tell me more"):
        print(chunk.content, end="", flush=True)
    ```
  </Tab>

  <Tab title="Chat Widget" icon="message-square">
    **Add pre-built chat widget to your website**

    <CardGroup cols={2}>
      <Card title="Features" icon="star">
        * Drop-in JavaScript widget
        * Customizable styling
        * Mobile responsive
        * Conversation persistence
      </Card>

      <Card title="Use Cases" icon="lightbulb">
        * Website chat support
        * Product assistance
        * Lead qualification
        * Customer engagement
      </Card>
    </CardGroup>

    **Example:**

    ```html theme={null}
    <script>
      window.NOXUS_WIDGET_URL = "https://app.noxus.ai";
      window.NOXUS_ASSISTANT_ID = "your_assistant_id";
      window.NOXUS_GROUP_ID = "your_group_id";
    </script>
    <script src="https://app.noxus.ai/embed.js"></script>
    ```
  </Tab>

  <Tab title="Integrations" icon="plug">
    **Deploy agents to messaging platforms**

    Connect your agent to popular messaging and collaboration tools so users can interact with it where they already work.

    <CardGroup cols={2}>
      <Card title="Slack" icon="slack" href="/platform/agents/deployments/slack">
        Deploy your agent to Slack channels and DMs. Respond to mentions, direct messages, and participate in group conversations.
      </Card>

      <Card title="Microsoft Teams" icon="microsoft">
        Bring your agent into Microsoft Teams channels and chats for enterprise collaboration.
      </Card>

      <Card title="WhatsApp" icon="whatsapp">
        Connect your agent to WhatsApp for customer communication through the world's most popular messaging app.
      </Card>

      <Card title="Telegram" icon="telegram">
        Deploy your agent as a Telegram bot for lightweight, fast interactions with users.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

## Agent Configuration

<Tabs>
  <Tab title="Model Selection">
    **Choose the right model for your use case:**

    | Model                                   | Best For                          | Performance           |
    | :-------------------------------------- | :-------------------------------- | :-------------------- |
    | **GPT-4 / Claude Opus / Gemini Ultra**  | Complex reasoning, critical tasks | ⭐⭐⭐⭐⭐ Highest quality |
    | **GPT-4o / Claude Sonnet / Gemini Pro** | Balanced performance, general use | ⭐⭐⭐⭐ Great balance    |
    | **GPT-3.5 / Mistral / Gemini Flash**    | Simple tasks, high volume         | ⭐⭐⭐ Fast & economical |
  </Tab>

  <Tab title="Performance Settings">
    **Fine-tune agent behavior:**

    | Setting         | Range       | Purpose                                            |
    | :-------------- | :---------- | :------------------------------------------------- |
    | **Temperature** | 0.0 - 1.0   | Control creativity (0.0 = focused, 1.0 = creative) |
    | **Max Tokens**  | 100 - 4000+ | Set response length limits                         |
    | **Timeout**     | 10s - 300s  | Maximum execution time                             |
    | **Streaming**   | On/Off      | Enable real-time response streaming                |
  </Tab>

  <Tab title="Resource Limits">
    **Control usage and costs:**

    **Conversation Limits:**

    * Maximum messages per conversation
    * Token budget per conversation
    * Time-based expiration
    * Concurrent conversation limits

    **Rate Limits:**

    * Requests per minute
    * Requests per hour
    * Daily request caps
    * Per-user limits
  </Tab>
</Tabs>

## Past Chats

Track and review all conversations with your agent. Past Chats provides a searchable table of conversation history.

**Available Information:**

* **Date created**: When the conversation started
* **Conversation title**: Name or topic of the conversation
* **Version**: Agent version used for the conversation
* **Started by**: User who initiated the conversation
* **Last message**: Timestamp of the most recent message

**Filtering & Search:**

* Search conversations by content or title
* Filter by time period (All time, Last 7 days, Last 30 days, etc.)
* Sort by date created or last message timestamp

Click any conversation to view the full message history, including agent responses and tool usage.

## Best Practices

<Steps>
  <Step title="Start Simple">
    Begin with basic configuration, add complexity as needed
  </Step>

  <Step title="Test Thoroughly">
    Test agents with various scenarios before production
  </Step>

  <Step title="Monitor Performance">
    Track metrics and optimize continuously
  </Step>

  <Step title="Set Clear Limits">
    Define resource and cost limits upfront
  </Step>

  <Step title="Implement Fallbacks">
    Handle errors and edge cases gracefully
  </Step>

  <Step title="Review Regularly">
    Review conversation logs and update instructions
  </Step>

  <Step title="Collect Feedback">
    Act on user feedback to improve agent performance
  </Step>
</Steps>

<Card title="Agent Tools" icon="wrench" href="/platform/agents/tools">
  Configure tools and capabilities for your agents
</Card>