커스텀 플러그인
Astreus 문서에서 커스텀 플러그인에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
에이전트를 위한 도구가 포함된 커스텀 플러그인을 만들고 등록합니다.
빠른 시작
전체 예제 클론하기
가장 쉬운 시작 방법은 전체 예제 저장소를 클론하는 것입니다:
git clone https://github.com/astreus-ai/examples
cd examples/custom-plugins
npm install또는 패키지만 설치하기
처음부터 직접 구축하려면:
npm install @astreus-ai/astreus환경 설정
# .env
OPENAI_API_KEY=sk-your-openai-api-key-here
DB_URL=sqlite://./astreus.db커스텀 날씨 플러그인
import { Agent, ToolDefinition, PluginDefinition } from '@astreus-ai/astreus';
// 커스텀 도구 정의
const weatherTool: ToolDefinition = {
name: 'get_weather',
description: 'Get current weather for a location',
parameters: {
location: {
name: 'location',
type: 'string',
description: 'City name',
required: true
},
units: {
name: 'units',
type: 'string',
description: 'Temperature units (celsius or fahrenheit)',
required: false,
enum: ['celsius', 'fahrenheit']
}
},
handler: async (params) => {
// 날씨 API 호출 시뮬레이션
const weather = {
temperature: 22,
conditions: 'sunny',
location: params.location as string
};
return {
success: true,
data: weather
};
}
};
// 플러그인 생성
const weatherPlugin: PluginDefinition = {
name: 'weather-plugin',
version: '1.0.0',
description: 'Weather information tools',
tools: [weatherTool]
};
// 에이전트 생성 및 플러그인 등록
const agent = await Agent.create({
name: 'WeatherAgent',
model: 'gpt-4o'
});
await agent.registerPlugin(weatherPlugin);
// 대화에서 플러그인 사용
const response = await agent.ask("What's the weather like in Tokyo?");
console.log(response); // Agent automatically uses the weather tool예제 실행하기
저장소를 클론했다면:
npm run dev처음부터 구축했다면, 위 코드로 index.ts 파일을 만들고 다음을 실행하세요:
npx tsx index.ts저장소
전체 예제는 GitHub에서 확인할 수 있습니다: examples/custom-plugins
마지막 업데이트: 2026년 7월 6일
이 섹션에서
첫 번째 에이전트
Astreus 문서에서 첫 번째 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
메모리를 갖춘 에이전트
Astreus 문서에서 메모리를 갖춘 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
지식 기반을 갖춘 에이전트
Astreus 문서에서 지식 기반을 갖춘 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
비전을 갖춘 에이전트
Astreus 문서에서 비전을 갖춘 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.