Crear agentes de IA personalizados con la API de agente
Objetivos de aprendizaje
- Describir los primeros pasos para usar la API de agente.
- Comenzar una sesión con un agente de IA mediante la API de agente y gestionar el ciclo de vida de la sesión.
Primeros pasos con la API de agente
Trabaja como desarrollador y tiene la tarea de integrar Agentforce en su sitio web para que los agentes de IA de Salesforce respondan a las preguntas de los clientes con rapidez y eficacia.
Sabe que, de esta forma, se simplifican sus flujos de trabajo y se mejoran las interacciones de usuarios, pero ¿por dónde empieza? Por la API de agente.
Veamos los pasos generales para ejecutar Agentforce con la API de agente.
Paso 1: Habilitar Agentforce y activar un agente
Primero tiene que habilitar Agentforce en su Salesforce org. Este es un paso crucial debido a que, sin él, ninguna de las configuraciones posteriores funcionará. Una vez que Agentforce esté habilitado, tiene que activar al menos un agente.
La API de agente no admite agentes de tipo “Agentforce (Predeterminado)”.
Paso 2: Crear un aplicación cliente externa y habilitar la configuración de OAuth
A continuación, tiene que crear una aplicación cliente externa en Salesforce. Esta aplicación maneja el flujo de credenciales de cliente, que es esencial para llamadas de API seguras. Habilite la configuración de OAuth para API.
Paso 3: Obtener la clave y la pregunta secreta del consumidor
Una vez que su aplicación esté configurada, debe obtener la clave y la pregunta secreta del consumidor. Estas credenciales son esenciales para autenticar sus llamadas de API. Se encuentran en su aplicación cliente externa.
Paso 4: Crear un token
Todas las llamadas a una API de agente requieren un token. Este token se usa para autenticar sus llamadas de API. Puede crear un token con la clave y la pregunta secreta del consumidor, y su nombre de dominio.
Pruébelo: Realice su primera llamada de API
Ahora viene la mejor parte: realizar llamadas a la API de agente.
Antes de llamar, debe recopilar algo de información de su organización. Para obtener más información, consulte Llamar a la API en la Guía del desarrollador de API de agente.
En una interfaz de la línea de comandos, ejecute este comando de curl para crear una nueva sesión de agente con la API de agente.
curl --location -X POST https://api.salesforce.com/einstein/ai-agent/v1/agents/{AGENT_ID}/sessions \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--data '{
"externalSessionKey": "{RANDOM_UUID}",
"instanceConfig": {
"endpoint": "https://{MY_DOMAIN_URL}"
},
"streamingCapabilities": {
"chunkTypes": ["Text"]
},
"bypassUser": true
}'Cuando esta llamada se realiza correctamente, recibe una respuesta con una Id. de sesión e información adicional. Esta es una respuesta de ejemplo.
{
"sessionId": "80ab2e16-392e-4c12-b80a-f028a58400b5",
"_links": {
"self": null,
"messages": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/sessions/80ab2e16-392e-4c12-b80a-f028a58400b5/messages"
},
"messagesStream": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/sessions/80ab2e16-392e-4c12-b80a-f028a58400b5/messages/stream"
},
"session": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/agents/0XxHr000000ysOSKAY/sessions"
},
"end": {
"href": "https://api.salesforce.com/einstein/ai-agent/v1/sessions/80ab2e16-392e-4c12-b80a-f028a58400b5"
}
},
"messages": [
{
"type": "Inform",
"id": "d27b7308-f1ab-47bd-949c-0225d5e21a8e",
"feedbackId": "",
"planId": "",
"isContentSafe": true,
"message": "Hi, I'm an AI service assistant. How can I help you?",
"result": [],
"citedReferences": []
}
]
}Ahora puede empezar a enviar mensajes al agente de IA.
La API de agente admite tanto el manejo de mensajes sincrónicos como de transmisión. Los mensajes sincrónicos son ideales para los casos de uso donde necesita la respuesta completa en una sola llamada, mientras que los mensajes de transmisión son una mejor opción para las interacciones en tiempo real, como pláticas por chat.
Una vez que finalice, recuerde cerrar sesión.
Lo que debe tener en cuenta
-
Uso de datos: El uso de la API de agente impacta en el consumo de crédito según se describe en Uso y facturación de la IA generativa.
-
Tiempos de espera de la API: La API de agente tiene un tiempo de espera de 120 segundos. Si una llamada supera el tiempo de espera, recibe una respuesta HTTP 500.
Resumen
Ahí lo tiene: Use la guía Primeros pasos con la API de agente y el código de ejemplo para empezar a integrar Agentforce en su sitio web y mejorar la experiencia de sus clientes.