Développement development

Cette section couvre la structure de projet du gestionnaire, le workflow de développement local et la configuration des tests pour Adobe LLM Apps. Pour le contrat du gestionnaire et l’exemple de code, voir Écrire le gestionnaire d’actions.

Structure du projet

Votre référentiel lié suit cette disposition :

your-llm-app/
├── entry.js                   # Webpack entry — do not modify
├── actions/                   # One folder per action
│   ├── search-products/
│   │   └── index.js           # Handler (async function)
│   ├── get-product-details/
│   │   └── index.js
│   └── echo/
│       └── index.js
├── test/
│   ├── actions/
│   │   └── search-products.test.js
│   ├── fixtures/
│   │   └── actions.json
│   ├── html-transform.js
│   ├── jest.setup.js
│   └── server.test.js
├── server/
│   └── local.js               # Local dev server (port 9080)
├── actions.json               # Gitignored — local copy of UI metadata
├── app.config.yaml            # Adobe I/O Runtime config
├── webpack.config.js
└── package.json

Points clés :

Développement local

Vous pouvez développer et tester des gestionnaires localement sans les informations d’identification Adobe :

npm install
npm run dev:local

Cette opération crée le projet avec webpack et démarre un serveur HTTP Node.js simple sur http://localhost:9080. Le serveur détecte automatiquement vos fichiers de gestionnaire sous actions/ et les enregistre en tant qu’outils MCP.

Télécharger actions.json

Pour que le serveur local soit informé des métadonnées de votre action (nom, description, schéma d’entrée), téléchargez les actions.json à partir de la page Actions de l’interface utilisateur de LLM Apps et placez-les à la racine du référentiel. Sans cela, le serveur découvre vos gestionnaires mais les enregistre avec un minimum de métadonnées.

Vous pouvez également copier des actions.example.json dans actions.json comme point de départ.

Test avec curl

# List all registered tools
curl -sX POST "http://localhost:9080" \
  -H 'content-type: application/json' \
  -H 'accept: application/json;q=1.0, text/event-stream;q=0.5' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Call the search-products action
curl -sX POST "http://localhost:9080" \
  -H 'content-type: application/json' \
  -H 'accept: application/json;q=1.0, text/event-stream;q=0.5' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search-products","arguments":{"category":"bagged-coffee"}}}'

Tester avec MCP Inspector

npx @modelcontextprotocol/inspector

Définissez Type de transport sur streamable-http et URL sur http://localhost:9080.

Tests

Les tests unitaires du gestionnaire sont actifs sous test/actions/ et reflètent la disposition actions/ :

// test/actions/search-products.test.js
const handler = require('../../actions/search-products/index.js')

test('returns all products when no filter is given', async () => {
  const result = await handler({})
  expect(result.content[0].text).toContain('product')
  expect(result.structuredContent.products.length).toBeGreaterThan(0)
})

test('filters by category', async () => {
  const result = await handler({ category: 'bagged-coffee' })
  expect(result.structuredContent.products.every(
    (p) => p.category === 'bagged-coffee'
  )).toBe(true)
})

test('filters by query', async () => {
  const result = await handler({ query: 'dark-roast' })
  expect(result.structuredContent.products.length).toBeGreaterThan(0)
})

test('returns empty result for unknown category', async () => {
  const result = await handler({ category: 'nonexistent' })
  expect(result.structuredContent.products).toHaveLength(0)
})

Exécutez des tests avec :

npm test                                      # all tests
npx jest test/actions/search-products        # one action only

Déploiement

Vous ne créez ni ne déployez manuellement de contenu. Pour une présentation complète du pipeline de déploiement, voir ​ Déployer votre application ​.

Votre workflow quotidien est :