Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maadify.com/llms.txt

Use this file to discover all available pages before exploring further.

What companies represent

Companies are tenants connected to your organization. A company relationship controls which tenant is connected, what direction the relationship uses, which parent agents are available, and how the agent tools are configured for that relationship. Relationship types are shown from your tenant’s perspective:
  • Supplier: your tenant acts as the channel, and the connected company is the supplier.
  • Channel: your tenant acts as the supplier, and the connected company is the channel.
  • Both: Maadify creates relationships in both directions.
  • My Workspace: the relationship is inside your own tenant.
The Companies page shows the partner, relationship type, and deployed agent configurations. Agent badges show whether an agent is active, hidden for the partner, or inactive.
Companies list showing partners, relationship badges, and agent configuration badges

Review company relationships

Use the Companies table to search, sort, and manage relationships. You can:
  • Search for a relationship by company name.
  • Sort by Channel Name or Supplier Name.
  • Toggle Show Inactive Relationships to review deactivated relationships.
  • Open View / Edit when you own or manage the relationship.
  • Open View Users when you have permission to manage users for the partner tenant.
  • Use Copy Relationship when another owned tenant has a relationship you want to copy into your tenant.
  • Deactivate, reactivate, or remove relationships when you have permission.
Companies page with search sort inactive toggle and relationship actions menu

Add or edit a company

1

Create the tenant

Go to Companies and select Add company.
2

Set the relationship type

Choose Supplier, Channel, or Both.
3

Enter company details

Add the company name, optional logo, tenant description, and relationship description.
4

Save and verify

Click Add Company. The company appears in the table with the selected relationship.
You can open the company details page.
When you edit an existing company, you can update the company details and relationship description. If a relationship only exists in one direction, you can also add the missing channel or supplier relationship to make it bidirectional.
Add Company dialog with relationship type company name logo and descriptions

Deploy agents to a relationship

Deploying an agent to a company relationship creates an agent configuration for that channel and supplier pair. This controls whether the parent agent can be used for the relationship and what tool settings apply when it runs. Agents are deployed from the Agent Configs column.
1

Open Add Agent

In the Agent Configs column, click Add Agent for the relationship.
2

Select a parent agent

Search for an available parent agent and select it. Maadify only shows active parent agents that are available for the selected relationship.
3

Review visibility settings

Use Hide Parent Agent when the partner should not be able to use the agent. Use Hide Configuration View when the partner should not see the agent configuration.
4

Configure tools

Review the tools the agent uses and fix any tool configuration issues before saving.
5

Save the deployment

Click Add Agent Config. The agent appears as a badge in the relationship row.
Add Agent dialog showing searchable parent agent cards
If the relationship or partner tenant is inactive, configured agents cannot be accessed from that tenant.

Configure relationship tools

After you select a parent agent for a relationship, the dialog shows the tools the agent can use.
  • Sub Agent Tools are tools available to sub-agents. You can configure relationship-specific defaults for these tools.
  • Execution Tools are tools configured directly on the parent agent. You can review their schemas and examples from the relationship dialog.
Sub-agent tools show a status badge:
  • Configured means the tool is ready for the relationship.
  • Needs Configuration means required values or defaults are missing.
The agent configuration cannot be saved while tools have configuration errors.
Agent relationship dialog showing Sub Agent Tools and Execution Tools tabs

Sub-agent tool defaults

Use sub-agent tool configuration when a tool needs different values for a specific company relationship. For example, you may need a partner-specific account ID, environment, warehouse, or filter. When editing a tool, you can:
  • Review whether the tool is shared.
  • Use Use Default Tool Owner Config when the tool owner’s connector defaults should apply.
  • Override configurable fields when your tenant owns the tool and has permission.
  • Save the tool configuration before saving the agent deployment.
Company relationship tool configuration showing default owner config and configurable fields

Execution tool schemas

Use Execution Tools to review tools that run on the parent agent. You can open a tool to inspect:
  • Input Schema
  • Input Example
  • Output Schema
  • Output Example
These schemas help you understand what the parent agent can send to the tool and what the tool can return during the workflow.
Execution tool details showing input and output schema tabs

Manage deployed agents

Click an existing agent badge to edit its relationship deployment. From the edit dialog, you can:
  • Update visibility settings:
    • Hide Parent Agent prevents the company from using the agent. You, as the owner, can still run it.
    • Hide Configuration View hides the agent’s configuration from the company while still letting them use the agent.
  • Review and update relationship-specific tool configuration.
  • Inspect execution tool schemas.
  • Remove the agent configuration from the relationship.
Removing an agent configuration does not remove the shared tools from connectors.

Relationship lifecycle

Relationships and tenants have separate lifecycle controls.
  • Deactivate Relationship prevents agents configured for that relationship from being accessed. You can reactivate the relationship later.
  • Remove Relationship removes the tenant relationship and its agent configurations and shared tools.
  • Deactivate Tenant prevents users associated with that tenant from logging in and accessing system configurations.
  • Re-enable Tenant restores tenant access.
Deactivate a relationship when you want to pause access but keep the setup. Remove a relationship only when the connection and its agent configurations are no longer needed.