Appearance
Hudu Setup
Hudu is a documentation platform for MSPs. Once connected, Junto imports your Hudu documents into its knowledge base and gives the AI agent access to articles, procedures, assets, passwords (metadata only), networks, websites, and more.
Prerequisites
- A Hudu account with API access enabled
- An API key with appropriate permissions
- Your Hudu instance URL (e.g.,
https://yourcompany.huducloud.com)
Step 1: Generate an API Key
See Hudu REST API for detailed instructions.
- Log in to Hudu and navigate to Admin > API Keys.
- Create a new API key with a descriptive name (e.g., "Junto AI Integration").
- Copy the API key. It will not be shown again.
Step 2: Configure in Junto
- In Junto, go to Settings > Integrations > Hudu.
- Click Add Configuration and fill in:
- Base URL -- Your Hudu instance URL.
- API Key -- The key from Step 1. This is encrypted before storage.
- Click Create. Junto validates the connection by listing your Hudu companies.
Step 3: Map Companies
- Use the company mapping interface to link each Junto company to its Hudu company.
- Auto-map is available with exact and fuzzy name matching.
- Save mappings.
Step 4: Sync Documents to Knowledge Base
Junto can sync your Hudu articles and files into its knowledge base for AI-powered lookups during triage.
- From the Hudu settings page, click Start Sync to initiate a document sync.
- Junto exports articles (converted from HTML to searchable content) and supported file types into the knowledge base.
- Syncs run automatically on a daily schedule after the initial sync.
Supported file types: PDF, Word (.doc, .docx), Excel (.xls, .xlsx), Text (.txt), CSV, RTF, HTML, Markdown, JSON, XML.
What the AI Agent Can Do
Articles
| Tool | Description | Risk Level |
|---|---|---|
| List Articles | Search and browse company articles | Low |
| Get Article | Retrieve full article content | Low |
| Create Article | Add new knowledge base articles to Hudu | Medium |
| Update Article | Modify article content and organization | Medium |
| Archive Article | Hide articles without deleting them | High |
| Unarchive Article | Restore archived articles | Medium |
Procedures
| Tool | Description | Risk Level |
|---|---|---|
| List Procedures | Browse SOPs, runbooks, and checklists | Low |
| Get Procedure | Retrieve procedure details with tasks | Low |
| Create Procedure | Add new procedures to Hudu | Medium |
| Update Procedure | Edit procedure names and descriptions | Medium |
| Duplicate Procedure | Copy existing procedures as templates | Medium |
| Start Procedure | Kick off a procedure instance | Medium |
| Delete Procedure | Permanently remove a procedure | High |
Assets
| Tool | Description | Risk Level |
|---|---|---|
| List Assets | Browse company assets (servers, workstations, devices) with filtering | Low |
| Get Asset | Retrieve full asset details including custom fields | Low |
Asset Passwords
| Tool | Description | Risk Level |
|---|---|---|
| List Asset Passwords | Find password entries by name or company | Low |
The agent searches password entry metadata (username, URL, notes) but never sees or transmits actual password values.
Networks
| Tool | Description | Risk Level |
|---|---|---|
| List Networks | View network configurations by company | Low |
| Get Network | Retrieve network details (CIDR, VLAN, notes) | Low |
Websites
| Tool | Description | Risk Level |
|---|---|---|
| List Websites | Browse monitored websites with SSL and DNS status | Low |
| Get Website | View website monitoring configuration | Low |
| Create Website | Add a website to monitoring | Medium |
| Update Website | Adjust monitoring settings (SSL, DNS, WHOIS checks) | Medium |
| Delete Website | Remove a website from monitoring | High |
Files & Relations
| Tool | Description | Risk Level |
|---|---|---|
| List Uploads | View uploaded files with metadata | Low |
| Get Upload | Retrieve upload details | Low |
| List Relations | View relationships between Hudu entities | Low |
| Create Relation | Link assets, websites, and companies together | Medium |
| Delete Relation | Remove entity relationships | High |
Activity Logs
| Tool | Description | Risk Level |
|---|---|---|
| List Activity Logs | Audit changes by user, resource, or date range | Low |
Troubleshooting
- API key rejected -- Verify the key has not been revoked. Ensure it has the required permissions.
- No companies listed -- Ensure the API key belongs to a user with access to the target companies.
- Documents not appearing in knowledge base -- Confirm that a document sync has been run from the Hudu settings page.
- Password search returns no results -- Ensure password entries in Hudu have descriptive names, as searches query name, notes, and username fields.
- Sync status shows error -- Check the error message on the company mapping row. Common causes include expired API keys or network connectivity issues.