Ana içeriğe atla
Bir web sitesi veya destek yüzeyinin AI yanıtını oluşturulduğu sırada göstermesi gerektiğinde AI akışını kullanın.
POST /api/v1/connect/ai-stream
Yanıt, sunucu tarafından gönderilen olayları kullanır.

Rica etmek

curl "https://api.plato.ae/api/v1/connect/ai-stream" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "ai_agent_id",
    "conversationId": "conversation_id",
    "lastMessageId": "message_id"
  }'

Vücut

{
  agentId: string;
  conversationId: string;
  channelId?: string | null;
  lastMessageId?: string | null;
  senderId?: string | null;
}
Plato, lastMessageId’den okuyamadığı sürece senderId gereklidir. Konuşmanın zaten bir kanalı varsa veya son mesajın bir kanalı varsa channelId isteğe bağlıdır.

Olaylar

Akış, data: olaylarını gönderir. Delta olayı:
{
  "type": "delta",
  "delta": "Hello",
  "text": "Hello"
}
Tamamlanan etkinlik:
{
  "type": "done",
  "messageId": "message_id",
  "text": "Hello, how can I help?"
}
Hata olayı:
{
  "type": "error",
  "error": "Conversation not found."
}

Tarayıcı Örneği

const response = await fetch("https://api.plato.ae/api/v1/connect/ai-stream", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    agentId: "ai_agent_id",
    conversationId: "conversation_id",
    lastMessageId: "message_id",
  }),
});

const reader = response.body?.getReader();
Herkese açık web siteleri için mümkün olduğunda bu uç noktayı arka ucunuzdan arayın. Uzun ömürlü API anahtarlarını tarayıcı kodunda açığa çıkarmayın.

İzin

AI akışı şunları gerektirir:
connect360:conversation:engage