Migrer vers le SDK Client 1.0

@scrydon/sdk 1.0 supprime l'ancienne surface publique de chat de workflow d'Agentic. Les exports et méthodes suivants n'existent plus :

• client.chat.stream(...)
• ChatStreamOptions
• le hook React useChatStream(...)

Les liaisons d'intégration sont structurées

Le SDK 1.0 utilise un seul objet IntegrationBinding partout où un compte ou une ressource d'intégration est sélectionné. Remplacez les anciennes chaînes persistées par la valeur structurée correspondante :

// Intégration connectée
{ connectionRef: connectionId }

// Compte explicite
{ credentialRef: accountId }

// Compte et ressource explicites
{ credentialRef: accountId, resource: { type: 'mailbox', id: mailboxId } }

// Résoudre le compte appartenant à l'identité d'exécution vérifiée
{ credentialSubject: 'acting_principal' }

// Utiliser la valeur par défaut du produit/de l'environnement
{}

Les valeurs historiques telles que accountId::resourceId et environment-connection:v1:... étaient des formats de préproduction et ne sont pas analysées par le SDK 1.0. Resélectionnez ces identifiants dans l'éditeur de workflow ; ne tentez pas de traduire des chaînes persistées opaques à l'exécution.

Appels LLM gouvernés

Utilisez client.chat.completions.create(...) pour des complétions LLM compatibles OpenAI. Votre application conserve et renvoie l'historique de conversation.

const stream = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Summarize Q3' }],
  stream: true,
})

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta.content ?? '')
}

Exécution de workflow

Utilisez client.workflows.trigger(...) pour obtenir un résultat immédiat ou client.workflows.triggerAsync(...) pour un workflow long. Ces API exécutent des workflows ; elles ne créent pas de session de chat publique.

const result = await client.workflows.trigger({
  workflowId: 'wf_abc',
  inputs: { message: 'Summarize Q3' },
})

Délégation agent-à-agent

Utilisez le point de terminaison A2A publié et un client A2A officiel lorsqu'un autre agent, tel que Cortex, délègue du travail à Scrydon. Les publications A2A et l'interface /api/chat propre à Cortex restent prises en charge et sont distinctes des anciennes routes publiques de chat d'Agentic.

Il n'existe pas de remplacement direct pour l'ancienne interface de chat hébergée ni pour son stockage de sessions. Construisez l'interface de conversation et sa persistance dans l'application appelante si elles restent nécessaires.