Plugin personalizzati
Crea e registra plugin personalizzati con strumenti per gli agenti. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare...
Crea e registra plugin personalizzati con strumenti per gli agenti.
Avvio rapido
Clona l'esempio completo
Il modo più semplice per iniziare è clonare il repository dell'esempio completo:
git clone https://github.com/astreus-ai/examples
cd examples/custom-plugins
npm installOppure installa solo il pacchetto
Se preferisci costruire tutto da zero:
npm install @astreus-ai/astreusConfigurazione dell'ambiente
# .env
OPENAI_API_KEY=sk-your-openai-api-key-here
DB_URL=sqlite://./astreus.dbPlugin meteo personalizzato
import { Agent, ToolDefinition, PluginDefinition } from '@astreus-ai/astreus';
// Define a custom tool
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) => {
// Simulate weather API call
const weather = {
temperature: 22,
conditions: 'sunny',
location: params.location as string
};
return {
success: true,
data: weather
};
}
};
// Create plugin
const weatherPlugin: PluginDefinition = {
name: 'weather-plugin',
version: '1.0.0',
description: 'Weather information tools',
tools: [weatherTool]
};
// Create agent and register plugin
const agent = await Agent.create({
name: 'WeatherAgent',
model: 'gpt-4o'
});
await agent.registerPlugin(weatherPlugin);
// Use the plugin in conversation
const response = await agent.ask("What's the weather like in Tokyo?");
console.log(response); // Agent automatically uses the weather toolEsecuzione dell'esempio
Se hai clonato il repository:
npm run devSe hai costruito tutto da zero, crea un file index.ts con il codice sopra ed esegui:
npx tsx index.tsRepository
L'esempio completo è disponibile su GitHub: examples/custom-plugins
Ultimo aggiornamento: 6 luglio 2026
In questa sezione
Il tuo primo agente
Crea il tuo primo agente AI con il framework Astreus. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare sistemi di agenti...
Agente con memoria
Costruisci agenti con capacità di memoria persistente. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare sistemi di...
Agente con knowledge base
Crea agenti con capacità di knowledge base per un recupero delle informazioni avanzato. Scopri i pattern di configurazione, le API e gli esempi pratici...
Agente con visione
Crea agenti capaci di elaborare e analizzare immagini. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare sistemi di...