새로운 분야의 디자인 파트너 모집—새로운 산업을 개척하면 플랫폼을 반값에 제공
Nexevo.AI
로그인

Quickstart

첫 agent run까지 세 단계. task를 보내고 스트리밍 결과를 읽기만 하면 됩니다 — 나머지는 모두 플랫폼이 처리합니다.

1. API 키 받기

앱에서 Settings → API keys를 열고 키를 생성하세요. 키는 워크스페이스에 바인딩됩니다(sk-ws-…). API로도 생성할 수 있습니다:

POST/v1/workspaces/{workspace_id}/api-keys —

이 워크스페이스에 바인딩된 새 API 키를 생성합니다.

bash
export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"

2. task 보내기

이것이 통합의 전부입니다. 필드 하나 — task. 플랫폼이 모델을 선택하고, 작업에 필요한 도구를 호출하며, 결과를 스트리밍합니다.

bash
curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Find the 3 largest cross-border payment providers in SE Asia and summarize each in one line."}'
# -> {"run_id": "…", "trace_id": "…"}

{run_id, trace_id}를 반환합니다. 이제 run이 실행 중입니다 — 연결을 유지할 필요가 없습니다.

3. 결과 읽기

bash
curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
  -H "Authorization: Bearer $NEXEVO_API_KEY"

각 data: 줄은 하나의 이벤트입니다 — step_start, tool_call, tool_result, llm_delta(스트리밍 텍스트), 그리고 마지막으로 run_end(final_text 포함). 스트림은 종료 프레임 이후에 끝납니다.

끝입니다 — 완전한 통합을 마쳤습니다. 플랫폼이 모델 선택, 웹 검색, 결과 종합을 자동으로 처리했습니다. task 자체 외에는 아무것도 설정하지 않았습니다. 더 많은 시나리오(OpenAI SDK, knowledge base Q&A, 예약 리포트)는 Cookbook을 참고하세요.

다음 단계