.svg)
Co-worker
AI-powered co-workers that help users accomplish tasks through natural language
Co-workers are referred to as agents in the API/SDK
Co-workers are AI-powered entities that help users accomplish tasks through natural language conversations. They combine language understanding, knowledge retrieval, reasoning capabilities and the ability to execute complex tasks through flows, in order to provide helpful responses and execution actions.
Co-workers serve as the primary interface between users and the AI capabilities of the platform, making complex functionality accessible through simple conversations.
Key Capabilities
Natural Language Understanding
Co-workers comprehend user queries in natural language, understanding intent, context, and nuance.
Knowledge Integration
Connect co-workers to Knowledge Bases to provide them with domain-specific information and context.
Contextual Memory
Co-workers maintain conversation history to provide coherent, contextually relevant responses across multiple turns.
Workflow Execution
Trigger and execute workflows based on user requests, enabling complex automation through simple instructions.
Conversing with Co-workers
Interacting with co-workers through the API follows a structured flow that enables natural, contextual conversations. Understanding this flow helps you build effective co-worker integrations.
Conversation Flow
Create a Conversation
Start by creating a new conversation with the co-worker using the Create Conversation endpoint.
This establishes a conversation context that will maintain history and state throughout the interaction.
Send User Message
Add the user’s initial message to the conversation using the Add Message endpoint.
The message should contain a clear request or question to get the most helpful response.
Receive Co-worker Response
The co-worker processes the message and generates a response, which is automatically added to the conversation.
Retrieve the updated conversation with the Get Conversation endpoint to see the co-worker’s response.
Continue the Conversation
Add follow-up messages using the Add Message endpoint.
The co-worker maintains context from previous messages, enabling natural back-and-forth dialogue.
Managing Conversations
Effective conversation management involves several key operations:
- Listing Conversations: View all conversations using the List Conversations endpoint
- Retrieving History: Get complete conversation history with the Get Conversation endpoint
- Refreshing Responses: Generate updated responses to previous messages with the Refresh Message endpoint
- Ending Conversations: Remove conversations when no longer needed using the Delete Conversation endpoint
Rate limits may apply to conversation API endpoints. Implement appropriate retry logic and respect rate limit headers in responses.
Available Tools
Co-workers can be equipped with specialized tools that extend their capabilities beyond basic conversation. Each tool enables specific functionality that can be activated during conversations.
Web Research
Enables the co-worker to search the web in real-time to find current information, answer factual questions, and provide up-to-date insights on topics outside its training data.
Noxus Q&A
Provides specialized knowledge about the Noxus platform, helping users understand features, workflows, and best practices for using the system effectively.
Knowledge Base Q&A
Connects the co-worker to a specific pre-selected Knowledge Base, allowing it to answer questions using your organization’s proprietary information and documents.
Knowledge Base Selector
Gives users the flexibility to choose which Knowledge Base the co-worker should reference during the conversation, ideal for organizations with multiple knowledge domains.
Workflow Runner
Allows the co-worker to execute predefined workflows, collecting necessary parameters through natural conversation and returning results directly in the chat.
Coming Soon
Additional toolsets and Model Context Protocol (MCPs) integration coming soon to further extend co-worker capabilities.
Tool Capabilities
Web Research Tool
The Web Research tool transforms co-workers into real-time information gatherers by:
- Live Web Searches: Performing searches across the internet to find current information
- Content Extraction: Analyzing web pages to extract relevant information
- Source Verification: Evaluating the reliability of sources before presenting information
- Citation Provision: Including links to original sources for verification
- Summarization: Condensing lengthy web content into concise, relevant answers
This tool is particularly valuable for questions about current events, recent developments, or topics that may have changed since the co-worker’s knowledge cutoff.
Web research capabilities may be limited by your subscription tier and organization settings. The tool respects website terms of service and may not be able to access content behind paywalls or login screens.
Noxus Q&A Tool
The Noxus Q&A tool provides specialized knowledge about the Noxus platform itself:
- Platform Documentation: Answers questions using the official Noxus documentation
- Workflow Guidance: Explains how to build workflows and use different nodes
- Feature Explanations: Provides details on platform capabilities like image generation or web searching
- Contextual Help: Maintains conversation history to provide consistent, relevant assistance
This tool is ideal for questions like “How can I build a workflow?”, “What node can I use to read from a PDF?”, or “How can I generate an image?” It helps users understand and navigate the Noxus platform without needing to consult external documentation.
Knowledge Base Tools
The platform offers powerful Knowledge Base integration through specialized tools:
Knowledge Base Q&A Tool
This tool connects to your organization’s Knowledge Bases to answer questions using your proprietary information:
- Document-Based Answers: Generates responses based on content from your Knowledge Base documents
- Multi-Format Support: Works with various document types including PDFs, text files, and images
- Source Citations: Provides document references with specific page numbers when available
- Visual Content Analysis: Can process and reference images contained in documents
- Confidence Indicators: Includes warnings when information might not be sufficient
The tool uses advanced retrieval techniques to find the most relevant information across your documents, then synthesizes clear, focused answers to your questions with proper attribution to sources.
Knowledge Base Selector Tool
This tool allows users to dynamically choose which Knowledge Base to query during a conversation:
- Flexible Selection: Choose the most appropriate Knowledge Base for each question
- Domain Switching: Easily move between different knowledge domains as conversation topics change
- Contextual Awareness: Maintains conversation flow while switching knowledge sources
- Transparent Operation: Clearly indicates which Knowledge Base is being used for each answer
This flexibility is particularly valuable for organizations with multiple Knowledge Bases covering different subject areas or departments.
Workflow Runner Tool
The Workflow Runner tool bridges conversation and automation:
- Natural Language Triggering: Executes workflows based on conversational requests
- Parameter Collection: Gathers required inputs through intuitive dialogue
- Execution Monitoring: Tracks workflow progress and reports status
- Result Presentation: Formats workflow outputs in a conversational context
- Error Handling: Explains issues and suggests corrections when workflows fail
This tool enables users to initiate complex automated processes through simple conversation, without needing to understand the technical details of workflow implementation.
Best Practices
Co-worker Configuration
For optimal co-worker performance:
- Clear Purpose: Define a specific purpose for each co-worker
- Tool Selection: Enable only the tools that are relevant to the co-worker’s purpose
- Knowledge Selection: Connect relevant Knowledge Bases that match the co-worker’s domain
- Custom Instructions: Provide detailed instructions about how the co-worker should behave
- Regular Updates: Keep Knowledge Bases current to ensure accurate information
Co-worker Configuration
Co-workers can be configured with various settings to customize their behavior and capabilities. Understanding these configuration options helps you create co-workers that are tailored to specific use cases.
Core Settings
When configuring an Co-worker, you can adjust several fundamental parameters:
Model Selection
Choose which AI models power your co-worker. You can select from performance-optimized or cost-optimized model configurations.
Temperature
Control the creativity and randomness of responses. Lower values (0.0-0.4) produce more consistent, focused answers, while higher values encourage more creative responses.
Custom Instructions
Provide specific guidance on how the co-worker should behave, what tone to use, and any particular response patterns to follow.
Tool Selection
Enable or disable specific tools based on the co-worker’s intended purpose and the capabilities it needs.
Tool Configuration
Each tool can be individually configured with specific settings to customize its behavior:
The name and description of each tool are included in the co-worker’s instructions and play a crucial role in tool selection. Clear, descriptive names and detailed descriptions help the co-worker understand when and how to use each tool appropriately during conversations.
Web Research Tool
| Parameter | Description |
|---|---|
| Enabled/Disabled | Turn the web research capability on or off |
| Custom Instructions | Provide specific guidance for how web research should be conducted |
| Name | Customize the display name of the tool (affects when the co-worker chooses to use this tool) |
| Description | Modify the tool’s description (helps the co-worker understand the tool’s purpose and capabilities) |
Noxus Q&A Tool
| Parameter | Description |
|---|---|
| Enabled/Disabled | Turn the platform documentation capability on or off |
| Custom Instructions | Provide specific guidance for how platform questions should be answered |
| Name | Customize the display name of the tool |
| Description | Modify the tool’s description for users |
Knowledge Base Q&A Tool
| Parameter | Description |
|---|---|
| Knowledge Base Selection | Connect to a specific pre-selected Knowledge Base |
| Enabled/Disabled | Turn the Knowledge Base Q&A capability on or off |
| Custom Instructions | Provide specific guidance for how KB questions should be answered |
| Name | Customize the display name of the tool |
| Description | Modify the tool’s description for users |
Knowledge Base Selector Tool
| Parameter | Description |
|---|---|
| Initial Selection | Optionally pre-select a Knowledge Base or leave unselected |
| Enabled/Disabled | Turn the Knowledge Base selection capability on or off |
| Custom Instructions | Provide specific guidance for KB selection and question answering |
| Name | Customize the display name of the tool |
| Description | Modify the tool’s description for users |
Workflow Runner Tool
| Parameter | Description |
|---|---|
| Workflow Selection | Connect to specific workflows that the co-worker can execute |
| LLM Follow-up | Configure whether the co-worker should provide additional context after workflow execution |
| Enabled/Disabled | Turn the workflow execution capability on or off |
| Custom Instructions | Provide specific guidance for workflow execution |
| Name | Customize the display name of the tool |
| Description | Modify the tool’s description for users |
Configuration Best Practices
For optimal co-worker performance:
- Focused Tool Selection: Only enable tools that are relevant to the co-worker’s purpose
- Clear Instructions: Provide detailed custom instructions for both the co-worker and individual tools
- Appropriate Temperature: Use lower temperature (0.1-0.3) for factual co-workers and higher (0.4-0.7) for creative ones
- Knowledge Base Alignment: Connect Knowledge Bases that contain information relevant to the co-worker’s domain
- Regular Updates: Review and update co-worker configurations as your needs evolve
Enabling too many tools can make an co-worker less focused. Consider creating multiple specialized co-workers rather than a single co-worker with all possible tools.