hire_agent_with_context
Hire a new specialist with full hiring context gathered from the interview. Use AFTER walking through the interview phases. The richer the context, the better the agent.
[sensitive-tier, initiates a multi-step agent process — company managers (executive/gm) run this without a card. Other members ask once; a from-now-on approval makes future calls seamless. Connecting a connector still needs the OAuth/connect card (request≠grant).]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | The specific mission this hire will achieve — be as specific as possible, include real numbers | |
| companyId | Yes | FreedomOS company id to act within (you must be a member). Required for company-scoped tools. | |
| obsession | No | The ONE demand-path KPI this agent lives or dies by (leads, enrolls, revenue, cash, customers). Not "agents activated" or team-hygiene metrics. Specific with numbers when possible (e.g., "Close the $4,200/mo freedom gap"). | |
| role_name | Yes | A descriptive role name (e.g., "YouTube Growth Specialist", "Cash Flow Analyst", "SEO Content Writer") | |
| agent_name | No | OPTIONAL. The exact display name the user explicitly asked for — a single first name (e.g. "Garth" from "name it Garth" / "call it Garth"). Set this ONLY when the user named the agent; leave unset to auto-generate a fitting name. NEVER fold the requested name into role_name. | |
| guardrails | No | What this agent should NEVER do (e.g., "Never recommend cutting product investment", "Never ignore cash runway below 3 months") | |
| first_72_hours | No | 3 demand-bound first actions (leads/enroll/outbound/content-to-market/cash/fulfillment). FORBIDDEN: placement audits, governance of inactive agents, fleet ownership maps, agent scoreboards. These become Day 1-3 tasks; hygiene shapes are stripped at write time. | |
| reports_to_name | No | Name or role of the team member this agent should report to. Use an existing team member name if one is a natural manager. Say "Linnet" for Chief of Staff, or "founder" for direct-to-founder reporting. | |
| success_metrics | Yes | Specific, measurable outcomes that define success | |
| domain_expertise | No | Role-specific domain knowledge that makes this agent an expert (frameworks, ratios, best practices specific to this role and industry) | |
| reporting_cadence | No | How often to send updates: weekly, biweekly, monthly, or realtime | |
| personality_traits | No | Communication style preferences (e.g., "direct", "data-heavy", "encouraging", "concise", "detailed analysis") | |
| required_resources | No | Tools, integrations, or data sources this agent needs. Default documents, briefs, and reports to the FreedomOS Knowledge Base (save_knowledge / read_knowledge — always available, visible in-app); list an EXTERNAL integration (e.g. Google Sheets) only when the role genuinely needs it. Do NOT list Google Docs/Sheets as a default — the agent can request a connector via request_connector and state the limitation until it is granted. | |
| context_and_resources | No | What the user has already tried, existing tools/data/resources available |