Integrace přes API

Přes API napojíte CODEXIS AI Agent na vlastní nástroj: interní aplikaci, automatizační platformu nebo vlastního AI agenta, kterého provozujete u sebe. Váš systém posílá CODEXIS AI Agentovi dotazy a přílohy stejně, jako byste je psali do chatu, a dostává zpět jeho odpovědi. Na této stránce si vytvoříte API klíč a pošlete první dotaz s přílohou.

Verze APIKopírovat odkaz na nadpis

Pro správu projektů, chatů, agentů a příloh pokračujte návodem REST API v2. Níže najdete vytvoření API klíče a příklady pro API v1.

K čemu API sloužíKopírovat odkaz na nadpis

API se hodí tam, kde chcete práci CODEXIS AI Agenta zapojit do vlastního procesu. Interní systém mu třeba pošle smlouvu ke kontrole a výsledek uloží ke spisu, nebo se váš vlastní agent na CODEXIS AI Agenta obrátí s právní otázkou.

Adresa a přihlášeníKopírovat odkaz na nadpis

Base URL: https://vm.codexis.ai. Autentizace: hlavička X-Api-Key.

API vyžaduje aktivní licenci CODEXIS AI Agent. Za každý dotaz přes API se čerpají kredity z licence, stejně jako u dotazů běžně v aplikaci.

API klíčKopírovat odkaz na nadpis

Klíč vytvořte v Nastavení → Komunikační kanály → API → Vytvořit klíč.

Klíč se zobrazí jednou. Uložte ho na serveru do proměnné prostředí CODEXIS_API_KEY. Platnost klíče odpovídá licenci. Akce Odebrat ho okamžitě zneplatní.

Stav virtuálního počítačeKopírovat odkaz na nadpis

curl -H "X-Api-Key: $CODEXIS_API_KEY" https://vm.codexis.ai/api/v1/vm

Při stavu STOPPED zavolejte POST /api/v1/vm/start a počkejte na RUNNING.

Dotaz s přílohouKopírovat odkaz na nadpis

Příklad používá curl, jq, soubor smlouva.pdf a CODEXIS_API_KEY. Příkazy spouštějte ve stejném terminálu.

Nahrání přílohyKopírovat odkaz na nadpis

Pro více souborů opakujte multipart pole files.

attachments=$(curl --fail-with-body -sS \
  -H "X-Api-Key: $CODEXIS_API_KEY" \
  -F "files=@smlouva.pdf" \
  https://vm.codexis.ai/api/v1/attachments)

Odeslání dotazuKopírovat odkaz na nadpis

UUID z odpovědi na nahrání předejte jako attachmentIds.

attachment_ids=$(printf '%s' "$attachments" | jq -c '[.[].id]')
request=$(jq -n \
  --arg input "Zkontroluj výpovědní lhůty v přiložené smlouvě." \
  --argjson attachmentIds "$attachment_ids" \
  '{input: $input, attachmentIds: $attachmentIds}')
response=$(curl --fail-with-body -sS \
  -H "X-Api-Key: $CODEXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$request" \
  https://vm.codexis.ai/api/v1/chats)

Odpověď přes SSEKopírovat odkaz na nadpis

chatId identifikuje konverzaci, id zprávu agenta. Událost completed ukončí stream.

chat_id=$(printf '%s' "$response" | jq -r '.chatId')
message_id=$(printf '%s' "$response" | jq -r '.id')
curl --fail-with-body -N -H "X-Api-Key: $CODEXIS_API_KEY" \
  "https://vm.codexis.ai/api/v1/chats/$chat_id/messages/$message_id/events"

Pro další dotaz použijte stejné chatId. Každé ID přílohy lze použít pro jednu zprávu.

HTTP chybyKopírovat odkaz na nadpis

• 400: neplatný požadavek, chybějící povinný parametr nebo prázdný soubor.
• 401: neplatný API klíč nebo licence. Prázdné tělo, hlavička WWW-Authenticate: ApiKey.
• 403: přístup k cestě zamítnut.
• 404: konverzace, zpráva, příloha nebo cesta nenalezena.
• 409: konflikt, například probíhající odpověď, chybějící virtuální počítač nebo existující složka.
• 500: chyba serveru.

Chyby s JSON tělem obsahují code a message.

{ "code": "NOT_FOUND", "message": "Chat not found: 3f8b1a20-77c4-4c19-8d2e-1b9a4e6f0c85" }

ReferenceKopírovat odkaz na nadpis

Endpointy a parametry · OpenAPI