استقرار برنامه‌های EVE در لیارا


EVE یک فریم‌ورک متن‌باز از Vercel برای ساخت و اجرای AI Agentهاست. یعنی می‌توان با یک ساختار فایل ساده، Agentهایی ساخت که ابزار، Skill , Subagent، زمان‌بندی و Human-in-the-loop داشته باشند.

برای استقرار برنامه‌های EVE در لیارا، می‌توانید طبق مراحل زیر، عمل کنید:

۱

ساخت برنامه EVE

با اجرای دستور زیر، در سیستم خود، یک برنامه EVE ایجاد کنید:

کپی
npx eve@latest init my-agent
۲

تنظیم هوش مصنوعی لیارا

برای استفاده از هوش مصنوعی لیارا در پروژه، در ابتدا در ترمینال، دستور زیر را اجرا کنید:

کپی
npm i @ai-sdk/openai-compatible

در ادامه، در مسیر agent/agent.ts، قطعه کد زیر را قرار دهید:

کپی
import { defineAgent } from "eve";
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";

const liaraProvider = createOpenAICompatible({
name: "my-provider",
baseURL: process.env.LIARA_BASE_URL!, 
apiKey: process.env.LIARA_API_KEY,    
});


export default defineAgent({
model: liaraProvider("openai/gpt-6-luna"),
modelContextWindowTokens: 128_000,
});

می‌توانید به جای مدل openai/gpt-6-luna، از سایر مدل‌های لیارا نیز، استفاده کنید.

۳

تنظیم Authentication

برای دسترسی امن به EVE، کافیست تا قطعه کد زیر را در مسیر agent/channels/eve.ts، قرار دهید:

کپی
import { timingSafeEqual } from "node:crypto";
import { eveChannel } from "eve/channels/eve";
import {
extractBearerToken,
localDev,
vercelOidc,
withAuthChallenges,
type AuthFn,
} from "eve/channels/auth";

const apiKeyAuth: AuthFn<Request> = withAuthChallenges(
(request) => {
  const expected = process.env.AGENT_API_KEY;
  const token = extractBearerToken(request.headers.get("authorization"));
  if (!expected || !token) return null;
  const a = Buffer.from(token);
  const b = Buffer.from(expected);
  if (a.length !== b.length || !timingSafeEqual(a, b)) return null;
  return {
    attributes: {},
    authenticator: "api-key",
    principalId: "api-client",
    principalType: "service",
  };
},
[{ scheme: "Bearer" }],
);

export default eveChannel({
auth: [
  apiKeyAuth,
  vercelOidc(),
  localDev(),
],
});
۴

ساخت برنامه NodeJS در لیارا

طبق مستندات ساخت برنامه NodeJS، یک برنامه NodeJS بسازید.

۵

تنظیم متغیرهای محیطی برنامه

طبق مستندات تنظیم متغیرهای محیطی، متغیرهای زیر را برای برنامه خود، تنظیم کنید:

کپی
AGENT_API_KEY=<token>
LIARA_BASE_URL=<base-url>
LIARA_API_KEY=<api-key>

مقادیر فوق را با اطلاعات واقعی، پر کنید. برای تولید مقدار AGENT_API_KEY، می‌توانید دستور زیر را اجرا کنید:

کپی
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
۶

استقرار برنامه

طبق مستندات استقرار برنامه، برنامه خود را در لیارا، مستقر کنید.

۷

اتصال به برنامه از لوکال

برای اتصال به برنامه، می‌توانید از دستور زیر استفاده کنید:

کپی
npx eve remote connect --url https://<your-url> -H "Authorization: Bearer <AGENT_API_KEY>"