Nexevo 개발자 문서

task를 보내면 플랫폼이 나머지를 전부 처리합니다 — 알맞은 모델로 자동 라우팅하고, 알맞은 도구를 자동으로 호출하며, 결과를 스트리밍합니다. 도구 설정, 모델 선택, 엔드포인트 선택이 필요 없습니다.

task를 보내기 — 그게 전부

필드 하나 — {task} — 를 POST /v1/workspaces/{workspace_id}/agent/runs 로 보내세요. 플랫폼이 최적의 모델로 자동 라우팅하고, 알맞은 도구를 자동으로 호출하며, 결과를 스트리밍합니다. 여러분이 도구를 연결하거나 모델을 고르거나 엔드포인트를 선택할 일은 없습니다.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Summarize today's top AI news."}'
# -> {"run_id": "…", "trace_id": "…"}

POST는 {run_id, trace_id}를 반환합니다. GET …/agent/runs/{run_id}/attach 로 스트리밍 결과를 따라가세요. 전체 3단계 흐름은 Quickstart를 참고하세요.

플랫폼이 대신 처리해 주는 일

Auto-routing — 플랫폼이 당신의 작업에 빠른 chat 응답이 필요한지, 아니면 완전한 자율 agent run이 필요한지 판단합니다. 하나의 엔드포인트로 보내기만 하면, 차선은 플랫폼이 선택합니다.
Built-in tools — 웹 검색, 당신의 knowledge base, 코드 실행, 실제 브라우저, 파일 생성(PDF/docx/slides) — 모두 필요에 따라 자동 호출됩니다. 설정하거나 선택할 필요가 없습니다. 작동 방식을 참고하세요.
Streamed output — 모든 단계(계획, 도구 호출, 추론, 최종 답변)가 실시간으로 스트리밍됩니다. 당신은 결과를 읽기만 하면 됩니다.

더 많은 제어가 필요한가요? (모두 선택 사항)

나머지 모든 매개변수는 선택적 override입니다 — model 고정, budget_usd 설정, 전문 role 연결, 또는 run을 project의 지식에 기반시키기. 어느 것도 필수가 아닙니다. 전체 기능 영역은 Agent runs을 참고하세요.

통합 방법

방식	적합한 경우	수고
`REST API`	완전한 제어, 모든 언어	task 보내기 — Quickstart 참고
`OpenAI / Anthropic SDK`	이미 이 SDK들을 사용 중	base URL + key 변경 — Compatibility 참고
`MCP server`	Claude Desktop, Cursor, MCP 클라이언트	하나의 URL 가리키기 — MCP 참고