docs: update docs for the agent plugin

AdminForth/1439/add-global-plugins

Author: yaroslav8765

adminforth/documentation/docs/tutorial/09-Plugins/01-agent.md

@@ -17,8 +17,8 @@ It stores session history in your own resources and generates responses using on
 ## Installation
 
 ```bash
-pnpm i @adminforth/agent --save
-pnpm i @adminforth/completion-adapter-openai-responses --save
+pnpm add @adminforth/agent --save
+pnpm add @adminforth/completion-adapter-openai-responses --save
 ```
 
 Add your LLM credentials to `.env`:
@@ -197,17 +197,17 @@ export const admin = new AdminForth({
 });
 ```
 
-Then attach the plugin once, usually to your `adminuser` resource:
+Then attach the plugin once in `index.ts` as global plugin:
 
 Configure the plugin with `modes`. The legacy top-level `completionAdapter` setup is no longer used.
 
-```ts title="./resources/adminuser.ts"
+```ts title="./index.ts"
 import AdminForthAgent from '@adminforth/agent';
 import CompletionAdapterOpenAIResponses from '@adminforth/completion-adapter-openai-responses';
 
 ...
 
-plugins: [
+globalPlugins: [
   ...
   new AdminForthAgent({
     // optional, can be used to suggest example prompts in the UI
@@ -462,7 +462,7 @@ pnpm makemigration --name add-adminforth-agent-turn-debug ; pnpm migrate:local
 
 Tell the plugin where to store debug data:
 
-```ts title="./resources/adminuser.ts"
+```ts title="index.ts"
 new AdminForthAgent({
   modes: [
     ...
@@ -604,7 +604,7 @@ pnpm add @adminforth/audio-adapter-openai
 
 2) Import it in your users resource and add to the plugin config
 
-```ts title="./resources/adminuser.ts"
+```ts title="index.ts"
   //diff-add
   import OpenAIAudioAdapter from '@adminforth/audio-adapter-openai'
 
@@ -1010,7 +1010,7 @@ export const admin = new AdminForth({
 
 Then connect it to the plugin:
 
-```ts title="./resources/adminuser.ts"
+```ts title="index.ts"
 new AdminForthAgent({
   modes: [
     ...

dev-demo/resources/adminuser.ts

@@ -8,33 +8,8 @@ import AdminForthStorageAdapterLocalFilesystem from "../../adapters/adminforth-s
 import OpenSignupPlugin from '../../plugins/adminforth-open-signup/index.js';
 import DashboardPlugin from '../../plugins/adminforth-dashboard/index.js';
 import KeyValueAdapterRam from '../../adapters/adminforth-key-value-adapter-ram/index.js';
-import AdminForthAgent from '../../plugins/adminforth-agent/index.js';
-import CompletionAdapterOpenAIResponses from '../../adapters/adminforth-completion-adapter-openai-responses/index.js';
-import OpenAIAudioAdapter from '../../adapters/adminforth-audio-adapter-openai/index.js';
 import OAuthPlugin from './configs/oauthPluginConfig.js';
 
-const OVH_AI_ENDPOINTS_BASE_URL = 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1';
-const ovhAiEndpointsAccessToken = process.env.OVH_AI_ENDPOINTS_ACCESS_TOKEN;
-const openAiResponsesApiKey = ovhAiEndpointsAccessToken || process.env.OPENAI_API_KEY;
-const usesOvhAiEndpoints = Boolean(ovhAiEndpointsAccessToken);
-
-function createAgentCompletionAdapter(
-  model: string,
-  effort: 'low' | 'medium' | 'xhigh',
-) {
-  return new CompletionAdapterOpenAIResponses({
-    openAiApiKey: openAiResponsesApiKey as string,
-    baseUrl: usesOvhAiEndpoints ? OVH_AI_ENDPOINTS_BASE_URL : undefined,
-    model: usesOvhAiEndpoints ? 'gpt-oss-120b' : model,
-    extraRequestBodyParameters: {
-      ...(usesOvhAiEndpoints ? { store: false } : {}),
-      reasoning: {
-        effort,
-      },
-    },
-  });
-}
-
 async function allowedForSuperAdmin({ adminUser }: { adminUser: AdminUser }): Promise<boolean> {
   return adminUser.dbUser.role === 'superadmin';
 }
@@ -198,53 +173,6 @@ export default {
       },
     }),
     OAuthPlugin,
-    ...(process.env.OPENAI_API_KEY ? 
-    [
-      new AdminForthAgent({
-        audioAdapter: new OpenAIAudioAdapter({
-          apiKey: process.env.OPENAI_API_KEY,
-        }),
-        placeholderMessages: async ({ adminUser, httpExtra }) => {
-          return [
-            "What is a cars count in SQLite",
-            "Build average car price by days chart in SQLite",
-          ]
-        },
-        modes: [
-          {
-            name: 'Balanced',
-            completionAdapter: createAgentCompletionAdapter('gpt-5.4-mini', 'medium'),
-          },
-          {
-            name: 'Fast',
-            completionAdapter: createAgentCompletionAdapter('gpt-5.4-mini', 'low'),
-          },
-          {
-            name: 'Smart Thinking',
-            completionAdapter: createAgentCompletionAdapter('gpt-5.4', 'xhigh'),
-          },
-        ],
-        maxTokens: 10000,
-        reasoning: 'none',
-        sessionResource: {
-          resourceId: 'sessions',
-          idField: 'id',
-          titleField: 'title',
-          turnsField: 'turns',
-          askerIdField: 'asker_id',
-          createdAtField: 'created_at',
-        },
-        turnResource: {
-          resourceId: 'turns',
-          idField: 'id',
-          sessionIdField: 'session_id',
-          createdAtField: 'created_at',
-          promptField: 'prompt',
-          responseField: 'response',
-          debugField: 'dubbug',
-        },
-      }),
-    ] : []),
     new DashboardPlugin({
       dashboardConfigsResourceId: 'dashboard_configs',
     }),