{ "id": "{AGENT_ID}", "name": "Adder", "description": "Adds two numbers and returns the total", "icon": "{BASE64_ICON}", "categories": ["numerical_computation"], "status": "active", "isNew": true, "isPopular": false, "versionId": "{AGENT_VERSION_ID}", "groupId": null}
Register a Custom Agent in the marketplace under your organization.The agent is authored at the organization level, so it is not bound to a workspace and is not runnable until it is connected into one. Returns the agent id, which you pass to Update an Agent.Requires the Agent: Full permission at organization level.
Every agent created here is a Custom Agent. There is no agentClass field to set — the class is pinned, and blueprint must carry the prompts the agent runs with.
There is no provider call to make first. Your organization’s agent provider is created on demand on your first agent, and providerId is not accepted in the body.
Headers
string
required
Your API authentication key
Body Parameters
The agent is nested under an agent key.
object
required
The agent to create. Fields below.
string
required
Agent display name. Maximum 255 characters.
string
required
Agent icon as a base64-encoded SVG (or PNG) — a plain string, with no data: prefix. Maximum 65535 characters.
object
required
The agent implementation: the prompts the agent runs with, plus the model that runs them. See Blueprint. Maximum 256KB JSON-encoded.
string[]
required
Categories the agent is filed under in the marketplace. Maximum 5 entries. See Categories.
string
What the agent does, shown under its name. Maximum 2048 characters.
object
The agent’s input schema, keyed by each variable’s variableName. Maximum 100 entries and 512KB JSON-encoded. See Variable object.
object
The agent’s output schema, keyed by each variable’s variableName. Same shape and limits as inputs.
string
default:"active"
Agent status — active, inactive, soon or deprecated.
boolean
default:"true"
Show the “new” badge on the agent tile.
boolean
default:"false"
Show the “popular” badge on the agent tile.
boolean
default:"false"
Show the “beta” badge on the agent tile. Accepted on create but not echoed back in the response.
Your organization is always taken from the API key — it cannot be set in the body. Nothing here is workspace-scoped.
Blueprint
The prompts the agent runs with.
string
required
System prompt the agent runs with. Must be non-empty.
string
required
User prompt template. Must be non-empty. Reference the agent’s inputs with {{variableName}}.
string
Model the agent runs on, for example gpt-4o. Must be one the platform routes to — see Models and providers.
string
Provider of that model, for example openai. Must agree with the model when both are given.
string
Model to fall back to. Validated the same way as model.
string
Provider of the fallback model. Validated the same way as provider.
systemPrompt and userPrompt may be sent in either camelCase or snake_case (system_prompt, user_prompt). A blueprint missing either one, or carrying an empty or whitespace-only value for it, is rejected with 400.
Apart from the prompts and these two pairs, blueprint is forwarded untouched and stored verbatim — nothing else in it is validated structurally beyond its encoded size. The fields above are a base, not a ceiling: extra fields are kept, and unrecognised keys are forwarded exactly as they arrived. The documented camelCase keys are renamed to the agent service’s snake_case at the boundary.
Models and providers
model and provider are checked before the agent is created, and the same rules apply to backupModel and backupProvider. Both pairs are accepted in either casing (backup_model, backup_provider).A model is accepted when the platform’s model registry knows it, or when its name begins with a prefix belonging to a provider the platform routes to — gpt-, o followed by a digit, and chatgpt for openai, claude for anthropic, gemini for google. The prefix fallback means a model released before the registry catches up is still accepted, so claude-opus-9-future passes while llama-3-70b-instruct does not.When both a model and a provider are given, the provider must be the one that model actually runs on — { "model": "gpt-4o", "provider": "anthropic" } is rejected.Each pair is checked only when it names a model or a provider. A blueprint that names neither is accepted as it stands.
Providers
A provider named on its own, with no model beside it, must be one of these. Anything else — mistral, say — is rejected.
Provider
Routes to
openai
GPT models, called directly
anthropic
Claude models, called directly
google
Gemini models
bedrock
Claude and GPT models through AWS Bedrock, ids prefixed bedrock/
compass
GPT models through Compass, ids prefixed compass/
custom_openai
Custom OpenAI-compatible endpoints. Not offered in the app’s model picker
custom_anthropic
Custom Anthropic-compatible endpoints. Not offered in the app’s model picker
Commonly used models
A sample of the current lineup, not the whole of it — the registry moves with the platform, and this page will lag it. The model picker in the Opus app is the live list.
model
provider
Shown in the app as
gpt-5.6-terra
openai
GPT 5.6 Terra
gpt-5.2
openai
GPT 5.2
gpt-4o
openai
GPT 4o
claude-opus-5
anthropic
Claude Opus 5
claude-sonnet-5
anthropic
Claude Sonnet 5
claude-haiku-4-5-20251001
anthropic
Claude Haiku 4.5
gemini-3.5-flash
google
Gemini 3.5 Flash
gemini-2.5-pro
google
Gemini 2.5 Pro
bedrock/claude-opus-5
bedrock
Claude Opus 5 (Bedrock)
compass/gpt-5.1
compass
GPT 5.1 (Compass)
Models reached through Bedrock or Compass carry the provider in the id itself, and the two halves must agree. { "model": "bedrock/claude-sonnet-5", "provider": "bedrock" } is accepted; the same model named bare, as { "model": "claude-sonnet-5", "provider": "bedrock" }, resolves to anthropic and is rejected.
Variable object
Each value inside inputs and outputs. The map key must equal the variable’s variableName.
string
required
Stable identifier for the variable, unique within the schema. Maximum 255 characters.
string
required
Programmatic key. Must equal the key this entry sits under. Maximum 255 characters.
object[]
required
Value types this variable accepts. Between 1 and 11 entries. Each has a type — one of int, float, bool, str, object, file, array, date, binary, json_string, node — plus optional typeDefinition and typeDefinitionEnforced.
string
Human-readable label rendered in the workflow builder. Maximum 255 characters. When omitted, the agent service applies its own default.
string
Description shown next to the variable in the builder. Maximum 2048 characters.
any
default:"null"
Pre-filled default value. Its type must match one of allowedTypes.
boolean
default:"false"
When true, the workflow may leave this variable unset.
object[]
Annotations the builder uses for grouping and filtering, each { variableName, value, description }. Maximum 20.
any[]
Enum-style choice list. When non-empty the builder renders a dropdown. Each entry is free-form JSON. Maximum 20.
string
Which of allowedTypes is currently active. Must be one of them — consumers fall back to the first entry when unset.
string[]
Fields the builder locks, preventing the workflow author from changing them — any of variable_name, display_name, description, is_nullable, tags, options, allowed_types. Maximum 20.
boolean
default:"true"
When false, the builder hides the “remove variable” affordance.
For composite types, typeDefinition describes the shape inside: a nested variable map for object, a single nested variable for array, or a date format string for date. Omit it for scalars. Set typeDefinitionEnforced to hold the workflow author to it exactly.
Categories
One to five of: parsing_and_serialization, validation_and_normalization, transformation_and_mapping, aggregation_and_analysis, numerical_computation, statistical_computation, optimization_and_search, text_processing, document_and_ocr_processing, media_processing, control_flow_and_orchestration, state_and_caching, io_and_storage, networking_and_apis, security_and_identity.
Owning workspace, or null when the agent is visible across the marketplace.
Errors
Bad Request
Invalid body — a missing required field, a value over its limit, more than 5 categories, a blueprint without a non-empty systemPrompt and userPrompt, a blueprint naming a model or provider the platform cannot route to, or an inputs/outputs entry that is not a valid variable.
Unauthorized
Missing, invalid, or expired API key.
Forbidden
The API key is not org-scoped, or the key owner lacks the Agent: Full permission in the organization.
Unprocessable Entity
Rejected downstream after passing validation here — most often an organization that is not verified to publish to the marketplace.
{ "id": "{AGENT_ID}", "name": "Adder", "description": "Adds two numbers and returns the total", "icon": "{BASE64_ICON}", "categories": ["numerical_computation"], "status": "active", "isNew": true, "isPopular": false, "versionId": "{AGENT_VERSION_ID}", "groupId": null}
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Opus Docs","description":"Welcome to the Opus Developer Hub, where you can learn more about building on the Opus platform.","colors":{"primary":"#2B5DDC","light":"#4A7AE8","dark":"#2B5DDC"},"logo":{"light":"https://mintcdn.com/appliedai-7127e5be/wVwGgyXIDQyL0wYc/images/light-logo.svg?fit=max\u0026auto=format\u0026n=wVwGgyXIDQyL0wYc\u0026q=85\u0026s=48326fd6749a2f78fa038e3460082611","dark":"https://mintcdn.com/appliedai-7127e5be/wVwGgyXIDQyL0wYc/images/dark-logo2.svg?fit=max\u0026auto=format\u0026n=wVwGgyXIDQyL0wYc\u0026q=85\u0026s=c54f70c148f8c84e4e26bcd6c138d0ca","href":"https://developer.opus.com"},"favicon":{"light":"https://mintcdn.com/appliedai-7127e5be/wVwGgyXIDQyL0wYc/images/opus-logo-black.svg?fit=max\u0026auto=format\u0026n=wVwGgyXIDQyL0wYc\u0026q=85\u0026s=67d85bd5b1728b436ffd8f1aed7e3569","dark":"https://mintcdn.com/appliedai-7127e5be/wVwGgyXIDQyL0wYc/images/opus-logo-white.svg?fit=max\u0026auto=format\u0026n=wVwGgyXIDQyL0wYc\u0026q=85\u0026s=0a31436012d29178b51969a0d34b86f9"},"api":{"playground":{"display":"interactive"}},"appearance":{"default":"dark"},"background":{"decoration":"grid","color":{"light":"#f9f9f9","dark":"#020202"}},"navbar":{"links":[{"href":"https://www.opus.com/blog/2026-enterprise-ais-make-or-break-year","label":"Blog"},{"href":"mailto:support@opus.com","label":"Support "},{"href":"https://status.opus.com/","label":"Status"}]},"footer":{"socials":{"x":"https://x.com/AppliedAICo","linkedin":"https://www.linkedin.com/company/appliedaico","discord":"https://discord.com/invite/M5nBqhkUYH","youtube":"https://www.youtube.com/@AppliedAICo","website":"https://opus.com"}},"search":{"prompt":"Search or Ask Opus Docs..."},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"appliedai-7127e5be","hasAudioNarration":false,"actualSubdomain":"appliedai-7127e5be","customDomains":["developer.opus.com"],"gitSource":{"type":"github","owner":"aaico","repo":"opus-dev-docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00519c89d041245afe7c9d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":51},{"language":"default","tag":"Release Notes","count":36},{"language":"default","tag":"Releases","count":36},{"language":"default","tag":"Guides","count":24},{"language":"default","tag":"Deprecated","count":18},{"language":"default","tag":"Workflows","count":15},{"language":"default","tag":"Tasks","count":14},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Cases","count":7},{"language":"default","tag":"Node Reference","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/v1-agent/create-agent","slug":"/api-reference/v1-agent/create-agent","pageMetadata":{"title":"Create an Agent","api":"POST https://operator.opus.com/api/v1/agent","description":"Register a Custom Agent with its prompts and IO schema","href":"/api-reference/v1-agent/create-agent"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Register a Custom Agent with its prompts and IO schema\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Register a `,_jsx(_components.a,{href:`/tasks/agent/custom-agent`,children:`Custom Agent`}),` in the marketplace under your organization.`]}),`\n`,_jsxs(_components.p,{children:[`The agent is authored at the organization level, so it is not bound to a workspace and is not runnable until it is connected into one. Returns the agent `,_jsx(_components.code,{children:`id`}),`, which you pass to `,_jsx(_components.a,{href:`/api-reference/v1-agent/update-agent`,children:`Update an Agent`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Requires the `,_jsx(_components.strong,{children:`Agent: Full`}),` permission at organization level.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Every agent created here is a Custom Agent. There is no `,_jsx(_components.code,{children:`agentClass`}),` field to set — the class is pinned, and `,_jsx(_components.code,{children:`blueprint`}),` must carry the prompts the agent runs with.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`There is no provider call to make first. Your organization’s agent provider is created on demand on your first agent, and `,_jsx(_components.code,{children:`providerId`}),` is not accepted in the body.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-service-key`,type:`string`,required:true,id:`param-x-service-key`,children:_jsx(_components.p,{children:`Your API authentication key`})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsxs(_components.p,{children:[`The agent is nested under an `,_jsx(_components.code,{children:`agent`}),` key.`]}),`\n`,_jsx(ParamField,{body:`agent`,type:`object`,required:true,id:`param-agent`,children:_jsx(_components.p,{children:`The agent to create. Fields below.`})}),`\n`,_jsx(ParamField,{body:`agent.name`,type:`string`,required:true,id:`param-agent-name`,children:_jsx(_components.p,{children:`Agent display name. Maximum 255 characters.`})}),`\n`,_jsx(ParamField,{body:`agent.icon`,type:`string`,required:true,id:`param-agent-icon`,children:_jsxs(_components.p,{children:[`Agent icon as a base64-encoded SVG (or PNG) — a plain string, with no `,_jsx(_components.code,{children:`data:`}),` prefix. Maximum 65535 characters.`]})}),`\n`,_jsx(ParamField,{body:`agent.blueprint`,type:`object`,required:true,id:`param-agent-blueprint`,children:_jsxs(_components.p,{children:[`The agent implementation: the prompts the agent runs with, plus the model that runs them. See `,_jsx(_components.a,{href:`#blueprint`,children:`Blueprint`}),`. Maximum 256KB JSON-encoded.`]})}),`\n`,_jsx(ParamField,{body:`agent.categories`,type:`string[]`,required:true,id:`param-agent-categories`,children:_jsxs(_components.p,{children:[`Categories the agent is filed under in the marketplace. Maximum 5 entries. See `,_jsx(_components.a,{href:`#categories`,children:`Categories`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.description`,type:`string`,id:`param-agent-description`,children:_jsx(_components.p,{children:`What the agent does, shown under its name. Maximum 2048 characters.`})}),`\n`,_jsx(ParamField,{body:`agent.inputs`,type:`object`,id:`param-agent-inputs`,children:_jsxs(_components.p,{children:[`The agent’s input schema, keyed by each variable’s `,_jsx(_components.code,{children:`variableName`}),`. Maximum 100 entries and 512KB JSON-encoded. See `,_jsx(_components.a,{href:`#variable-object`,children:`Variable object`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.outputs`,type:`object`,id:`param-agent-outputs`,children:_jsxs(_components.p,{children:[`The agent’s output schema, keyed by each variable’s `,_jsx(_components.code,{children:`variableName`}),`. Same shape and limits as `,_jsx(_components.code,{children:`inputs`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.status`,type:`string`,default:`active`,id:`param-agent-status`,children:_jsxs(_components.p,{children:[`Agent status — `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`inactive`}),`, `,_jsx(_components.code,{children:`soon`}),` or `,_jsx(_components.code,{children:`deprecated`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.isNew`,type:`boolean`,default:`true`,id:`param-agent-is-new`,children:_jsx(_components.p,{children:`Show the “new” badge on the agent tile.`})}),`\n`,_jsx(ParamField,{body:`agent.isPopular`,type:`boolean`,default:`false`,id:`param-agent-is-popular`,children:_jsx(_components.p,{children:`Show the “popular” badge on the agent tile.`})}),`\n`,_jsx(ParamField,{body:`agent.isBeta`,type:`boolean`,default:`false`,id:`param-agent-is-beta`,children:_jsx(_components.p,{children:`Show the “beta” badge on the agent tile. Accepted on create but not echoed back in the response.`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Your organization is always taken from the API key — it cannot be set in the body. Nothing here is workspace-scoped.`})}),`\n`,_jsx(Heading,{level:`2`,id:`blueprint`,children:`Blueprint`}),`\n`,_jsx(_components.p,{children:`The prompts the agent runs with.`}),`\n`,_jsx(ParamField,{body:`systemPrompt`,type:`string`,required:true,id:`param-system-prompt`,children:_jsx(_components.p,{children:`System prompt the agent runs with. Must be non-empty.`})}),`\n`,_jsx(ParamField,{body:`userPrompt`,type:`string`,required:true,id:`param-user-prompt`,children:_jsxs(_components.p,{children:[`User prompt template. Must be non-empty. Reference the agent’s inputs with `,_jsx(_components.code,{children:`{{variableName}}`}),`.`]})}),`\n`,_jsx(ParamField,{body:`model`,type:`string`,id:`param-model`,children:_jsxs(_components.p,{children:[`Model the agent runs on, for example `,_jsx(_components.code,{children:`gpt-4o`}),`. Must be one the platform routes to — see `,_jsx(_components.a,{href:`#models-and-providers`,children:`Models and providers`}),`.`]})}),`\n`,_jsx(ParamField,{body:`provider`,type:`string`,id:`param-provider`,children:_jsxs(_components.p,{children:[`Provider of that model, for example `,_jsx(_components.code,{children:`openai`}),`. Must agree with the model when both are given.`]})}),`\n`,_jsx(ParamField,{body:`backupModel`,type:`string`,id:`param-backup-model`,children:_jsxs(_components.p,{children:[`Model to fall back to. Validated the same way as `,_jsx(_components.code,{children:`model`}),`.`]})}),`\n`,_jsx(ParamField,{body:`backupProvider`,type:`string`,id:`param-backup-provider`,children:_jsxs(_components.p,{children:[`Provider of the fallback model. Validated the same way as `,_jsx(_components.code,{children:`provider`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`systemPrompt`}),` and `,_jsx(_components.code,{children:`userPrompt`}),` may be sent in either camelCase or snake_case (`,_jsx(_components.code,{children:`system_prompt`}),`, `,_jsx(_components.code,{children:`user_prompt`}),`). A blueprint missing either one, or carrying an empty or whitespace-only value for it, is rejected with `,_jsx(_components.code,{children:`400`}),`.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Apart from the prompts and these two pairs, `,_jsx(_components.code,{children:`blueprint`}),` is forwarded untouched and stored verbatim — nothing else in it is validated structurally beyond its encoded size. The fields above are a base, not a ceiling: extra fields are kept, and unrecognised keys are forwarded exactly as they arrived. The documented camelCase keys are renamed to the agent service’s snake_case at the boundary.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`models-and-providers`,children:`Models and providers`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`model`}),` and `,_jsx(_components.code,{children:`provider`}),` are checked before the agent is created, and the same rules apply to `,_jsx(_components.code,{children:`backupModel`}),` and `,_jsx(_components.code,{children:`backupProvider`}),`. Both pairs are accepted in either casing (`,_jsx(_components.code,{children:`backup_model`}),`, `,_jsx(_components.code,{children:`backup_provider`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`A model is accepted when the platform’s model registry knows it, or when its name begins with a prefix belonging to a provider the platform routes to — `,_jsx(_components.code,{children:`gpt-`}),`, `,_jsx(_components.code,{children:`o`}),` followed by a digit, and `,_jsx(_components.code,{children:`chatgpt`}),` for `,_jsx(_components.code,{children:`openai`}),`, `,_jsx(_components.code,{children:`claude`}),` for `,_jsx(_components.code,{children:`anthropic`}),`, `,_jsx(_components.code,{children:`gemini`}),` for `,_jsx(_components.code,{children:`google`}),`. The prefix fallback means a model released before the registry catches up is still accepted, so `,_jsx(_components.code,{children:`claude-opus-9-future`}),` passes while `,_jsx(_components.code,{children:`llama-3-70b-instruct`}),` does not.`]}),`\n`,_jsxs(_components.p,{children:[`When both a model and a provider are given, the provider must be the one that model actually runs on — `,_jsx(_components.code,{children:`{ \"model\": \"gpt-4o\", \"provider\": \"anthropic\" }`}),` is rejected.`]}),`\n`,_jsx(_components.p,{children:`Each pair is checked only when it names a model or a provider. A blueprint that names neither is accepted as it stands.`}),`\n`,_jsx(Heading,{level:`4`,id:`providers`,children:`Providers`}),`\n`,_jsxs(_components.p,{children:[`A provider named on its own, with no model beside it, must be one of these. Anything else — `,_jsx(_components.code,{children:`mistral`}),`, say — is rejected.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Provider`}),_jsx(_components.th,{children:`Routes to`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT models, called directly`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude models, called directly`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`google`})}),_jsx(_components.td,{children:`Gemini models`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bedrock`})}),_jsxs(_components.td,{children:[`Claude and GPT models through AWS Bedrock, ids prefixed `,_jsx(_components.code,{children:`bedrock/`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`compass`})}),_jsxs(_components.td,{children:[`GPT models through Compass, ids prefixed `,_jsx(_components.code,{children:`compass/`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_openai`})}),_jsx(_components.td,{children:`Custom OpenAI-compatible endpoints. Not offered in the app’s model picker`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_anthropic`})}),_jsx(_components.td,{children:`Custom Anthropic-compatible endpoints. Not offered in the app’s model picker`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`commonly-used-models`,children:`Commonly used models`}),`\n`,_jsx(_components.p,{children:`A sample of the current lineup, not the whole of it — the registry moves with the platform, and this page will lag it. The model picker in the Opus app is the live list.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`provider`})}),_jsx(_components.th,{children:`Shown in the app as`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-5.6-terra`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT 5.6 Terra`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-5.2`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT 5.2`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-4o`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT 4o`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-opus-5`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude Opus 5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-sonnet-5`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude Sonnet 5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-haiku-4-5-20251001`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude Haiku 4.5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gemini-3.5-flash`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`google`})}),_jsx(_components.td,{children:`Gemini 3.5 Flash`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gemini-2.5-pro`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`google`})}),_jsx(_components.td,{children:`Gemini 2.5 Pro`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bedrock/claude-opus-5`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`bedrock`})}),_jsx(_components.td,{children:`Claude Opus 5 (Bedrock)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`compass/gpt-5.1`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`compass`})}),_jsx(_components.td,{children:`GPT 5.1 (Compass)`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Models reached through Bedrock or Compass carry the provider in the id itself, and the two halves must agree. `,_jsx(_components.code,{children:`{ \"model\": \"bedrock/claude-sonnet-5\", \"provider\": \"bedrock\" }`}),` is accepted; the same model named bare, as `,_jsx(_components.code,{children:`{ \"model\": \"claude-sonnet-5\", \"provider\": \"bedrock\" }`}),`, resolves to `,_jsx(_components.code,{children:`anthropic`}),` and is rejected.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`variable-object`,children:`Variable object`}),`\n`,_jsxs(_components.p,{children:[`Each value inside `,_jsx(_components.code,{children:`inputs`}),` and `,_jsx(_components.code,{children:`outputs`}),`. The map key must equal the variable’s `,_jsx(_components.code,{children:`variableName`}),`.`]}),`\n`,_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`Stable identifier for the variable, unique within the schema. Maximum 255 characters.`})}),`\n`,_jsx(ParamField,{body:`variableName`,type:`string`,required:true,id:`param-variable-name`,children:_jsx(_components.p,{children:`Programmatic key. Must equal the key this entry sits under. Maximum 255 characters.`})}),`\n`,_jsx(ParamField,{body:`allowedTypes`,type:`object[]`,required:true,id:`param-allowed-types`,children:_jsxs(_components.p,{children:[`Value types this variable accepts. Between 1 and 11 entries. Each has a `,_jsx(_components.code,{children:`type`}),` — one of `,_jsx(_components.code,{children:`int`}),`, `,_jsx(_components.code,{children:`float`}),`, `,_jsx(_components.code,{children:`bool`}),`, `,_jsx(_components.code,{children:`str`}),`, `,_jsx(_components.code,{children:`object`}),`, `,_jsx(_components.code,{children:`file`}),`, `,_jsx(_components.code,{children:`array`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`binary`}),`, `,_jsx(_components.code,{children:`json_string`}),`, `,_jsx(_components.code,{children:`node`}),` — plus optional `,_jsx(_components.code,{children:`typeDefinition`}),` and `,_jsx(_components.code,{children:`typeDefinitionEnforced`}),`.`]})}),`\n`,_jsx(ParamField,{body:`displayName`,type:`string`,id:`param-display-name`,children:_jsx(_components.p,{children:`Human-readable label rendered in the workflow builder. Maximum 255 characters. When omitted, the agent service applies its own default.`})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Description shown next to the variable in the builder. Maximum 2048 characters.`})}),`\n`,_jsx(ParamField,{body:`default`,type:`any`,default:`null`,id:`param-default`,children:_jsxs(_components.p,{children:[`Pre-filled default value. Its type must match one of `,_jsx(_components.code,{children:`allowedTypes`}),`.`]})}),`\n`,_jsx(ParamField,{body:`isNullable`,type:`boolean`,default:`false`,id:`param-is-nullable`,children:_jsx(_components.p,{children:`When true, the workflow may leave this variable unset.`})}),`\n`,_jsx(ParamField,{body:`tags`,type:`object[]`,id:`param-tags`,children:_jsxs(_components.p,{children:[`Annotations the builder uses for grouping and filtering, each `,_jsx(_components.code,{children:`{ variableName, value, description }`}),`. Maximum 20.`]})}),`\n`,_jsx(ParamField,{body:`options`,type:`any[]`,id:`param-options`,children:_jsx(_components.p,{children:`Enum-style choice list. When non-empty the builder renders a dropdown. Each entry is free-form JSON. Maximum 20.`})}),`\n`,_jsx(ParamField,{body:`currentType`,type:`string`,id:`param-current-type`,children:_jsxs(_components.p,{children:[`Which of `,_jsx(_components.code,{children:`allowedTypes`}),` is currently active. Must be one of them — consumers fall back to the first entry when unset.`]})}),`\n`,_jsx(ParamField,{body:`nonEditableFields`,type:`string[]`,id:`param-non-editable-fields`,children:_jsxs(_components.p,{children:[`Fields the builder locks, preventing the workflow author from changing them — any of `,_jsx(_components.code,{children:`variable_name`}),`, `,_jsx(_components.code,{children:`display_name`}),`, `,_jsx(_components.code,{children:`description`}),`, `,_jsx(_components.code,{children:`is_nullable`}),`, `,_jsx(_components.code,{children:`tags`}),`, `,_jsx(_components.code,{children:`options`}),`, `,_jsx(_components.code,{children:`allowed_types`}),`. Maximum 20.`]})}),`\n`,_jsx(ParamField,{body:`canDelete`,type:`boolean`,default:`true`,id:`param-can-delete`,children:_jsx(_components.p,{children:`When false, the builder hides the “remove variable” affordance.`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`For composite types, `,_jsx(_components.code,{children:`typeDefinition`}),` describes the shape inside: a nested variable map for `,_jsx(_components.code,{children:`object`}),`, a single nested variable for `,_jsx(_components.code,{children:`array`}),`, or a date format string for `,_jsx(_components.code,{children:`date`}),`. Omit it for scalars. Set `,_jsx(_components.code,{children:`typeDefinitionEnforced`}),` to hold the workflow author to it exactly.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`categories`,children:`Categories`}),`\n`,_jsxs(_components.p,{children:[`One to five of: `,_jsx(_components.code,{children:`parsing_and_serialization`}),`, `,_jsx(_components.code,{children:`validation_and_normalization`}),`, `,_jsx(_components.code,{children:`transformation_and_mapping`}),`, `,_jsx(_components.code,{children:`aggregation_and_analysis`}),`, `,_jsx(_components.code,{children:`numerical_computation`}),`, `,_jsx(_components.code,{children:`statistical_computation`}),`, `,_jsx(_components.code,{children:`optimization_and_search`}),`, `,_jsx(_components.code,{children:`text_processing`}),`, `,_jsx(_components.code,{children:`document_and_ocr_processing`}),`, `,_jsx(_components.code,{children:`media_processing`}),`, `,_jsx(_components.code,{children:`control_flow_and_orchestration`}),`, `,_jsx(_components.code,{children:`state_and_caching`}),`, `,_jsx(_components.code,{children:`io_and_storage`}),`, `,_jsx(_components.code,{children:`networking_and_apis`}),`, `,_jsx(_components.code,{children:`security_and_identity`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id-1`,children:_jsxs(_components.p,{children:[`The agent id. Pass it as `,_jsx(_components.code,{children:`{agentId}`}),` to `,_jsx(_components.a,{href:`/api-reference/v1-agent/update-agent`,children:`Update an Agent`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Agent display name.`})}),`\n`,_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description-1`,children:_jsx(_components.p,{children:`Agent description.`})}),`\n`,_jsx(ResponseField,{name:`icon`,type:`string`,id:`param-icon`,children:_jsx(_components.p,{children:`Agent icon.`})}),`\n`,_jsx(ResponseField,{name:`categories`,type:`string[]`,id:`param-categories`,children:_jsx(_components.p,{children:`Categories the agent is filed under.`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsx(_components.p,{children:`Agent status.`})}),`\n`,_jsx(ResponseField,{name:`isNew`,type:`boolean`,id:`param-is-new`,children:_jsx(_components.p,{children:`Whether the “new” badge is shown.`})}),`\n`,_jsx(ResponseField,{name:`isPopular`,type:`boolean`,id:`param-is-popular`,children:_jsx(_components.p,{children:`Whether the “popular” badge is shown.`})}),`\n`,_jsx(ResponseField,{name:`versionId`,type:`string`,id:`param-version-id`,children:_jsx(_components.p,{children:`Id of the version this call created.`})}),`\n`,_jsx(ResponseField,{name:`groupId`,type:`string`,id:`param-group-id`,children:_jsxs(_components.p,{children:[`Owning workspace, or `,_jsx(_components.code,{children:`null`}),` when the agent is visible across the marketplace.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsx(ResponseField,{name:`400`,type:`Bad Request`,id:`param-400`,children:_jsxs(_components.p,{children:[`Invalid body — a missing required field, a value over its limit, more than 5 categories, a `,_jsx(_components.code,{children:`blueprint`}),` without a non-empty `,_jsx(_components.code,{children:`systemPrompt`}),` and `,_jsx(_components.code,{children:`userPrompt`}),`, a `,_jsx(_components.code,{children:`blueprint`}),` naming a model or provider the platform cannot route to, or an `,_jsx(_components.code,{children:`inputs`}),`/`,_jsx(_components.code,{children:`outputs`}),` entry that is not a valid variable.`]})}),`\n`,_jsx(ResponseField,{name:`401`,type:`Unauthorized`,id:`param-401`,children:_jsx(_components.p,{children:`Missing, invalid, or expired API key.`})}),`\n`,_jsx(ResponseField,{name:`403`,type:`Forbidden`,id:`param-403`,children:_jsxs(_components.p,{children:[`The API key is not org-scoped, or the key owner lacks the `,_jsx(_components.strong,{children:`Agent: Full`}),` permission in the organization.`]})}),`\n`,_jsx(ResponseField,{name:`422`,type:`Unprocessable Entity`,id:`param-422`,children:_jsx(_components.p,{children:`Rejected downstream after passing validation here — most often an organization that is not verified to publish to the marketplace.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an Agent","api":"POST https://operator.opus.com/api/v1/agent","description":"Register a Custom Agent with its prompts and IO schema","href":"/api-reference/v1-agent/create-agent"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Register a `,_jsx(_components.a,{href:`/tasks/agent/custom-agent`,children:`Custom Agent`}),` in the marketplace under your organization.`]}),`\n`,_jsxs(_components.p,{children:[`The agent is authored at the organization level, so it is not bound to a workspace and is not runnable until it is connected into one. Returns the agent `,_jsx(_components.code,{children:`id`}),`, which you pass to `,_jsx(_components.a,{href:`/api-reference/v1-agent/update-agent`,children:`Update an Agent`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Requires the `,_jsx(_components.strong,{children:`Agent: Full`}),` permission at organization level.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Every agent created here is a Custom Agent. There is no `,_jsx(_components.code,{children:`agentClass`}),` field to set — the class is pinned, and `,_jsx(_components.code,{children:`blueprint`}),` must carry the prompts the agent runs with.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`There is no provider call to make first. Your organization’s agent provider is created on demand on your first agent, and `,_jsx(_components.code,{children:`providerId`}),` is not accepted in the body.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-service-key`,type:`string`,required:true,id:`param-x-service-key`,children:_jsx(_components.p,{children:`Your API authentication key`})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsxs(_components.p,{children:[`The agent is nested under an `,_jsx(_components.code,{children:`agent`}),` key.`]}),`\n`,_jsx(ParamField,{body:`agent`,type:`object`,required:true,id:`param-agent`,children:_jsx(_components.p,{children:`The agent to create. Fields below.`})}),`\n`,_jsx(ParamField,{body:`agent.name`,type:`string`,required:true,id:`param-agent-name`,children:_jsx(_components.p,{children:`Agent display name. Maximum 255 characters.`})}),`\n`,_jsx(ParamField,{body:`agent.icon`,type:`string`,required:true,id:`param-agent-icon`,children:_jsxs(_components.p,{children:[`Agent icon as a base64-encoded SVG (or PNG) — a plain string, with no `,_jsx(_components.code,{children:`data:`}),` prefix. Maximum 65535 characters.`]})}),`\n`,_jsx(ParamField,{body:`agent.blueprint`,type:`object`,required:true,id:`param-agent-blueprint`,children:_jsxs(_components.p,{children:[`The agent implementation: the prompts the agent runs with, plus the model that runs them. See `,_jsx(_components.a,{href:`#blueprint`,children:`Blueprint`}),`. Maximum 256KB JSON-encoded.`]})}),`\n`,_jsx(ParamField,{body:`agent.categories`,type:`string[]`,required:true,id:`param-agent-categories`,children:_jsxs(_components.p,{children:[`Categories the agent is filed under in the marketplace. Maximum 5 entries. See `,_jsx(_components.a,{href:`#categories`,children:`Categories`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.description`,type:`string`,id:`param-agent-description`,children:_jsx(_components.p,{children:`What the agent does, shown under its name. Maximum 2048 characters.`})}),`\n`,_jsx(ParamField,{body:`agent.inputs`,type:`object`,id:`param-agent-inputs`,children:_jsxs(_components.p,{children:[`The agent’s input schema, keyed by each variable’s `,_jsx(_components.code,{children:`variableName`}),`. Maximum 100 entries and 512KB JSON-encoded. See `,_jsx(_components.a,{href:`#variable-object`,children:`Variable object`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.outputs`,type:`object`,id:`param-agent-outputs`,children:_jsxs(_components.p,{children:[`The agent’s output schema, keyed by each variable’s `,_jsx(_components.code,{children:`variableName`}),`. Same shape and limits as `,_jsx(_components.code,{children:`inputs`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.status`,type:`string`,default:`active`,id:`param-agent-status`,children:_jsxs(_components.p,{children:[`Agent status — `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`inactive`}),`, `,_jsx(_components.code,{children:`soon`}),` or `,_jsx(_components.code,{children:`deprecated`}),`.`]})}),`\n`,_jsx(ParamField,{body:`agent.isNew`,type:`boolean`,default:`true`,id:`param-agent-is-new`,children:_jsx(_components.p,{children:`Show the “new” badge on the agent tile.`})}),`\n`,_jsx(ParamField,{body:`agent.isPopular`,type:`boolean`,default:`false`,id:`param-agent-is-popular`,children:_jsx(_components.p,{children:`Show the “popular” badge on the agent tile.`})}),`\n`,_jsx(ParamField,{body:`agent.isBeta`,type:`boolean`,default:`false`,id:`param-agent-is-beta`,children:_jsx(_components.p,{children:`Show the “beta” badge on the agent tile. Accepted on create but not echoed back in the response.`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Your organization is always taken from the API key — it cannot be set in the body. Nothing here is workspace-scoped.`})}),`\n`,_jsx(Heading,{level:`2`,id:`blueprint`,children:`Blueprint`}),`\n`,_jsx(_components.p,{children:`The prompts the agent runs with.`}),`\n`,_jsx(ParamField,{body:`systemPrompt`,type:`string`,required:true,id:`param-system-prompt`,children:_jsx(_components.p,{children:`System prompt the agent runs with. Must be non-empty.`})}),`\n`,_jsx(ParamField,{body:`userPrompt`,type:`string`,required:true,id:`param-user-prompt`,children:_jsxs(_components.p,{children:[`User prompt template. Must be non-empty. Reference the agent’s inputs with `,_jsx(_components.code,{children:`{{variableName}}`}),`.`]})}),`\n`,_jsx(ParamField,{body:`model`,type:`string`,id:`param-model`,children:_jsxs(_components.p,{children:[`Model the agent runs on, for example `,_jsx(_components.code,{children:`gpt-4o`}),`. Must be one the platform routes to — see `,_jsx(_components.a,{href:`#models-and-providers`,children:`Models and providers`}),`.`]})}),`\n`,_jsx(ParamField,{body:`provider`,type:`string`,id:`param-provider`,children:_jsxs(_components.p,{children:[`Provider of that model, for example `,_jsx(_components.code,{children:`openai`}),`. Must agree with the model when both are given.`]})}),`\n`,_jsx(ParamField,{body:`backupModel`,type:`string`,id:`param-backup-model`,children:_jsxs(_components.p,{children:[`Model to fall back to. Validated the same way as `,_jsx(_components.code,{children:`model`}),`.`]})}),`\n`,_jsx(ParamField,{body:`backupProvider`,type:`string`,id:`param-backup-provider`,children:_jsxs(_components.p,{children:[`Provider of the fallback model. Validated the same way as `,_jsx(_components.code,{children:`provider`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`systemPrompt`}),` and `,_jsx(_components.code,{children:`userPrompt`}),` may be sent in either camelCase or snake_case (`,_jsx(_components.code,{children:`system_prompt`}),`, `,_jsx(_components.code,{children:`user_prompt`}),`). A blueprint missing either one, or carrying an empty or whitespace-only value for it, is rejected with `,_jsx(_components.code,{children:`400`}),`.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Apart from the prompts and these two pairs, `,_jsx(_components.code,{children:`blueprint`}),` is forwarded untouched and stored verbatim — nothing else in it is validated structurally beyond its encoded size. The fields above are a base, not a ceiling: extra fields are kept, and unrecognised keys are forwarded exactly as they arrived. The documented camelCase keys are renamed to the agent service’s snake_case at the boundary.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`models-and-providers`,children:`Models and providers`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`model`}),` and `,_jsx(_components.code,{children:`provider`}),` are checked before the agent is created, and the same rules apply to `,_jsx(_components.code,{children:`backupModel`}),` and `,_jsx(_components.code,{children:`backupProvider`}),`. Both pairs are accepted in either casing (`,_jsx(_components.code,{children:`backup_model`}),`, `,_jsx(_components.code,{children:`backup_provider`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`A model is accepted when the platform’s model registry knows it, or when its name begins with a prefix belonging to a provider the platform routes to — `,_jsx(_components.code,{children:`gpt-`}),`, `,_jsx(_components.code,{children:`o`}),` followed by a digit, and `,_jsx(_components.code,{children:`chatgpt`}),` for `,_jsx(_components.code,{children:`openai`}),`, `,_jsx(_components.code,{children:`claude`}),` for `,_jsx(_components.code,{children:`anthropic`}),`, `,_jsx(_components.code,{children:`gemini`}),` for `,_jsx(_components.code,{children:`google`}),`. The prefix fallback means a model released before the registry catches up is still accepted, so `,_jsx(_components.code,{children:`claude-opus-9-future`}),` passes while `,_jsx(_components.code,{children:`llama-3-70b-instruct`}),` does not.`]}),`\n`,_jsxs(_components.p,{children:[`When both a model and a provider are given, the provider must be the one that model actually runs on — `,_jsx(_components.code,{children:`{ \"model\": \"gpt-4o\", \"provider\": \"anthropic\" }`}),` is rejected.`]}),`\n`,_jsx(_components.p,{children:`Each pair is checked only when it names a model or a provider. A blueprint that names neither is accepted as it stands.`}),`\n`,_jsx(Heading,{level:`4`,id:`providers`,children:`Providers`}),`\n`,_jsxs(_components.p,{children:[`A provider named on its own, with no model beside it, must be one of these. Anything else — `,_jsx(_components.code,{children:`mistral`}),`, say — is rejected.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Provider`}),_jsx(_components.th,{children:`Routes to`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT models, called directly`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude models, called directly`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`google`})}),_jsx(_components.td,{children:`Gemini models`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bedrock`})}),_jsxs(_components.td,{children:[`Claude and GPT models through AWS Bedrock, ids prefixed `,_jsx(_components.code,{children:`bedrock/`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`compass`})}),_jsxs(_components.td,{children:[`GPT models through Compass, ids prefixed `,_jsx(_components.code,{children:`compass/`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_openai`})}),_jsx(_components.td,{children:`Custom OpenAI-compatible endpoints. Not offered in the app’s model picker`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_anthropic`})}),_jsx(_components.td,{children:`Custom Anthropic-compatible endpoints. Not offered in the app’s model picker`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`commonly-used-models`,children:`Commonly used models`}),`\n`,_jsx(_components.p,{children:`A sample of the current lineup, not the whole of it — the registry moves with the platform, and this page will lag it. The model picker in the Opus app is the live list.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`provider`})}),_jsx(_components.th,{children:`Shown in the app as`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-5.6-terra`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT 5.6 Terra`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-5.2`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT 5.2`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-4o`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openai`})}),_jsx(_components.td,{children:`GPT 4o`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-opus-5`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude Opus 5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-sonnet-5`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude Sonnet 5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`claude-haiku-4-5-20251001`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic`})}),_jsx(_components.td,{children:`Claude Haiku 4.5`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gemini-3.5-flash`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`google`})}),_jsx(_components.td,{children:`Gemini 3.5 Flash`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`gemini-2.5-pro`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`google`})}),_jsx(_components.td,{children:`Gemini 2.5 Pro`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bedrock/claude-opus-5`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`bedrock`})}),_jsx(_components.td,{children:`Claude Opus 5 (Bedrock)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`compass/gpt-5.1`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`compass`})}),_jsx(_components.td,{children:`GPT 5.1 (Compass)`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Models reached through Bedrock or Compass carry the provider in the id itself, and the two halves must agree. `,_jsx(_components.code,{children:`{ \"model\": \"bedrock/claude-sonnet-5\", \"provider\": \"bedrock\" }`}),` is accepted; the same model named bare, as `,_jsx(_components.code,{children:`{ \"model\": \"claude-sonnet-5\", \"provider\": \"bedrock\" }`}),`, resolves to `,_jsx(_components.code,{children:`anthropic`}),` and is rejected.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`variable-object`,children:`Variable object`}),`\n`,_jsxs(_components.p,{children:[`Each value inside `,_jsx(_components.code,{children:`inputs`}),` and `,_jsx(_components.code,{children:`outputs`}),`. The map key must equal the variable’s `,_jsx(_components.code,{children:`variableName`}),`.`]}),`\n`,_jsx(ParamField,{body:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`Stable identifier for the variable, unique within the schema. Maximum 255 characters.`})}),`\n`,_jsx(ParamField,{body:`variableName`,type:`string`,required:true,id:`param-variable-name`,children:_jsx(_components.p,{children:`Programmatic key. Must equal the key this entry sits under. Maximum 255 characters.`})}),`\n`,_jsx(ParamField,{body:`allowedTypes`,type:`object[]`,required:true,id:`param-allowed-types`,children:_jsxs(_components.p,{children:[`Value types this variable accepts. Between 1 and 11 entries. Each has a `,_jsx(_components.code,{children:`type`}),` — one of `,_jsx(_components.code,{children:`int`}),`, `,_jsx(_components.code,{children:`float`}),`, `,_jsx(_components.code,{children:`bool`}),`, `,_jsx(_components.code,{children:`str`}),`, `,_jsx(_components.code,{children:`object`}),`, `,_jsx(_components.code,{children:`file`}),`, `,_jsx(_components.code,{children:`array`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`binary`}),`, `,_jsx(_components.code,{children:`json_string`}),`, `,_jsx(_components.code,{children:`node`}),` — plus optional `,_jsx(_components.code,{children:`typeDefinition`}),` and `,_jsx(_components.code,{children:`typeDefinitionEnforced`}),`.`]})}),`\n`,_jsx(ParamField,{body:`displayName`,type:`string`,id:`param-display-name`,children:_jsx(_components.p,{children:`Human-readable label rendered in the workflow builder. Maximum 255 characters. When omitted, the agent service applies its own default.`})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Description shown next to the variable in the builder. Maximum 2048 characters.`})}),`\n`,_jsx(ParamField,{body:`default`,type:`any`,default:`null`,id:`param-default`,children:_jsxs(_components.p,{children:[`Pre-filled default value. Its type must match one of `,_jsx(_components.code,{children:`allowedTypes`}),`.`]})}),`\n`,_jsx(ParamField,{body:`isNullable`,type:`boolean`,default:`false`,id:`param-is-nullable`,children:_jsx(_components.p,{children:`When true, the workflow may leave this variable unset.`})}),`\n`,_jsx(ParamField,{body:`tags`,type:`object[]`,id:`param-tags`,children:_jsxs(_components.p,{children:[`Annotations the builder uses for grouping and filtering, each `,_jsx(_components.code,{children:`{ variableName, value, description }`}),`. Maximum 20.`]})}),`\n`,_jsx(ParamField,{body:`options`,type:`any[]`,id:`param-options`,children:_jsx(_components.p,{children:`Enum-style choice list. When non-empty the builder renders a dropdown. Each entry is free-form JSON. Maximum 20.`})}),`\n`,_jsx(ParamField,{body:`currentType`,type:`string`,id:`param-current-type`,children:_jsxs(_components.p,{children:[`Which of `,_jsx(_components.code,{children:`allowedTypes`}),` is currently active. Must be one of them — consumers fall back to the first entry when unset.`]})}),`\n`,_jsx(ParamField,{body:`nonEditableFields`,type:`string[]`,id:`param-non-editable-fields`,children:_jsxs(_components.p,{children:[`Fields the builder locks, preventing the workflow author from changing them — any of `,_jsx(_components.code,{children:`variable_name`}),`, `,_jsx(_components.code,{children:`display_name`}),`, `,_jsx(_components.code,{children:`description`}),`, `,_jsx(_components.code,{children:`is_nullable`}),`, `,_jsx(_components.code,{children:`tags`}),`, `,_jsx(_components.code,{children:`options`}),`, `,_jsx(_components.code,{children:`allowed_types`}),`. Maximum 20.`]})}),`\n`,_jsx(ParamField,{body:`canDelete`,type:`boolean`,default:`true`,id:`param-can-delete`,children:_jsx(_components.p,{children:`When false, the builder hides the “remove variable” affordance.`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`For composite types, `,_jsx(_components.code,{children:`typeDefinition`}),` describes the shape inside: a nested variable map for `,_jsx(_components.code,{children:`object`}),`, a single nested variable for `,_jsx(_components.code,{children:`array`}),`, or a date format string for `,_jsx(_components.code,{children:`date`}),`. Omit it for scalars. Set `,_jsx(_components.code,{children:`typeDefinitionEnforced`}),` to hold the workflow author to it exactly.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`categories`,children:`Categories`}),`\n`,_jsxs(_components.p,{children:[`One to five of: `,_jsx(_components.code,{children:`parsing_and_serialization`}),`, `,_jsx(_components.code,{children:`validation_and_normalization`}),`, `,_jsx(_components.code,{children:`transformation_and_mapping`}),`, `,_jsx(_components.code,{children:`aggregation_and_analysis`}),`, `,_jsx(_components.code,{children:`numerical_computation`}),`, `,_jsx(_components.code,{children:`statistical_computation`}),`, `,_jsx(_components.code,{children:`optimization_and_search`}),`, `,_jsx(_components.code,{children:`text_processing`}),`, `,_jsx(_components.code,{children:`document_and_ocr_processing`}),`, `,_jsx(_components.code,{children:`media_processing`}),`, `,_jsx(_components.code,{children:`control_flow_and_orchestration`}),`, `,_jsx(_components.code,{children:`state_and_caching`}),`, `,_jsx(_components.code,{children:`io_and_storage`}),`, `,_jsx(_components.code,{children:`networking_and_apis`}),`, `,_jsx(_components.code,{children:`security_and_identity`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id-1`,children:_jsxs(_components.p,{children:[`The agent id. Pass it as `,_jsx(_components.code,{children:`{agentId}`}),` to `,_jsx(_components.a,{href:`/api-reference/v1-agent/update-agent`,children:`Update an Agent`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Agent display name.`})}),`\n`,_jsx(ResponseField,{name:`description`,type:`string`,id:`param-description-1`,children:_jsx(_components.p,{children:`Agent description.`})}),`\n`,_jsx(ResponseField,{name:`icon`,type:`string`,id:`param-icon`,children:_jsx(_components.p,{children:`Agent icon.`})}),`\n`,_jsx(ResponseField,{name:`categories`,type:`string[]`,id:`param-categories`,children:_jsx(_components.p,{children:`Categories the agent is filed under.`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsx(_components.p,{children:`Agent status.`})}),`\n`,_jsx(ResponseField,{name:`isNew`,type:`boolean`,id:`param-is-new`,children:_jsx(_components.p,{children:`Whether the “new” badge is shown.`})}),`\n`,_jsx(ResponseField,{name:`isPopular`,type:`boolean`,id:`param-is-popular`,children:_jsx(_components.p,{children:`Whether the “popular” badge is shown.`})}),`\n`,_jsx(ResponseField,{name:`versionId`,type:`string`,id:`param-version-id`,children:_jsx(_components.p,{children:`Id of the version this call created.`})}),`\n`,_jsx(ResponseField,{name:`groupId`,type:`string`,id:`param-group-id`,children:_jsxs(_components.p,{children:[`Owning workspace, or `,_jsx(_components.code,{children:`null`}),` when the agent is visible across the marketplace.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsx(ResponseField,{name:`400`,type:`Bad Request`,id:`param-400`,children:_jsxs(_components.p,{children:[`Invalid body — a missing required field, a value over its limit, more than 5 categories, a `,_jsx(_components.code,{children:`blueprint`}),` without a non-empty `,_jsx(_components.code,{children:`systemPrompt`}),` and `,_jsx(_components.code,{children:`userPrompt`}),`, a `,_jsx(_components.code,{children:`blueprint`}),` naming a model or provider the platform cannot route to, or an `,_jsx(_components.code,{children:`inputs`}),`/`,_jsx(_components.code,{children:`outputs`}),` entry that is not a valid variable.`]})}),`\n`,_jsx(ResponseField,{name:`401`,type:`Unauthorized`,id:`param-401`,children:_jsx(_components.p,{children:`Missing, invalid, or expired API key.`})}),`\n`,_jsx(ResponseField,{name:`403`,type:`Forbidden`,id:`param-403`,children:_jsxs(_components.p,{children:[`The API key is not org-scoped, or the key owner lacks the `,_jsx(_components.strong,{children:`Agent: Full`}),` permission in the organization.`]})}),`\n`,_jsx(ResponseField,{name:`422`,type:`Unprocessable Entity`,id:`param-422`,children:_jsx(_components.p,{children:`Rejected downstream after passing validation here — most often an organization that is not verified to publish to the marketplace.`})}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`40`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`40`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://operator.opus.com/api/v1/agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-service-key: {YOUR_SERVICE_KEY}'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Adder\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\": \"Adds two numbers and returns the total\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"icon\": \"{BASE64_ICON}\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"categories\": [\"numerical_computation\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"blueprint\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"systemPrompt\": \"You are a careful arithmetic assistant.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userPrompt\": \"Add {{firstNumber}} and {{secondNumber}} and return the total.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"gpt-4o\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"provider\": \"openai\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"inputs\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"firstNumber\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\": \"1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"variableName\": \"firstNumber\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"displayName\": \"First Number\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"allowedTypes\": [{ \"type\": \"float\" }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"secondNumber\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\": \"2\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"variableName\": \"secondNumber\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"displayName\": \"Second Number\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"allowedTypes\": [{ \"type\": \"float\" }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"outputs\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sumResult\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\": \"1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"variableName\": \"sumResult\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"displayName\": \"Sum Result\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"allowedTypes\": [{ \"type\": \"float\" }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`46`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`46`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`url `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://operator.opus.com/api/v1/agent\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-service-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{YOUR_SERVICE_KEY}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Adder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Adds two numbers and returns the total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"icon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{BASE64_ICON}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"categories\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"numerical_computation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"blueprint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"systemPrompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You are a careful arithmetic assistant.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userPrompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Add `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`firstNumber`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` and `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`secondNumber`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` and return the total.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gpt-4o\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"provider\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"openai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"inputs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"firstNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"variableName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"firstNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"displayName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"First Number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"allowedTypes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"float\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"secondNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"variableName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"secondNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"displayName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Second Number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"allowedTypes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"float\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"outputs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sumResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"variableName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sumResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"displayName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sum Result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"allowedTypes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"float\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(url, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.json())`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`46`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`46`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://operator.opus.com/api/v1/agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-service-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"{YOUR_SERVICE_KEY}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agent:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Adder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` description:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Adds two numbers and returns the total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` icon:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"{BASE64_ICON}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` categories:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"numerical_computation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` blueprint:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` systemPrompt:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"You are a careful arithmetic assistant.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` userPrompt:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Add {{firstNumber}} and {{secondNumber}} and return the total.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` model:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"gpt-4o\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` provider:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"openai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` inputs:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` firstNumber:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` variableName:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"firstNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` displayName:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"First Number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` allowedTypes:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [{ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"float\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` secondNumber:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` variableName:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"secondNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` displayName:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Second Number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` allowedTypes:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [{ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"float\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` outputs:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sumResult:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` variableName:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sumResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` displayName:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Sum Result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` allowedTypes:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [{ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"float\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`201 Response`,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{AGENT_ID}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Adder\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Adds two numbers and returns the total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"icon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{BASE64_ICON}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"categories\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"numerical_computation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isNew\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isPopular\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"versionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{AGENT_VERSION_ID}\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"groupId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an Agent","api":"POST https://operator.opus.com/api/v1/agent","description":"Register a Custom Agent with its prompts and IO schema","href":"/api-reference/v1-agent/create-agent"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Blueprint","slug":"blueprint","depth":2,"children":[{"title":"Models and providers","slug":"models-and-providers","depth":3,"children":[]},{"title":"Providers","slug":"providers","depth":4,"children":[]},{"title":"Commonly used models","slug":"commonly-used-models","depth":4,"children":[]}]},{"title":"Variable object","slug":"variable-object","depth":2,"children":[]},{"title":"Categories","slug":"categories","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"40\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --request\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --url\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://operator.opus.com/api/v1/agent\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'x-service-key: {YOUR_SERVICE_KEY}'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"agent\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"name\": \"Adder\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"description\": \"Adds two numbers and returns the total\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"icon\": \"{BASE64_ICON}\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"categories\": [\"numerical_computation\"],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"blueprint\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"systemPrompt\": \"You are a careful arithmetic assistant.\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"userPrompt\": \"Add {{firstNumber}} and {{secondNumber}} and return the total.\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"model\": \"gpt-4o\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"provider\": \"openai\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"inputs\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"firstNumber\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"id\": \"1\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"variableName\": \"firstNumber\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"displayName\": \"First Number\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"allowedTypes\": [{ \"type\": \"float\" }]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"secondNumber\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"id\": \"2\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"variableName\": \"secondNumber\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"displayName\": \"Second Number\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"allowedTypes\": [{ \"type\": \"float\" }]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"outputs\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"sumResult\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"id\": \"1\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"variableName\": \"sumResult\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"displayName\": \"Sum Result\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"allowedTypes\": [{ \"type\": \"float\" }]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"46\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">url \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://operator.opus.com/api/v1/agent\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">headers \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-service-key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{YOUR_SERVICE_KEY}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">payload \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"agent\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Adder\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Adds two numbers and returns the total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"icon\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{BASE64_ICON}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"categories\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"numerical_computation\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"blueprint\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"systemPrompt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"You are a careful arithmetic assistant.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"userPrompt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Add \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">firstNumber\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> and \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">secondNumber\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> and return the total.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"gpt-4o\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"provider\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"openai\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"inputs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"firstNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"variableName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"firstNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"displayName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"First Number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"allowedTypes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"float\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"secondNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"variableName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"secondNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"displayName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Second Number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"allowedTypes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"float\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"outputs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"sumResult\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"variableName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sumResult\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"displayName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Sum Result\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"allowedTypes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"float\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.post(url, \u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">json\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">payload, \u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">headers)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(response.json())\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"46\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://operator.opus.com/api/v1/agent\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"POST\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-service-key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"{YOUR_SERVICE_KEY}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> agent:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> name:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Adder\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> description:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Adds two numbers and returns the total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> icon:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"{BASE64_ICON}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> categories:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"numerical_computation\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> blueprint:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> systemPrompt:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"You are a careful arithmetic assistant.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> userPrompt:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Add {{firstNumber}} and {{secondNumber}} and return the total.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> model:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"gpt-4o\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> provider:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"openai\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> inputs:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> firstNumber:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> variableName:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"firstNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> displayName:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"First Number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> allowedTypes:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [{ \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">type:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"float\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> secondNumber:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> variableName:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"secondNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> displayName:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Second Number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> allowedTypes:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [{ \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">type:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"float\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> outputs:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> sumResult:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> variableName:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"sumResult\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> displayName:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Sum Result\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> allowedTypes:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [{ \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">type:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"float\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> data\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201 Response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"{AGENT_ID}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Adder\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Adds two numbers and returns the total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"icon\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"{BASE64_ICON}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"categories\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"numerical_computation\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"active\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"isNew\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"isPopular\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"versionId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"{AGENT_VERSION_ID}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"groupId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create an Agent","path":"/api/v1/agent","servers":[{"url":"https://operator.opus.com"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"x-service-key":{"schema":[{"type":"string","description":"Your API authentication key","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"agent":[{"type":"object","properties":{},"description":"The agent to create. Fields below.","required":true}],"agent.name":[{"type":"string","description":"Agent display name. Maximum 255 characters.","required":true}],"agent.icon":[{"type":"string","description":"Agent icon as a base64-encoded SVG (or PNG) — a plain string, with no `data:` prefix. Maximum 65535 characters.","required":true}],"agent.blueprint":[{"type":"object","properties":{},"description":"The agent implementation: the prompts the agent runs with, plus the model that runs them. See Blueprint . Maximum 256KB JSON-encoded.","required":true}],"agent.categories":[{"type":"array","items":[{"type":"string"}],"description":"Categories the agent is filed under in the marketplace. Maximum 5 entries. See Categories .","required":true}],"agent.description":[{"type":"string","description":"What the agent does, shown under its name. Maximum 2048 characters."}],"agent.inputs":[{"type":"object","properties":{},"description":"The agent’s input schema, keyed by each variable’s `variableName` . Maximum 100 entries and 512KB JSON-encoded. See Variable object ."}],"agent.outputs":[{"type":"object","properties":{},"description":"The agent’s output schema, keyed by each variable’s `variableName` . Same shape and limits as `inputs` ."}],"agent.status":[{"type":"string","description":"Agent status — `active` , `inactive` , `soon` or `deprecated` ."}],"agent.isNew":[{"type":"boolean","description":"Show the “new” badge on the agent tile."}],"agent.isPopular":[{"type":"boolean","description":"Show the “popular” badge on the agent tile."}],"agent.isBeta":[{"type":"boolean","description":"Show the “beta” badge on the agent tile. Accepted on create but not echoed back in the response."}],"systemPrompt":[{"type":"string","description":"System prompt the agent runs with. Must be non-empty.","required":true}],"userPrompt":[{"type":"string","description":"User prompt template. Must be non-empty. Reference the agent’s inputs with `{{variableName}}` .","required":true}],"model":[{"type":"string","description":"Model the agent runs on, for example `gpt-4o` . Must be one the platform routes to — see Models and providers ."}],"provider":[{"type":"string","description":"Provider of that model, for example `openai` . Must agree with the model when both are given."}],"backupModel":[{"type":"string","description":"Model to fall back to. Validated the same way as `model` ."}],"backupProvider":[{"type":"string","description":"Provider of the fallback model. Validated the same way as `provider` ."}],"id":[{"type":"string","description":"Stable identifier for the variable, unique within the schema. Maximum 255 characters.","required":true}],"variableName":[{"type":"string","description":"Programmatic key. Must equal the key this entry sits under. Maximum 255 characters.","required":true}],"allowedTypes":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Value types this variable accepts. Between 1 and 11 entries. Each has a `type` — one of `int` , `float` , `bool` , `str` , `object` , `file` , `array` , `date` , `binary` , `json_string` , `node` — plus optional `typeDefinition` and `typeDefinitionEnforced` .","required":true}],"displayName":[{"type":"string","description":"Human-readable label rendered in the workflow builder. Maximum 255 characters. When omitted, the agent service applies its own default."}],"description":[{"type":"string","description":"Description shown next to the variable in the builder. Maximum 2048 characters."}],"default":[{"type":"any","description":"Pre-filled default value. Its type must match one of `allowedTypes` ."}],"isNullable":[{"type":"boolean","description":"When true, the workflow may leave this variable unset."}],"tags":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Annotations the builder uses for grouping and filtering, each `{ variableName, value, description }` . Maximum 20."}],"options":[{"type":"array","items":[{"type":"any"}],"description":"Enum-style choice list. When non-empty the builder renders a dropdown. Each entry is free-form JSON. Maximum 20."}],"currentType":[{"type":"string","description":"Which of `allowedTypes` is currently active. Must be one of them — consumers fall back to the first entry when unset."}],"nonEditableFields":[{"type":"array","items":[{"type":"string"}],"description":"Fields the builder locks, preventing the workflow author from changing them — any of `variable_name` , `display_name` , `description` , `is_nullable` , `tags` , `options` , `allowed_types` . Maximum 20."}],"canDelete":[{"type":"boolean","description":"When false, the builder hides the “remove variable” affordance."}]}}],"examples":{"example":{"value":{"agent":{},"agent.name":"\u003cstring>","agent.icon":"\u003cstring>","agent.blueprint":{},"agent.categories":["\u003cstring>"],"agent.description":"\u003cstring>","agent.inputs":{},"agent.outputs":{},"agent.status":"\u003cstring>","agent.isNew":true,"agent.isPopular":true,"agent.isBeta":true,"systemPrompt":"\u003cstring>","userPrompt":"\u003cstring>","model":"\u003cstring>","provider":"\u003cstring>","backupModel":"\u003cstring>","backupProvider":"\u003cstring>","id":"\u003cstring>","variableName":"\u003cstring>","allowedTypes":[{}],"displayName":"\u003cstring>","description":"\u003cstring>","default":"\u003cany>","isNullable":true,"tags":[{}],"options":["\u003cany>"],"currentType":"\u003cstring>","nonEditableFields":["\u003cstring>"],"canDelete":true}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"400":[{"type":"object","properties":{},"description":"Invalid body — a missing required field, a value over its limit, more than 5 categories, a `blueprint` without a non-empty `systemPrompt` and `userPrompt` , a `blueprint` naming a model or provider the platform cannot route to, or an `inputs` / `outputs` entry that is not a valid variable."}],"401":[{"type":"object","properties":{},"description":"Missing, invalid, or expired API key."}],"403":[{"type":"object","properties":{},"description":"The API key is not org-scoped, or the key owner lacks the Agent: Full permission in the organization."}],"422":[{"type":"object","properties":{},"description":"Rejected downstream after passing validation here — most often an organization that is not verified to publish to the marketplace."}],"id":[{"type":"string","description":"The agent id. Pass it as `{agentId}` to Update an Agent .","required":true}],"name":[{"type":"string","description":"Agent display name.","required":true}],"description":[{"type":"string","description":"Agent description."}],"icon":[{"type":"string","description":"Agent icon."}],"categories":[{"type":"array","items":[{"type":"string"}],"description":"Categories the agent is filed under."}],"status":[{"type":"string","description":"Agent status."}],"isNew":[{"type":"boolean","description":"Whether the “new” badge is shown."}],"isPopular":[{"type":"boolean","description":"Whether the “popular” badge is shown."}],"versionId":[{"type":"string","description":"Id of the version this call created."}],"groupId":[{"type":"string","description":"Owning workspace, or `null` when the agent is visible across the marketplace."}]}}],"examples":{"example":{"value":{"400":{},"401":{},"403":{},"422":{},"id":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","icon":"\u003cstring>","categories":["\u003cstring>"],"status":"\u003cstring>","isNew":true,"isPopular":true,"versionId":"\u003cstring>","groupId":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"appliedai-7127e5be","siteName":"Opus Docs","title":"Create an Agent - Opus Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T14:03:46.114Z","originalFileLocation":"api-reference/v1-agent/create-agent.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Register a Custom Agent with its prompts and IO schema\">\u003cmeta data-mint-head name=\"application-name\" content=\"Opus Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an Agent - Opus Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Register a Custom Agent with its prompts and IO schema\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Opus Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.opus.com/api-reference/v1-agent/create-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://appliedai-7127e5be.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+Agent\u0026amp;description=Register+a+Custom+Agent+with+its+prompts+and+IO+schema\u0026amp;theme=7962c46fe7a071bfab35bbb3\u0026amp;signature=15ce9f8f84acd3d85cacb75e18ef200a76a44766910ee2278568cc6c13f5e30c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create an Agent - Opus Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Register a Custom Agent with its prompts and IO schema\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://appliedai-7127e5be.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+Agent\u0026amp;description=Register+a+Custom+Agent+with+its+prompts+and+IO+schema\u0026amp;theme=7962c46fe7a071bfab35bbb3\u0026amp;signature=15ce9f8f84acd3d85cacb75e18ef200a76a44766910ee2278568cc6c13f5e30c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/appliedai-7127e5be/izBgmHq5AgpZ-DmU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Opus Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2B5DDC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.opus.com/api-reference/v1-agent/create-agent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1-agent/create-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.opus.com/#organization\",\"name\":\"Opus Docs\",\"url\":\"https://developer.opus.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/appliedai-7127e5be/wVwGgyXIDQyL0wYc/images/light-logo.svg?fit=max\u0026auto=format\u0026n=wVwGgyXIDQyL0wYc\u0026q=85\u0026s=48326fd6749a2f78fa038e3460082611\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.opus.com#website\",\"name\":\"Opus Docs\",\"url\":\"https://developer.opus.com\",\"publisher\":{\"@id\":\"https://developer.opus.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.opus.com/api-reference/v1-agent/create-agent#webpage\",\"url\":\"https://developer.opus.com/api-reference/v1-agent/create-agent\",\"name\":\"Create an Agent\",\"description\":\"Register a Custom Agent with its prompts and IO schema\",\"dateModified\":\"2026-09-29T14:03:46.114Z\",\"isPartOf\":{\"@id\":\"https://developer.opus.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.opus.com/api-reference/v1-agent/create-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.opus.com/api-reference/v1-agent/create-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://developer.opus.com/api-reference/v1-agent/agent-introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an Agent\",\"item\":\"https://developer.opus.com/api-reference/v1-agent/create-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.opus.com/api-reference/v1-agent/create-agent#apireference\",\"headline\":\"Create an Agent\",\"name\":\"Create an Agent\",\"description\":\"Register a Custom Agent with its prompts and IO schema\",\"url\":\"https://developer.opus.com/api-reference/v1-agent/create-agent\",\"mainEntityOfPage\":{\"@id\":\"https://developer.opus.com/api-reference/v1-agent/create-agent#webpage\"},\"dateModified\":\"2026-09-29T14:03:46.114Z\",\"publisher\":{\"@id\":\"https://developer.opus.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.opus.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Opus Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Opus Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v1-agent/create-agent.md","siteName":"Opus Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"API Quickstart","href":"/api-reference/quickstart"}]},{"group":"Workflows","pages":[{"title":"Introduction","href":"/api-reference/v1-workflow-generation/workflow-generation-introduction"},{"title":"Create a Workflow","api":"POST https://operator.opus.com/api/v1/workflow","playground":"simple","href":"/api-reference/v1-workflow-generation/create-workflow"},{"title":"Get Workflow Details","api":"GET https://operator.opus.com/api/v1/workflow/{workflowId}","href":"/api-reference/v1-workflow-generation/get-workflow-details"},{"title":"Update a Workflow","api":"PUT https://operator.opus.com/api/v1/workflow/{workflowId}","playground":"simple","href":"/api-reference/v1-workflow-generation/update-workflow"},{"title":"Archive a Workflow","api":"DELETE https://operator.opus.com/api/v1/workflow/{workflowId}","playground":"simple","href":"/api-reference/v1-workflow-generation/archive-workflow"},{"title":"Restore a Workflow","api":"POST https://operator.opus.com/api/v1/workflow/{workflowId}/restore","playground":"simple","href":"/api-reference/v1-workflow-generation/restore-workflow"},{"title":"Generate a Workflow","api":"POST https://operator.opus.com/api/v1/workflow/generate","playground":"simple","href":"/api-reference/v1-workflow-generation/generate-headless"},{"title":"Get Run Status","api":"GET https://operator.opus.com/api/v1/workflow/{workflowId}/run","playground":"simple","href":"/api-reference/v1-workflow-generation/get-run-status"},{"title":"Cancel a Run","api":"POST https://operator.opus.com/api/v1/workflow/{workflowId}/run/cancel","playground":"simple","href":"/api-reference/v1-workflow-generation/cancel-run"},{"group":"Node Reference","pages":[{"title":"Node Process Types","href":"/api-reference/v1-workflow-generation/node-process-types"},{"title":"Agent Node","href":"/api-reference/v1-workflow-generation/agent-node"},{"title":"Code Node","href":"/api-reference/v1-workflow-generation/code-node"},{"title":"Human Node","href":"/api-reference/v1-workflow-generation/human-node"},{"title":"Integration Node","href":"/api-reference/v1-workflow-generation/integration-node"},{"title":"Variable Schemas","href":"/api-reference/v1-workflow-generation/variable-schemas"}]}]},{"group":"Cases","pages":[{"title":"Introduction","href":"/api-reference/v1-case/case-introduction"},{"title":"Initiate Case","api":"POST https://operator.opus.com/api/v1/case","href":"/api-reference/v1-case/initiate-case"},{"title":"Execute Case","api":"POST https://operator.opus.com/api/v1/case/{caseId}/execute","playground":"simple","href":"/api-reference/v1-case/execute-case"},{"title":"Get Case Status","api":"GET https://operator.opus.com/api/v1/case/{caseId}/status","href":"/api-reference/v1-case/get-case-status"},{"title":"Cancel Case","api":"POST https://operator.opus.com/api/v1/case/{caseId}/cancel","href":"/api-reference/v1-case/cancel-case"},{"title":"Get Case Results","api":"GET https://operator.opus.com/api/v1/case/{caseId}/results","href":"/api-reference/v1-case/get-case-results"},{"title":"Case Audit Log","api":"GET https://operator.opus.com/api/v1/case/{caseId}/audit","href":"/api-reference/v1-case/case-audit-log"}]},{"group":"Files","pages":[{"title":"Introduction","href":"/api-reference/v1-file/file-introduction"},{"title":"Get Upload URL","api":"POST https://operator.opus.com/api/v1/file/upload/presigned","href":"/api-reference/v1-file/get-upload-url"},{"title":"Upload File","api":"PUT {presignedUrl}","playground":"simple","href":"/api-reference/v1-file/upload-file"}]},{"group":"Business Process Discovery","pages":[{"title":"Introduction","href":"/api-reference/v1-discovery/discovery-introduction"},{"title":"Get a Process","api":"GET https://operator.opus.com/api/v1/discovery/process/{processId}","href":"/api-reference/v1-discovery/get-process-details"}]},{"group":"Integrations","pages":[{"title":"Introduction","href":"/api-reference/v1-integration/integration-introduction"},{"title":"Create a Provider","api":"POST https://operator.opus.com/api/v1/integration/provider","href":"/api-reference/v1-integration/create-provider"},{"title":"Create an Integration","api":"POST https://operator.opus.com/api/v1/integration","href":"/api-reference/v1-integration/create-integration"},{"title":"Add an Action","api":"POST https://operator.opus.com/api/v1/integration/v/{integrationVersionId}/action","href":"/api-reference/v1-integration/add-action"},{"title":"Add a Credential","api":"POST https://operator.opus.com/api/v1/integration/v/{integrationVersionId}/credential","href":"/api-reference/v1-integration/create-credential"},{"title":"Connect an Integration","api":"POST https://operator.opus.com/api/v1/integration/connect","href":"/api-reference/v1-integration/connect-integration"},{"title":"Check a Connection","api":"GET https://operator.opus.com/api/v1/integration/connect/{connectionToken}","href":"/api-reference/v1-integration/connection-status"}]},{"group":"Code","pages":[{"title":"Introduction","href":"/api-reference/v1-code/code-introduction"},{"title":"Create a Code Node","api":"POST https://operator.opus.com/api/v1/code","href":"/api-reference/v1-code/create-code"},{"title":"Update a Code Node","api":"PATCH https://operator.opus.com/api/v1/code/{codeId}","href":"/api-reference/v1-code/update-code"}]},{"group":"Agents","pages":[{"title":"Introduction","description":"Author agents for your organization entirely through the API","href":"/api-reference/v1-agent/agent-introduction"},{"title":"Create an Agent","api":"POST https://operator.opus.com/api/v1/agent","href":"/api-reference/v1-agent/create-agent"},{"title":"Update an Agent","api":"PATCH https://operator.opus.com/api/v1/agent/{agentId}","description":"Revise an agent your organization owns, cutting a new version","href":"/api-reference/v1-agent/update-agent"}]},{"group":"Deprecated","pages":[{"group":"Deprecated","expanded":false,"pages":[{"title":"Get Workflow Details","api":"GET https://operator.opus.com/workflow/{workflowId}","href":"/api-reference/v0-jobs/get-workflow-details"},{"title":"Initiate Job","api":"POST https://operator.opus.com/job/initiate","href":"/api-reference/v0-jobs/initiate-job"},{"title":"Get Upload URL","api":"POST https://operator.opus.com/job/file/upload","href":"/api-reference/v0-jobs/get-upload-url"},{"title":"Upload File","api":"PUT {presignedUrl}","playground":"simple","href":"/api-reference/v0-jobs/upload-file"},{"title":"Execute Job","api":"POST https://operator.opus.com/job/execute","playground":"simple","href":"/api-reference/v0-jobs/execute-job"},{"title":"Get Job Execution Status","api":"GET https://operator.opus.com/job/{jobExecutionId}/status","playground":"simple","href":"/api-reference/v0-jobs/get-job-status"},{"title":"Get Job Execution Results","api":"GET https://operator.opus.com/job/{jobExecutionId}/results","playground":"simple","href":"/api-reference/v0-jobs/get-job-results"},{"title":"Job Audit Log","api":"GET https://operator.opus.com/job/{jobExecutionId}/audit","playground":"simple","href":"/api-reference/v0-jobs/job-audit-log"},{"title":"Postman Collection","icon":"rectangle-list","href":"/api-reference/v0-jobs/postman-collection"}]}]}]},{"tab":"Opus SDK","pages":[{"title":"Opus SDK","href":"/opus-sdk/overview"}]},{"tab":"Opus MCP","pages":[{"title":"Opus MCP","href":"/mcp/overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/opus-v2-9-3"}]}]},"basePath":"","title":"Create an Agent - Opus Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}