Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.
This guide walks through every step of getting started with Orq.ai. By the end, a working AI agent that can search the web and answer questions is live, with full visibility into every call it makes.
Setting up with a coding agent or the CLI covers every step in this guide. Studio and API alternatives are included where they exist.
Sign up for a free Orq.ai account and create a workspace.
2
Set up Orq.ai
API key only
Coding agent
Open the AI Studio getting-started screen, or Settings > Organization > API Keys, and copy the key. It is displayed once.Then open a terminal and export it, replacing your-api-key-here:
export ORQ_API_KEY="your-api-key-here"
$env:ORQ_API_KEY = "your-api-key-here"
Paste this prompt into the coding agent to set everything up:
Install the Orq.ai CLI, run `orq setup`, and build me an agent with web search.
Or install the CLI directly:
curl -fsSL https://cli.orq.ai/install.sh | sh
orq setup signs in, creates a project-scoped API key, and connects the coding agents already on the machine to Orq.ai, including the Orq MCP server and Orq Skills.
orq setup mints a project-scoped API key and writes it to ~/.orq/env as a POSIX shell export. Source that file from bash or zsh to export the key for the terminal:
source ~/.orq/env
The code samples in the next steps read the key from this environment variable.
Build an Agent with the Agent keymy-assistant, using OpenAI GPT-5.6 Sol with the Web Search and Web Scraper tools.See Build Agents for the full field reference and configuration options.
CLI
AI Studio
API & SDK
MCP
orq agents create \ --key my-assistant \ --role Assistant \ --description "A helpful assistant with web search" \ --instructions "You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding." \ --path "YOUR_PROJECT_NAME" \ --model '{"id": "openai/gpt-5.6-sol", "parameters": {"temperature": 1}}' \ --settings '{"max_iterations": 5, "max_execution_time": 300, "tools": [{"type": "google_search"}, {"type": "web_scraper"}]}'
--path is where the agent is stored in the project structure, for example Default/agents. The first segment is the Project under a workspace-level API key, and a folder inside that project under the project-scoped key orq setup mints. See Projects.
See CLI reference for the full command reference. Run orq agents create --help for the full flag reference.
Open Agents in the Managed Agents section, then click Agent at the top of the list.
In the Create Agent dialog, select the model gpt-5.6-sol, set the Agent key to my-assistant, and add the description A helpful assistant with web search. See the AI Studio guide for field-by-field setup.
On the agent’s Studio page, open the model parameters and set the temperature to 1, add the Web Search and Web Scraper tools in Tools, and write the agent instructions in the Instructions panel.
Click Publish.
my-assistant agent in AI Studio
Use the Create Agent API. The key is a unique identifier for invoking the agent later, and path is the Project folder it lives in. Tools are attached under settings.tools using their built-in type.Install with pip install orq-ai-sdk (Python) or npm install @orq-ai/node (TypeScript).
curl -X POST https://my.orq.ai/v2/agents \ -H "Authorization: Bearer $ORQ_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "key": "my-assistant", "role": "Assistant", "description": "A helpful assistant with web search", "instructions": "You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding.", "path": "YOUR_PROJECT_NAME", "model": { "id": "openai/gpt-5.6-sol", "parameters": { "temperature": 1 } }, "settings": { "max_iterations": 5, "max_execution_time": 300, "tools": [ { "type": "google_search" }, { "type": "web_scraper" } ] } }'
import osfrom orq_ai_sdk import Orqwith Orq(api_key=os.getenv("ORQ_API_KEY", "")) as orq: agent = orq.agents.create( key="my-assistant", role="Assistant", description="A helpful assistant with web search", instructions=( "You are a helpful assistant. Be concise and accurate. " "When answering questions that require current or up-to-date " "information, use the web search tool to find the latest data " "before responding." ), path="YOUR_PROJECT_NAME", model={"id": "openai/gpt-5.6-sol", "parameters": {"temperature": 1}}, settings={ "max_iterations": 5, "max_execution_time": 300, "tools": [ {"type": "google_search"}, {"type": "web_scraper"}, ], }, ) print(f"Agent created: {agent.key}")
import { Orq } from '@orq-ai/node';const orq = new Orq({ apiKey: process.env.ORQ_API_KEY ?? '' });const agent = await orq.agents.create({ key: 'my-assistant', role: 'Assistant', description: 'A helpful assistant with web search', instructions: 'You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding.', path: 'YOUR_PROJECT_NAME', model: { id: 'openai/gpt-5.6-sol', parameters: { temperature: 1 } }, settings: { maxIterations: 5, maxExecutionTime: 300, tools: [ { type: 'google_search' }, { type: 'web_scraper' }, ], },});console.log(`Agent created: ${agent.key}`);
See Add Tools for the full list of built-in tool types and how to attach custom HTTP, function, or MCP tools.
If the Orq MCP server is not connected yet, install it in the editor or AI assistant, then ask the coding assistant:
Create an agent called "my-assistant" with the instructions "You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding." using the openai/gpt-5.6-sol model with temperature 1. Add the google_search and web_scraper tools. Create it in the YOUR_PROJECT_NAME project.
Replace YOUR_PROJECT_NAME with the Project shown in the top-bar project dropdown. See Projects.The assistant calls create_agent and the new Agent appears in the AI Studio.
For a guided build, install Orq Skills and let the build-agent skill handle agent design, tool selection, and configuration.
2
Call the agent
Send a message to my-assistant and read the response.
CLI
AI Studio
API & SDK
MCP
orq responses create \ --model agent/my-assistant \ --input '"What is the capital of France?"'
See CLI reference for the full command reference. Run orq responses create --help for the full flag reference.
Open the Agent in the AI Studio and use the built-in chat panel to send a message. Conversations and traces are saved automatically.
curl --request POST \ --url 'https://my.orq.ai/v3/router/responses' \ --header "Authorization: Bearer $ORQ_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "model": "agent/my-assistant", "input": "What is the capital of France?" }'
import osfrom orq_ai_sdk import Orqwith Orq(api_key=os.getenv("ORQ_API_KEY", "")) as orq: response = orq.responses.create( model="agent/my-assistant", input="What is the capital of France?", ) print(response.output[0]["content"][0]["text"]) print(response.usage)
import { Orq } from '@orq-ai/node';const orq = new Orq({ apiKey: process.env.ORQ_API_KEY ?? '' });const response = await orq.responses.create({ model: 'agent/my-assistant', input: 'What is the capital of France?',});console.log(response.output[0].content[0].text);console.log(response.usage);
Install with pip install orq-ai-sdk (Python) or npm install @orq-ai/node (TypeScript).Self-hosted and on-premise deployments serve the API under their own hostname. Pass it as server_url or serverURL instead of https://my.orq.ai, as described in Base URLs.
Streaming responses
For long-running agents or chat interfaces, use the streaming API to receive partial output as it is generated. See Execute the Agent for details.
Ask the assistant to invoke the Agent directly:
Run my-assistant with the message "What is the capital of France?" and print the response.
The assistant uses invoke_agent and returns the Agent’s reply, including any tool calls it made along the way.
3
View traces
Every Agent call is automatically traced. Execution history, token counts, latency, and cost are visible in the AI Studio, from the CLI, or queryable through MCP.
CLI
AI Studio
MCP
orq traces search
See the full execution history, including model calls, tool use, token counts, and latency.
Run orq traces search --help for the full flag reference.
Open my-assistant in the AI Studio and click the Traces tab to see the full execution history, including model calls, tool use, token counts, and latency.
my-assistant traces in AI Studio
Ask the assistant to query analytics for the Agent:
How is my-assistant performing?
The assistant calls query_analytics and returns a summary:
my-assistant analytics returned by the MCP client
Run the first experiment
Compare prompts, models, and configurations side by side to find what performs best before shipping.
Add an evaluator
Score the Agent’s outputs automatically with LLM-based, code, or human Evaluators.
Connect a knowledge base
Give the Agent access to documents and data with built-in RAG.
Log the first trace
Already running agents elsewhere? Connect via OpenTelemetry to get full trace visibility and cost tracking.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Orq.ai Documentation","description":"Documentation for Orq.ai, the EU-built control plane for enterprise AI: govern every LLM and MCP call with the AI Gateway, and ship backlog work with the Software Factory.","colors":{"primary":"#027f6b","light":"#00d2b5","dark":"#027f6b"},"logo":{"light":"https://mintcdn.com/orqai/OG_14djpK9Yasgfk/images/Orq_ai_Symbol_Dark.svg?fit=max\u0026auto=format\u0026n=OG_14djpK9Yasgfk\u0026q=85\u0026s=d01651850182afdbc6309808b688d470","dark":"https://mintcdn.com/orqai/BYq_L5I_ZDBWL_Pf/images/Orq_ai_Symbol_Light.svg?fit=max\u0026auto=format\u0026n=BYq_L5I_ZDBWL_Pf\u0026q=85\u0026s=3e372f93174202f20c31d2c045af92b9","href":"/ai-gateway/get-started/introduction"},"favicon":"https://mintcdn.com/orqai/rmwcfFw4PPljHRCz/favicon.svg?fit=max\u0026auto=format\u0026n=rmwcfFw4PPljHRCz\u0026q=85\u0026s=1827beca4e1fb46e074d8bda067f3fb1","api":{"openapi":"openapi.json","examples":{"languages":["curl","typescript","python"]}},"background":{"color":{"light":"#f7f6f5","dark":"#171717"}},"navbar":{"links":[],"primary":{"type":"button","label":"Get Started","href":"https://my.orq.ai/auth/signup"}},"footer":{"socials":{"github":"https://github.com/orq-ai","x":"https://x.com/orq_ai","linkedin":"https://www.linkedin.com/company/orqai","website":"https://orq.ai"}},"seo":{"metatags":{"author":"Orq.ai","og:type":"website","og:site_name":"Orq.ai Documentation","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@orq_ai","twitter:creator":"@orq_ai","viewport":"width=device-width, initial-scale=1.0","robots":"index, follow","language":"English"},"organization":{"id":"https://docs.orq.ai/#organization","name":"Orq.ai","legalName":"Orq.AI Holding B.V.","url":"https://orq.ai","logo":"https://docs.orq.ai/images/Orq_ai_Symbol_Dark.svg","sameAs":["https://github.com/orq-ai","https://x.com/orq_ai","https://www.linkedin.com/company/orqai/"]},"indexing":"all"},"fonts":{"heading":{"family":"ES Klarheit Kurrent Semibold","weight":600,"source":"https://framerusercontent.com/assets/HiovZWjG27S5NQhE8dyeECDMc.woff2","format":"woff2"},"body":{"family":"Inter","weight":400,"source":"fonts/inter-latin-400-normal.woff2","format":"woff2"}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"contextual":{"options":["copy","download-spec","chatgpt","claude","view"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"orqai","hasAudioNarration":false,"actualSubdomain":"orqai","customDomains":["docs.orq.ai"],"gitSource":{"type":"github","owner":"orq-ai","repo":"orquesta-web","deployBranch":"main","contentDirectory":"documentation/mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec613bada4d37850e27e55","collectionId":"97d33066-b9a1-4280-87e1-bbb0adeceadf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec613bada4d37850e27e55"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec613bada4d37850e27e55","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"API Reference","count":404},{"language":"default","tag":"Platform APIs","count":258},{"language":"default","tag":"Integrations","count":93},{"language":"default","tag":"Orq SDK","count":70},{"language":"default","tag":"AI Gateway","count":69},{"language":"default","tag":"Management APIs","count":68},{"language":"default","tag":"SDK Reference","count":67},{"language":"default","tag":"Cookbooks","count":34},{"language":"default","tag":"Model Providers","count":31},{"language":"default","tag":"Frameworks \u0026 SDKs","count":30}],"searchSettings":{"maxResults":15}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@orq.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"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":"vite-origin","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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".nav-anchor img{border-radius:50%}.ig-root{scroll-margin-top:6rem}.ig-search{width:100%;padding:10px 14px 10px 38px;border-radius:8px;border:1px solid rgba(0, 0, 0, 0.15);font-size:14px;outline:none;margin-bottom:20px;background:transparent;box-sizing:border-box;background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='none' viewBox='0 0 24 24'%3E%3Cpath stroke='%23999' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='m21 21-4.35-4.35M17 11A6 6 0 1 1 5 11a6 6 0 0 1 12 0Z'/%3E%3C/svg%3E\");background-repeat:no-repeat;background-position:12px center}.dark .ig-search{border-color:rgba(255, 255, 255, 0.15)}.ig-search:focus{border-color:#027f6b}.ig-tabs{display:flex;border-bottom:1px solid rgba(0, 0, 0, 0.1);margin-bottom:20px;gap:0}.dark .ig-tabs{border-bottom-color:rgba(255, 255, 255, 0.1)}.ig-tab{padding:8px 16px;background:none;border:none;border-bottom:2px solid transparent;margin-bottom:-1px;cursor:pointer;font-size:14px;font-weight:500;color:#888;white-space:nowrap}.ig-tab:hover{color:#027f6b}.dark .ig-tab:hover{color:#677F78}.ig-tab-active{border-bottom-color:#027f6b!important;color:#027f6b!important}.dark .ig-tab-active{border-bottom-color:#677F78!important;color:#677F78!important}.ig-grid{display:grid;grid-template-columns:repeat(4, 1fr);gap:6px}@media (max-width: 768px){.ig-grid{grid-template-columns:repeat(3, 1fr)}}@media (max-width: 480px){.ig-grid{grid-template-columns:repeat(2, 1fr)}}.ig-card{display:flex;align-items:center;gap:8px;padding:10px 14px;border:1px solid rgba(0, 0, 0, 0.1);border-radius:6px;text-decoration:none!important;color:inherit!important;font-size:14px;font-weight:500;transition:background 0.12s, border-color 0.12s}.ig-card:hover{background:rgba(2, 127, 107, 0.05);border-color:rgba(2, 127, 107, 0.25)}.dark .ig-card{border-color:rgba(255, 255, 255, 0.1)}.dark .ig-card:hover{background:rgba(103, 127, 120, 0.1);border-color:rgba(103, 127, 120, 0.3)}.ig-card-icon{width:20px;height:20px;object-fit:contain;flex-shrink:0}.ig-tab-count{display:inline-flex;align-items:center;justify-content:center;margin-left:6px;padding:0 5px;min-width:18px;height:18px;border-radius:9px;font-size:11px;font-weight:600;background:rgba(0, 0, 0, 0.08);color:inherit}.dark .ig-tab-count{background:rgba(255, 255, 255, 0.12)}.ig-tab-active .ig-tab-count{background:rgba(2, 127, 107, 0.15)}.dark .ig-tab-active .ig-tab-count{background:rgba(103, 127, 120, 0.25)}.ig-empty{text-align:center;padding:48px 24px;color:#999;font-size:14px;grid-column:1 / -1}kbd.key,kbd.key *{color:#fff!important}kbd.key{background:#242424;border-radius:5px;padding:2px 8px;font-size:0.85em;display:inline-flex;align-items:center;gap:6px;border:1px solid #3a3a3a;font-family:inherit;white-space:nowrap}#sidebar-content .flex-1:has(>svg.flex-shrink-0){flex:none!important}#sidebar-content{width:16rem!important;min-width:16rem!important}@media (min-width: 1024px){.lg\\:pl-56{padding-left:16rem!important}}.topbar-right-container nav[aria-label=\"Main\"] .navbar-link a,.topbar-right-container nav[aria-label=\"Main\"] .navbar-link a:hover{background-color:transparent!important}@media (min-width: 1024px){.topbar-right-container nav[aria-label=\"Main\"] ul{gap:1rem!important}.topbar-right-container nav[aria-label=\"Main\"] .navbar-link a{padding-left:0!important;padding-right:0!important}#page-title{font-size:2rem!important;line-height:1.2!important}}.nav-tabs-item:has(a[href^=\"/reference\"]){display:none!important}#navbar .nav-tabs-item[href=\"/ai-studio/integrations/overview\"]{position:relative}#navbar .nav-tabs-item[href=\"/ai-studio/integrations/overview\"]::before{content:'';position:absolute;top:50%;left:-12px;transform:translateY(-50%);height:55%;width:1px;background:rgba(0, 0, 0, 0.15)}.dark #navbar .nav-tabs-item[href=\"/ai-studio/integrations/overview\"]::before{background:rgba(255, 255, 255, 0.15)}@media (min-width: 1280px){#content-container{padding-left:3rem!important;padding-right:2rem!important}#content-side-layout{max-width:20rem!important}#content-area{width:calc(100% - 20rem)!important}}.md-export-list{display:none}@font-face{font-family:'Inter';src:url('/fonts/inter-latin-400-normal.woff2') format('woff2');font-style:normal;font-weight:400;font-display:optional}"}],"page":{"pagePath":"ai-studio/ai-engineering/quickstart","slug":"/ai-studio/ai-engineering/quickstart","pageMetadata":{"title":"Build an AI agent with Orq.ai","sidebarTitle":"Quickstart","description":"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.","href":"/ai-studio/ai-engineering/quickstart"},"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: \"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.\"\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`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,Card,CardGroup,CodeBlock,CodeGroup,Frame,Heading,Icon,Note,OptimizedImage,Step,Steps,Tab,Tabs,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This guide walks through every step of getting started with `,_jsx(_components.strong,{children:`Orq.ai`}),`. By the end, a working AI agent that can search the web and answer questions is live, with full visibility into every call it makes.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Setting up with a coding agent or the CLI covers every step in this guide. Studio and API alternatives are included where they exist.`})}),`\n`,_jsx(Heading,{level:`2`,id:`set-up-an-account`,children:`Set up an Account`}),`\n`,_jsxs(Steps,{titleSize:`h3`,children:[_jsx(Step,{title:`Create an Orq.ai account`,id:`create-an-orq-ai-account`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://my.orq.ai/auth/signup`,children:`Sign up`}),` for a free `,_jsx(_components.strong,{children:`Orq.ai`}),` account and create a workspace.`]})}),_jsxs(Step,{title:`Set up Orq.ai`,id:`set-up-orq-ai`,children:[_jsxs(Tabs,{children:[_jsxs(Tab,{title:`API key only`,icon:`key`,id:`api-key-only`,children:[_jsxs(_components.p,{children:[`Open the `,_jsx(_components.a,{href:`https://my.orq.ai`,children:`AI Studio`}),` getting-started screen, or `,_jsxs(_components.strong,{children:[`Settings > Organization > `,_jsx(_components.a,{href:`/ai-studio/organization/api-keys`,children:`API Keys`})]}),`, and copy the key. It is displayed once.`]}),_jsxs(_components.p,{children:[`Then open a terminal and export it, replacing `,_jsx(_components.code,{children:`your-api-key-here`}),`:`]}),_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`macOS / Linux`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`export`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` ORQ_API_KEY`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"your-api-key-here\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Windows`,numberOfLines:`1`,language:`powershell`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`powershell`,children:_jsxs(_components.code,{language:`powershell`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`$`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`env:`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`ORQ_API_KEY `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"your-api-key-here\"`})]}),`\n`]})})})]})]}),_jsxs(Tab,{title:`Coding agent`,icon:`robot`,id:`coding-agent`,children:[_jsx(_components.p,{children:`Paste this prompt into the coding agent to set everything up:`}),_jsx(CodeBlock,{filename:``,wrap:`true`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:\"Install the Orq.ai CLI, run `orq setup`, and build me an agent with web search.\"})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Or install the CLI directly:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` https://cli.orq.ai/install.sh`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` |`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:` sh`})]}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`orq setup`}),` signs in, creates a project-scoped API key, and connects the coding agents already on the machine to `,_jsx(_components.strong,{children:`Orq.ai`}),`, including the `,_jsx(_components.strong,{children:`Orq MCP`}),` server and `,_jsx(_components.strong,{children:`Orq Skills`}),`.`]}),_jsxs(Tip,{children:[_jsxs(_components.p,{children:[`Connecting a coding assistant directly? See `,_jsx(_components.a,{href:`/ai-studio/integrations/code-assistants/orq-skills`,children:`Orq Skills`}),` and `,_jsx(_components.a,{href:`/ai-studio/integrations/code-assistants/orq-mcp`,children:`Orq MCP`}),`.`]}),_jsxs(_components.p,{children:[`Full command list: `,_jsx(_components.a,{href:`/reference/cli`,children:`CLI reference`}),`.`]})]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`orq setup`}),` mints a project-scoped API key and writes it to `,_jsx(_components.code,{children:`~/.orq/env`}),` as a POSIX shell export. Source that file from bash or zsh to export the key for the terminal:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`source`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` ~/.orq/env`})]}),`\n`]})})})]})]}),_jsx(_components.p,{children:`The code samples in the next steps read the key from this environment variable.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`create-and-run-an-agent`,children:`Create and run an Agent`}),`\n`,_jsxs(Steps,{titleSize:`h3`,children:[_jsxs(Step,{title:`Build an agent`,id:`build-an-agent`,children:[_jsxs(_components.p,{children:[`Build an `,_jsx(_components.strong,{children:`Agent`}),` with the `,_jsx(_components.strong,{children:`Agent key`}),` `,_jsx(_components.code,{children:`my-assistant`}),`, using `,_jsx(_components.strong,{children:`OpenAI GPT-5.6 Sol`}),` with the `,_jsx(_components.strong,{children:`Web Search`}),` and `,_jsx(_components.strong,{children:`Web Scraper`}),` tools.`]}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/build-agents`,children:`Build Agents`}),` for the full field reference and configuration options.`]}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`CLI`,icon:`terminal`,id:`cli`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`orq`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` agents`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` create`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --key`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` my-assistant`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --role`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` Assistant`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --description`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"A helpful assistant with web search\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --instructions`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding.\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --path`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"YOUR_PROJECT_NAME\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --model`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '{\"id\": \"openai/gpt-5.6-sol\", \"parameters\": {\"temperature\": 1}}'`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --settings`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '{\"max_iterations\": 5, \"max_execution_time\": 300, \"tools\": [{\"type\": \"google_search\"}, {\"type\": \"web_scraper\"}]}'`})]}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--path`}),` is where the agent is stored in the project structure, for example `,_jsx(_components.code,{children:`Default/agents`}),`. The first segment is the `,_jsx(_components.strong,{children:`Project`}),` under a workspace-level API key, and a folder inside that project under the project-scoped key `,_jsx(_components.code,{children:`orq setup`}),` mints. See `,_jsx(_components.a,{href:`/ai-studio/get-started/projects`,children:`Projects`}),`.`]}),_jsxs(Tip,{children:[`See `,_jsx(_components.a,{href:`/reference/cli`,children:`CLI reference`}),` for the full command reference. Run `,_jsx(_components.code,{children:`orq agents create --help`}),` for the full flag reference.`]})]}),_jsxs(Tab,{title:`AI Studio`,icon:`https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=ac04dd509320d58ab9701cb6d6137733`,\"data-og-width\":`100`,width:`100`,\"data-og-height\":`100`,height:`100`,\"data-path\":`images/logos/ai-studio-round.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=280\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=d9df8d5b2ef07a766e62eaa0623240cd 280w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=560\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=3c40989d2bc47d1ec6d05f8eb3a585dd 560w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=840\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=2c40a18399d00e68a15d7d1262484486 840w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=3e853add10f479adccee3068427de43d 1100w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=71d1130736022278f4de6d95e7583c9b 1650w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=41a312377a09cf0f6da1edb9b02b695c 2500w`,id:`ai-studio`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Agents`}),` in the `,_jsx(_components.strong,{children:`Managed Agents`}),` section, then click `,_jsxs(`kbd`,{children:[_jsx(Icon,{icon:`plus`}),` Agent`]}),` at the top of the list.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Create Agent`}),` dialog, select the model `,_jsx(_components.code,{children:`gpt-5.6-sol`}),`, set the `,_jsx(_components.strong,{children:`Agent key`}),` to `,_jsx(_components.code,{children:`my-assistant`}),`, and add the description `,_jsx(_components.code,{children:`A helpful assistant with web search`}),`. See the `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/build-agents`,children:`AI Studio guide`}),` for field-by-field setup.`]}),`\n`,_jsxs(_components.li,{children:[`On the agent’s `,_jsx(_components.strong,{children:`Studio`}),` page, open the model parameters and set the temperature to `,_jsx(_components.code,{children:`1`}),`, add the `,_jsx(_components.strong,{children:`Web Search`}),` and `,_jsx(_components.strong,{children:`Web Scraper`}),` tools in `,_jsx(_components.strong,{children:`Tools`}),`, and write the agent instructions in the `,_jsx(_components.strong,{children:`Instructions`}),` panel.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(`kbd`,{className:`key`,children:`Publish`}),`.`]}),`\n`]}),_jsx(Frame,{caption:`my-assistant agent in AI Studio`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=c7c4aff43fe01374123fd8245bf69d5c`,alt:`my-assistant agent in AI Studio`,loading:`lazy`,\"data-og-width\":`1517`,width:`1517`,\"data-og-height\":`888`,height:`888`,\"data-path\":`images/my-assistant-quickstart.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?w=280\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=dbda16cf2b88884329f58c517ae2d5fa 280w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?w=560\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=a8c4723c5c5024af0f1934da1a6cdeb0 560w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?w=840\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=976efb70bed68c0415d3d1bc2a97c738 840w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=aa1ba24e48ce1f9d6a6fc6af008b4c38 1100w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=fb7d8f282852926f05f75342212dab7d 1650w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-quickstart.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=6dbc8e0c5a279f344b2cbb723d157c1f 2500w`})})]}),_jsxs(Tab,{title:`API \u0026 SDK`,icon:`code`,id:`api-%26-sdk`,children:[_jsxs(_components.p,{children:[`Use the `,_jsx(_components.a,{href:`/reference/agents/create-agent`,children:`Create Agent API`}),`. The `,_jsx(_components.code,{children:`key`}),` is a unique identifier for invoking the agent later, and `,_jsx(_components.code,{children:`path`}),` is the `,_jsx(_components.strong,{children:`Project`}),` folder it lives in. Tools are attached under `,_jsx(_components.code,{children:`settings.tools`}),` using their built-in `,_jsx(_components.code,{children:`type`}),`.`]}),_jsxs(_components.p,{children:[`Install with `,_jsx(_components.code,{children:`pip install orq-ai-sdk`}),` (Python) or `,_jsx(_components.code,{children:`npm install @orq-ai/node`}),` (TypeScript).`]}),_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`19`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -X`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` POST`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` https://my.orq.ai/v2/agents`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`$ORQ_API_KEY`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -d`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"key\": \"my-assistant\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"role\": \"Assistant\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"description\": \"A helpful assistant with web search\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"instructions\": \"You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"path\": \"YOUR_PROJECT_NAME\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"model\": { \"id\": \"openai/gpt-5.6-sol\", \"parameters\": { \"temperature\": 1 } },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"settings\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"max_iterations\": 5,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"max_execution_time\": 300,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"tools\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` { \"type\": \"google_search\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` { \"type\": \"web_scraper\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`26`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`26`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` os`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq_ai_sdk `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` Orq`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`with`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` Orq(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:`api_key`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`os.getenv(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"ORQ_API_KEY\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`)) `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`as`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` agent `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq.agents.create(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` key`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"my-assistant\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` role`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Assistant\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` description`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"A helpful assistant with web search\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` instructions`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"You are a helpful assistant. Be concise and accurate. \"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"When answering questions that require current or up-to-date \"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"information, use the web search tool to find the latest data \"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"before responding.\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` ),`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` path`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"YOUR_PROJECT_NAME\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` model`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`{`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"openai/gpt-5.6-sol\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"parameters\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: {`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"temperature\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`1`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`}},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` settings`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"max_iterations\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`5`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"max_execution_time\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`300`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"tools\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` {`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"google_search\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` {`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"web_scraper\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` )`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` print`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`f`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Agent created: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`{`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`agent.key`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`}`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`23`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`23`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` { Orq } `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`from`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '@orq-ai/node'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` orq`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` new`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:` Orq`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`({ apiKey: process.env.`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`ORQ_API_KEY`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` ??`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` ''`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` agent`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` await`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq.agents.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`create`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` key: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'my-assistant'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` role: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'Assistant'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` description: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'A helpful assistant with web search'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` instructions:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding.'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` path: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'YOUR_PROJECT_NAME'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` model: { id: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'openai/gpt-5.6-sol'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`, parameters: { temperature: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`1`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` } },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` settings: {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` maxIterations: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`5`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` maxExecutionTime: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`300`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` tools: [`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` { type: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'google_search'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` { type: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'web_scraper'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`console.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:\"`Agent created: ${\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`agent`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`.`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`key`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:\"}`\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`);`})]}),`\n`]})})})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/build-agents#add-tools`,children:`Add Tools`}),` for the full list of built-in tool types and how to attach custom HTTP, function, or MCP tools.`]})})]}),_jsxs(Tab,{title:`MCP`,icon:`https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=85ff775ba1532474fb9d6b4e81adc322`,\"data-og-width\":`16`,width:`16`,\"data-og-height\":`16`,height:`16`,\"data-path\":`images/logos/mcp.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=280\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=180551a6d1b3b915c5f0b83e34e5bc0d 280w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=560\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=e5a06a9650d340698043766e024c7766 560w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=840\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=3fcbab367f8208f504acc6f00b6f6830 840w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=a0c4c5b285447d27d21e394c3576f701 1100w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=866eb1cb70e44a2035ec43c6364f13f3 1650w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=8925e81917c2cd7c2e94b2cc14560a77 2500w`,id:`mcp`,children:[_jsxs(_components.p,{children:[`If the `,_jsxs(_components.a,{href:`/ai-studio/integrations/code-assistants/orq-mcp`,children:[_jsx(_components.strong,{children:`Orq MCP`}),` server`]}),` is not connected yet, install it in the editor or AI assistant, then ask the coding assistant:`]}),_jsx(CodeBlock,{filename:``,wrap:`true`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Create an agent called \"my-assistant\" with the instructions \"You are a helpful assistant. Be concise and accurate. When answering questions that require current or up-to-date information, use the web search tool to find the latest data before responding.\" using the openai/gpt-5.6-sol model with temperature 1. Add the google_search and web_scraper tools. Create it in the YOUR_PROJECT_NAME project.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`YOUR_PROJECT_NAME`}),` with the `,_jsx(_components.strong,{children:`Project`}),` shown in the top-bar project dropdown. See `,_jsx(_components.a,{href:`/ai-studio/get-started/projects`,children:`Projects`}),`.`]}),_jsxs(_components.p,{children:[`The assistant calls `,_jsx(_components.code,{children:`create_agent`}),` and the new `,_jsx(_components.strong,{children:`Agent`}),` appears in the `,_jsx(_components.strong,{children:`AI Studio`}),`.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`For a guided build, install `,_jsx(_components.a,{href:`/ai-studio/integrations/code-assistants/orq-skills`,children:_jsx(_components.strong,{children:`Orq Skills`})}),` and let the `,_jsx(_components.strong,{children:`build-agent`}),` skill handle agent design, tool selection, and configuration.`]})})]})]})]}),_jsxs(Step,{title:`Call the agent`,id:`call-the-agent`,children:[_jsxs(_components.p,{children:[`Send a message to `,_jsx(_components.code,{children:`my-assistant`}),` and read the response.`]}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`CLI`,icon:`terminal`,id:`cli-2`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`orq`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` responses`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` create`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --model`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` agent/my-assistant`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --input`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '\"What is the capital of France?\"'`})]}),`\n`]})})}),_jsxs(Tip,{children:[`See `,_jsx(_components.a,{href:`/reference/cli`,children:`CLI reference`}),` for the full command reference. Run `,_jsx(_components.code,{children:`orq responses create --help`}),` for the full flag reference.`]})]}),_jsx(Tab,{title:`AI Studio`,icon:`https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=ac04dd509320d58ab9701cb6d6137733`,\"data-og-width\":`100`,width:`100`,\"data-og-height\":`100`,height:`100`,\"data-path\":`images/logos/ai-studio-round.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=280\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=d9df8d5b2ef07a766e62eaa0623240cd 280w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=560\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=3c40989d2bc47d1ec6d05f8eb3a585dd 560w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=840\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=2c40a18399d00e68a15d7d1262484486 840w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=3e853add10f479adccee3068427de43d 1100w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=71d1130736022278f4de6d95e7583c9b 1650w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=41a312377a09cf0f6da1edb9b02b695c 2500w`,id:`ai-studio-2`,children:_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`Agent`}),` in the `,_jsx(_components.a,{href:`https://my.orq.ai`,children:`AI Studio`}),` and use the built-in chat panel to send a message. Conversations and traces are saved automatically.`]})}),_jsxs(Tab,{title:`API \u0026 SDK`,icon:`code`,id:`api-%26-sdk-2`,children:[_jsxs(_components.p,{children:[`Invoke the `,_jsx(_components.strong,{children:`Agent`}),` by passing `,_jsx(_components.code,{children:`agent/my-assistant`}),` as the model on the `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/run-agents#run-agents`,children:`unified router responses endpoint`}),` (`,_jsx(_components.code,{children:`POST /v3/router/responses`}),`).`]}),_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --request`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` POST`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --url`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'https://my.orq.ai/v3/router/responses'`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --header`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`$ORQ_API_KEY`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --header`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` --data`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"model\": \"agent/my-assistant\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` \"input\": \"What is the capital of France?\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`11`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` os`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`from`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq_ai_sdk `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` Orq`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`with`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` Orq(`}),_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:`api_key`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`os.getenv(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"ORQ_API_KEY\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`, `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`)) `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`as`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` response `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq.responses.create(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` model`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"agent/my-assistant\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` input`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"What is the capital of France?\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` )`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` print`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(response.output[`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`0`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`][`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"content\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`][`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`0`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`][`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`])`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` print`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(response.usage)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`11`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` { Orq } `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`from`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '@orq-ai/node'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` orq`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` new`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:` Orq`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`({ apiKey: process.env.`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`ORQ_API_KEY`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` ??`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` ''`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` response`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` await`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` orq.responses.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`create`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` model: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'agent/my-assistant'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` input: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'What is the capital of France?'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`console.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(response.output[`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`0`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`].content[`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`0`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`].text);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`console.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(response.usage);`})]}),`\n`]})})})]}),_jsxs(_components.p,{children:[`Install with `,_jsx(_components.code,{children:`pip install orq-ai-sdk`}),` (Python) or `,_jsx(_components.code,{children:`npm install @orq-ai/node`}),` (TypeScript).`]}),_jsxs(_components.p,{children:[`Self-hosted and on-premise deployments serve the API under their own hostname. Pass it as `,_jsx(_components.code,{children:`server_url`}),` or `,_jsx(_components.code,{children:`serverURL`}),` instead of `,_jsx(_components.code,{children:`https://my.orq.ai`}),`, as described in `,_jsx(_components.a,{href:`/reference/base-urls`,children:`Base URLs`}),`.`]}),_jsx(Accordion,{title:`Streaming responses`,id:`streaming-responses`,children:_jsxs(_components.p,{children:[`For long-running agents or chat interfaces, use the streaming API to receive partial output as it is generated. See `,_jsx(_components.a,{href:`/ai-studio/ai-engineering/run-agents#run-agents`,children:`Execute the Agent`}),` for details.`]})})]}),_jsxs(Tab,{title:`MCP`,icon:`https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=85ff775ba1532474fb9d6b4e81adc322`,\"data-og-width\":`16`,width:`16`,\"data-og-height\":`16`,height:`16`,\"data-path\":`images/logos/mcp.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=280\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=180551a6d1b3b915c5f0b83e34e5bc0d 280w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=560\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=e5a06a9650d340698043766e024c7766 560w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=840\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=3fcbab367f8208f504acc6f00b6f6830 840w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=a0c4c5b285447d27d21e394c3576f701 1100w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=866eb1cb70e44a2035ec43c6364f13f3 1650w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=8925e81917c2cd7c2e94b2cc14560a77 2500w`,id:`mcp-2`,children:[_jsxs(_components.p,{children:[`Ask the assistant to invoke the `,_jsx(_components.strong,{children:`Agent`}),` directly:`]}),_jsx(CodeBlock,{filename:``,wrap:`true`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Run my-assistant with the message \"What is the capital of France?\" and print the response.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`The assistant uses `,_jsx(_components.code,{children:`invoke_agent`}),` and returns the `,_jsx(_components.strong,{children:`Agent`}),`’s reply, including any tool calls it made along the way.`]})]})]})]}),_jsxs(Step,{title:`View traces`,id:`view-traces`,children:[_jsxs(_components.p,{children:[`Every `,_jsx(_components.strong,{children:`Agent`}),` call is automatically traced. Execution history, token counts, latency, and cost are visible in the `,_jsx(_components.strong,{children:`AI Studio`}),`, from the `,_jsx(_components.strong,{children:`CLI`}),`, or queryable through `,_jsx(_components.strong,{children:`MCP`}),`.`]}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`CLI`,icon:`terminal`,id:`cli-3`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`orq`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` traces`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` search`})]}),`\n`]})})}),_jsx(_components.p,{children:`See the full execution history, including model calls, tool use, token counts, and latency.`}),_jsxs(Tip,{children:[`Run `,_jsx(_components.code,{children:`orq traces search --help`}),` for the full flag reference.`]})]}),_jsxs(Tab,{title:`AI Studio`,icon:`https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=ac04dd509320d58ab9701cb6d6137733`,\"data-og-width\":`100`,width:`100`,\"data-og-height\":`100`,height:`100`,\"data-path\":`images/logos/ai-studio-round.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=280\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=d9df8d5b2ef07a766e62eaa0623240cd 280w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=560\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=3c40989d2bc47d1ec6d05f8eb3a585dd 560w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=840\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=2c40a18399d00e68a15d7d1262484486 840w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=3e853add10f479adccee3068427de43d 1100w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=71d1130736022278f4de6d95e7583c9b 1650w, https://mintcdn.com/orqai/My16MDKJXrKALEHC/images/logos/ai-studio-round.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=My16MDKJXrKALEHC\u0026q=85\u0026s=41a312377a09cf0f6da1edb9b02b695c 2500w`,id:`ai-studio-3`,children:[_jsxs(_components.p,{children:[`Open `,_jsx(_components.code,{children:`my-assistant`}),` in the `,_jsx(_components.a,{href:`https://my.orq.ai`,children:`AI Studio`}),` and click the `,_jsx(_components.strong,{children:`Traces`}),` tab to see the full execution history, including model calls, tool use, token counts, and latency.`]}),_jsx(Frame,{caption:`my-assistant traces in AI Studio`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=7777e19d8593096b077e08d64b91e4d5`,alt:`my-assistant traces in AI Studio`,loading:`lazy`,\"data-og-width\":`1516`,width:`1516`,\"data-og-height\":`1043`,height:`1043`,\"data-path\":`images/my-assistant-traces.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?w=280\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=7e815ed8cf901f00b2bd6fa559facd71 280w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?w=560\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=c780220d6bae99dd1fcd45d07900702a 560w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?w=840\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=74da25f7a48ca57016655e0410472df8 840w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=96446218ea75438688d028291ea92cba 1100w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=b644564feeb03322627ac0b1b01f2f8e 1650w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-traces.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=996b05a87fac3574d9d3eb24077b1a64 2500w`})})]}),_jsxs(Tab,{title:`MCP`,icon:`https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=85ff775ba1532474fb9d6b4e81adc322`,\"data-og-width\":`16`,width:`16`,\"data-og-height\":`16`,height:`16`,\"data-path\":`images/logos/mcp.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=280\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=180551a6d1b3b915c5f0b83e34e5bc0d 280w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=560\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=e5a06a9650d340698043766e024c7766 560w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=840\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=3fcbab367f8208f504acc6f00b6f6830 840w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=a0c4c5b285447d27d21e394c3576f701 1100w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=866eb1cb70e44a2035ec43c6364f13f3 1650w, https://mintcdn.com/orqai/E6QxcuOkIZbPb-u-/images/logos/mcp.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=E6QxcuOkIZbPb-u-\u0026q=85\u0026s=8925e81917c2cd7c2e94b2cc14560a77 2500w`,id:`mcp-3`,children:[_jsxs(_components.p,{children:[`Ask the assistant to query analytics for the `,_jsx(_components.strong,{children:`Agent`}),`:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`How is my-assistant performing?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`The assistant calls `,_jsx(_components.code,{children:`query_analytics`}),` and returns a summary:`]}),_jsx(Frame,{caption:`my-assistant analytics returned by the MCP client`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=d66c4eaa47a0ad5cbc24d6ed25ebfc36`,alt:`my-assistant analytics returned by the MCP client`,loading:`lazy`,\"data-og-width\":`1037`,width:`1037`,\"data-og-height\":`307`,height:`307`,\"data-path\":`images/my-assistant-mcp-traces.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?w=280\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=e363a7a0384ad9553367bb051c6de605 280w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?w=560\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=f19d4fe8b62284c2708144c40469fc16 560w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?w=840\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=d4f76dc7fa7335592e7a263876cb839e 840w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=e494c1753e4d5c4c081e36ac3cccc637 1100w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=0f2db895d7230f502e37315d2c0719f0 1650w, https://mintcdn.com/orqai/bhQw0kXY4gf3CTsS/images/my-assistant-mcp-traces.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bhQw0kXY4gf3CTsS\u0026q=85\u0026s=f336a99ec22a25d0219997fb1303a341 2500w`})})]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Run the first experiment`,icon:`flask`,href:`/ai-studio/optimize/experiments`,children:_jsx(_components.p,{children:`Compare prompts, models, and configurations side by side to find what performs best before shipping.`})}),_jsx(Card,{title:`Add an evaluator`,icon:`clipboard-check`,href:`/ai-studio/optimize/evaluators`,children:_jsxs(_components.p,{children:[`Score the `,_jsx(_components.strong,{children:`Agent`}),`’s outputs automatically with LLM-based, code, or human `,_jsx(_components.strong,{children:`Evaluators`}),`.`]})}),_jsx(Card,{title:`Connect a knowledge base`,icon:`book`,href:`/ai-studio/ai-engineering/knowledge-bases`,children:_jsxs(_components.p,{children:[`Give the `,_jsx(_components.strong,{children:`Agent`}),` access to documents and data with built-in RAG.`]})}),_jsx(Card,{title:`Log the first trace`,icon:`chart-line`,href:`/ai-studio/observability/quickstart`,children:_jsx(_components.p,{children:`Already running agents elsewhere? Connect via OpenTelemetry to get full trace visibility and cost tracking.`})})]})]})}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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Build an AI agent with Orq.ai","sidebarTitle":"Quickstart","description":"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.","href":"/ai-studio/ai-engineering/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Set up an Account","slug":"set-up-an-account","depth":2,"children":[{"title":"Create an Orq.ai account","slug":"create-an-orq-ai-account","depth":3,"children":[]},{"title":"Set up Orq.ai","slug":"set-up-orq-ai","depth":3,"children":[]}]},{"title":"Create and run an Agent","slug":"create-and-run-an-agent","depth":2,"children":[{"title":"Build an agent","slug":"build-an-agent","depth":3,"children":[]},{"title":"Call the agent","slug":"call-the-agent","depth":3,"children":[]},{"title":"View traces","slug":"view-traces","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/orqai/19ee3574279bbaa0/gtm.js","/_mintlify/custom/orqai/1f1a49b99957b631/commonroom-signals.js"],"subdomain":"orqai","siteName":"Orq.ai Documentation","title":"Build an AI agent with Orq.ai - Orq.ai Documentation","contextualStarterQuestions":[{"_id":"6adf5231563be818d5755808","deploymentId":"68c9bcd7a1b07562da8b036b","questionText":"How do I create an Orq.ai account?","status":"active","generatedBy":"contextual","path":"ai-studio/ai-engineering/quickstart","createdAt":"2026-10-26T13:14:25.674Z","updatedAt":"2026-10-26T13:14:25.674Z","__v":0},{"_id":"6adf5231563be818d5755809","deploymentId":"68c9bcd7a1b07562da8b036b","questionText":"What is the Orq.ai CLI setup?","status":"active","generatedBy":"contextual","path":"ai-studio/ai-engineering/quickstart","createdAt":"2026-10-26T13:14:25.674Z","updatedAt":"2026-10-26T13:14:25.674Z","__v":0},{"_id":"6adf5231563be818d575580a","deploymentId":"68c9bcd7a1b07562da8b036b","questionText":"How do I build a web search agent?","status":"active","generatedBy":"contextual","path":"ai-studio/ai-engineering/quickstart","createdAt":"2026-10-26T13:14:25.674Z","updatedAt":"2026-10-26T13:14:25.674Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T13:13:53.525Z","originalFileLocation":"ai-studio/ai-engineering/quickstart.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=\"system\"}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=\"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Orq.ai Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_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/orqai/5zquLIiRlftT1q7X/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Build an AI agent with Orq.ai - Orq.ai Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Orq.ai Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://orqai.mintlify.site/_mintlify/api/og/v2?division=Overview\u0026amp;title=Build+an+AI+agent+with+Orq.ai\u0026amp;description=Build+an+AI+agent+with+Orq.ai%3A+set+up+a+coding+agent+or+the+CLI%2C+connect+a+model%2C+add+tools%2C+and+call+it+from+code.+Beginner-friendly%2C+no+AI+experience+needed.\u0026amp;theme=0116d0baa6ba6403f431e631\u0026amp;signature=99af661ee1304c6bd286b7af99b53062194aaf99fe1e0f00c6d746774741975c\">\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=\"Build an AI agent with Orq.ai - Orq.ai Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://orqai.mintlify.site/_mintlify/api/og/v2?division=Overview\u0026amp;title=Build+an+AI+agent+with+Orq.ai\u0026amp;description=Build+an+AI+agent+with+Orq.ai%3A+set+up+a+coding+agent+or+the+CLI%2C+connect+a+model%2C+add+tools%2C+and+call+it+from+code.+Beginner-friendly%2C+no+AI+experience+needed.\u0026amp;theme=0116d0baa6ba6403f431e631\u0026amp;signature=99af661ee1304c6bd286b7af99b53062194aaf99fe1e0f00c6d746774741975c\">\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/orqai/5zquLIiRlftT1q7X/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Orq.ai Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#027f6b\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"author\" content=\"Orq.ai\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@orq_ai\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"language\" content=\"English\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai-studio/ai-engineering/quickstart.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.orq.ai/#organization\",\"name\":\"Orq.ai\",\"legalName\":\"Orq.AI Holding B.V.\",\"url\":\"https://orq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.orq.ai/images/Orq_ai_Symbol_Dark.svg\"},\"sameAs\":[\"https://github.com/orq-ai\",\"https://x.com/orq_ai\",\"https://www.linkedin.com/company/orqai/\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.orq.ai#website\",\"name\":\"Orq.ai Documentation\",\"url\":\"https://docs.orq.ai\",\"publisher\":{\"@id\":\"https://docs.orq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart#webpage\",\"url\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart\",\"name\":\"Build an AI agent with Orq.ai\",\"description\":\"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.\",\"dateModified\":\"2026-10-26T13:13:53.525Z\",\"isPartOf\":{\"@id\":\"https://docs.orq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Orq.ai Documentation\",\"item\":\"https://docs.orq.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Build an AI agent with Orq.ai\",\"item\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart#article\",\"headline\":\"Build an AI agent with Orq.ai\",\"name\":\"Build an AI agent with Orq.ai\",\"description\":\"Build an AI agent with Orq.ai: set up a coding agent or the CLI, connect a model, add tools, and call it from code. Beginner-friendly, no AI experience needed.\",\"url\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.orq.ai/ai-studio/ai-engineering/quickstart#webpage\"},\"dateModified\":\"2026-10-26T13:13:53.525Z\",\"publisher\":{\"@id\":\"https://docs.orq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.orq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Orq.ai Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Orq.ai Documentation","nav":{"global":null,"tabs":[{"tab":"AI Gateway","pages":[{"title":"AI Gateway","href":"/ai-gateway/get-started/introduction"}]},{"tab":"AI Observability","pages":[{"title":"AI Observability","href":"/ai-studio/observability/quickstart"}]},{"tab":"Managed agents","groups":[{"group":"Overview","icon":"rocket","pages":[{"title":"Build an AI agent with Orq.ai","sidebarTitle":"Quickstart","href":"/ai-studio/ai-engineering/quickstart"},{"title":"Cookbooks and tutorials","sidebarTitle":"Cookbooks","description":"Step-by-step tutorials for building AI applications with Orq.ai. Covers RAG chatbots, text-to-SQL, PDF extraction, and multi-agent systems.","mode":"wide","href":"/ai-studio/cookbooks/cookbooks"},{"title":"Marketplace","sidebarTitle":"Marketplace","href":"/ai-studio/marketplace"}]},{"group":"Managed Agents","icon":"robot","pages":[{"title":"Build Agents","sidebarTitle":"Build Agents","href":"/ai-studio/ai-engineering/build-agents"},{"title":"Run Agents","sidebarTitle":"Run Agents","href":"/ai-studio/ai-engineering/run-agents"},{"title":"Schedule Agents","sidebarTitle":"Schedule Agents","href":"/ai-studio/ai-engineering/schedule-agents"},{"title":"Create Tools","sidebarTitle":"Create Tools","href":"/ai-studio/ai-engineering/create-tools"},{"title":"Skills","sidebarTitle":"Skills","href":"/ai-studio/ai-engineering/skills"},{"title":"Agent governance","sidebarTitle":"Governance","href":"/ai-studio/ai-engineering/agent-governance"},{"title":"Prompts","sidebarTitle":"Prompts","href":"/ai-studio/prompts/prompts"},{"title":"Create a Deployment","sidebarTitle":"Deployments","href":"/ai-studio/ai-engineering/deployments"}]},{"group":"Context Management","icon":"brain","pages":[{"title":"Knowledge Bases","sidebarTitle":"Knowledge Bases","href":"/ai-studio/ai-engineering/knowledge-bases"},{"title":"External Knowledge Bases","sidebarTitle":"External Knowledge Bases","href":"/ai-studio/ai-engineering/external-knowledge-bases"},{"title":"Chunking","sidebarTitle":"Chunking","href":"/ai-studio/ai-engineering/chunking"},{"title":"Memories","sidebarTitle":"Memories","href":"/ai-studio/ai-engineering/memory-stores"},{"title":"Files API","sidebarTitle":"Files","href":"/ai-studio/ai-engineering/files"}]},{"group":"Test \u0026 Evaluate","icon":"flask","pages":[{"title":"Create Playgrounds","sidebarTitle":"Playgrounds","href":"/ai-studio/prompts/playgrounds"},{"title":"Build Datasets","sidebarTitle":"Datasets","href":"/ai-studio/optimize/datasets"},{"title":"Build Experiments","sidebarTitle":"Experiments","href":"/ai-studio/optimize/experiments"},{"title":"Create Evaluators","sidebarTitle":"Evaluators","href":"/ai-studio/optimize/evaluators"},{"title":"Red Teaming","href":"/ai-studio/optimize/red-teaming"},{"title":"Agent Simulation","href":"/ai-studio/optimize/agent-simulations"}]},{"group":"Chat","icon":"https://mintlify.s3.us-west-1.amazonaws.com/orqai/images/logos/chat.svg","pages":[{"title":"Chat","sidebarTitle":"Using Chat","href":"/ai-studio/ai-chat/using-chat"}]}]},{"tab":"Administration","pages":[{"title":"Administration","href":"/ai-studio/organization/workspace-settings"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/ai-studio/integrations/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/client-libraries"}]},{"tab":"Cookbooks","hidden":true,"pages":[{"title":"Cookbooks","href":"/ai-studio/cookbooks/cookbooks"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/release-4-17"}]}]},"basePath":"","title":"Build an AI agent with Orq.ai - Orq.ai Documentation","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CK6QbnxT.js","DynamicMarkdown-BKiHAm_d.js","zoom-image-lightbox-CLQdF-Ar.js","lightbox-handle-r17bVUz3.js"]}