Astreus

Plugins personnalisés

Créez et enregistrez des plugins personnalisés avec des outils pour les agents. Découvrez les schémas de configuration, les API et les exemples pratiques...

Créez et enregistrez des plugins personnalisés avec des outils pour les agents.

Démarrage rapide

Cloner l'exemple complet

Le moyen le plus simple de démarrer est de cloner le dépôt d'exemple complet :

git clone https://github.com/astreus-ai/examples
cd examples/custom-plugins
npm install

Ou installer uniquement le package

Si vous préférez repartir de zéro :

npm install @astreus-ai/astreus

Configuration de l'environnement

# .env
OPENAI_API_KEY=sk-your-openai-api-key-here
DB_URL=sqlite://./astreus.db

Plugin météo personnalisé

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 tool

Exécuter l'exemple

Si vous avez cloné le dépôt :

npm run dev

Si vous êtes reparti de zéro, créez un fichier index.ts avec le code ci-dessus et exécutez :

npx tsx index.ts

Dépôt

L'exemple complet est disponible sur GitHub : examples/custom-plugins

Dernière mise à jour : 6 juillet 2026