> ## 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.
# Companies
> Manage tenant relationships and deploy agents across connections
## 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.
## 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.
## Add or edit a company
Go to **Companies** and select **Add company**.
Choose **Supplier**, **Channel**, or **Both**.
Add the company name, optional logo, tenant description, and relationship description.
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.
## 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.
In the **Agent Configs** column, click **Add Agent** for the relationship.
Search for an available parent agent and select it. Maadify only shows active parent agents that are available for the selected relationship.
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.
Review the tools the agent uses and fix any tool configuration issues before saving.
Click **Add Agent Config**. The agent appears as a badge in the relationship row.
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.
### 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.
### 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.
## 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.