# Chat with Your Agent

Direct messaging interface for your agent.

## Accessing Chat

Click **Chat** in the sidebar (usually selected by default).

## Chat Interface

```
┌─────────────────────────────────────┐
│ Chat                           ⚙️  │  ← Header with settings
├─────────────────────────────────────┤
│                                     │
│  Assistant: 8:58 PM                │  ← Message history
│  System check complete...          │
│                                     │
│  You:                              │
│  Run diagnostics                   │
│                                     │
│  Assistant: 9:02 PM                │
│  ✅ Diagnostics passed             │
│                                     │
├─────────────────────────────────────┤
│ Message (↵ to send... )  [Send]   │  ← Input area
└─────────────────────────────────────┘
```

## Sending Messages

### Basic Input

1. Click in message box
2. Type your message
3. Press **Enter** or click **Send**

### Formatting

| Input           | Result                             |
| --------------- | ---------------------------------- |
| `Shift + Enter` | New line (not send)                |
| `Enter`         | Send message                       |
| Paste           | Supports text, images (if enabled) |

### Message Types

Send to your agent:

* **Text** - Questions, commands
* **Images** - Screenshots, photos (paste or upload)
* **Files** - Documents (if supported)

## Message History

### Viewing

* Scroll up to see previous messages
* Timestamps shown (e.g., "8:58 PM")
* Agent responses marked with "Assistant"

### Clearing

Click **"New session"** to start fresh conversation:

* Clears visible history
* Does not delete logs
* Useful for testing different contexts

## Use Cases

### Testing

```
You: What can you do?
Agent: [Lists capabilities]
```

### Debugging

```
You: Check your configuration
Agent: [Shows settings]
```

### Direct Commands

```
You: Restart cron jobs
Agent: [Executes command]
```

### Conversation

```
You: Summarize yesterday's logs
Agent: [Provides summary]
```

## Settings

Click **⚙️** in chat header for:

* Response preferences
* Notification settings
* Display options

## Multiple Sessions

### Main Session

Default chat channel with your agent.

### Other Sessions

If agent has multiple channels:

* Each channel has separate conversation
* View in **Sessions** section
* Switch between contexts

## Best Practices

✅ **Do**:

* Be specific in requests
* Use clear commands
* Reference specific skills if needed
* Check agent status before important tasks

❌ **Don't**:

* Send sensitive info (logs may persist)
* Spam messages (rate limits apply)
* Expect instant responses (processing time varies)

## Troubleshooting

### No Response

1. Check agent health indicator (header)
2. Verify agent is running on platform
3. Check agent wallet balance
4. Review logs for errors

### Slow Responses

* Agent may be processing complex request
* LLM API may have latency
* Check Usage tab for load

### Unexpected Responses

* Context may have changed
* Try "New session" to reset
* Check installed skills (may affect behavior)

## Keyboard Shortcuts

| Key             | Action          |
| --------------- | --------------- |
| `Enter`         | Send message    |
| `Shift + Enter` | New line        |
| `Ctrl/Cmd + A`  | Select all text |
| `Ctrl/Cmd + V`  | Paste           |

## Advanced Features

### Code Blocks

Agents can format code:

```python
print("Hello from agent")
```

### Markdown Support

Many agents support:

* **Bold**, *italic*
* `code`
* Lists (bullet, numbered)
* Links

## Integration with Other Features

Chat connects to:

* **Skills** - Invoke installed capabilities
* **Cron Jobs** - Trigger scheduled tasks
* **Channels** - See messages from Telegram/Discord
* **Logs** - Error messages appear here

## Monitoring Chat Activity

Check **Sessions** section for:

* Message volume
* Response times
* Error rates

## Security Notes

⚠️ **Chat logs may be persisted** - Don't share secrets

⚠️ **Other channels see different context** - Telegram/Discord messages are separate

## Next Steps

→ [Configure Channels](/agos/agos-cloud/agent/channels.md) to connect messaging platforms


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agos.gitbook.io/agos/agos-cloud/agent/chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.