Quando colleghi questo connettore a un agente, l’agente non impara gli strumenti a memoria: se li fa dire, e li usa quando servono. Per questo un connettore aggiornato porta strumenti nuovi senza che l’agente vada rifatto.
Durante una conversazione il giro e’ sempre lo stesso: l’agente capisce dalla tua richiesta quale strumento serve e con quali valori usarlo, il gateway lo esegue e restituisce il risultato, e l’agente te lo racconta a parole. Chi compie l’operazione resti tu: l’accesso avviene con credenziali verificate, cosi’ il connettore puo’ distinguere cosa e’ permesso a te da cosa e’ permesso a un altro.
When you connect this connector to an agent, the agent doesn’t learn its tools by heart: it is told what they are, and uses them when they are needed. That is why an updated connector brings new tools along without the agent having to be rebuilt.
During a conversation the loop is always the same: the agent works out from your request which tool is needed and with which values, the gateway runs it and returns the result, and the agent tells you in plain words. You remain the one performing the operation: access happens with verified credentials, so the connector can tell what you are allowed to do from what someone else is allowed to do.
search_knowledgeask_agentget_reply.
{
"tool": "search_knowledge",
"parameters": {
"memori_id": "<string>",
"query": "<string>"
}
}
8 strumenti. Non li chiami tu: li sceglie l’agente in base a quello che gli chiedi. Servono a farti capire cosa puoi aspettarti e quali informazioni ti verranno chieste. L’elenco effettivo puo’ variare con la configurazione del collegamento. 8 tools. You don’t call them yourself: the agent picks them based on what you ask. They are here so you can see what to expect and which details you will be asked for. The actual list may vary depending on how the connection is configured.
search_knowledge
Cerca nella CONOSCENZA di un altro agente AIsuru (ricerca semantica, veloce, senza generazione LLM). Usa questo quando ti serve un'informazione gia' presente nella memoria dell'agente target. Passa memori_id e query.
Search the KNOWLEDGE of another AIsuru agent (semantic search, fast, no LLM generation). Use this when you need information already stored in the target agent's memory. Pass memori_id and query.
Gli serve:It needs: memori_idstring querystring
Puo’ usare:It may use: max_results conversation_id
{
"tool": "search_knowledge",
"parameters": {
"memori_id": "<string>",
"query": "<string>"
}
}
ask_agent
Fai una DOMANDA conversazionale a un altro agente AIsuru (risposta generata dal suo LLM, puo' essere lenta). Ritorna subito la risposta se pronta, altrimenti uno status="pending" con request_id: in tal caso richiama get_reply.
Ask another AIsuru agent a conversational QUESTION (answer generated by its LLM, it can be slow). Returns the answer immediately if ready, otherwise a status="pending" with a request_id: in that case call get_reply.
Gli serve:It needs: memori_idstring textstring
Puo’ usare:It may use: conversation_id password
{
"tool": "ask_agent",
"parameters": {
"memori_id": "<string>",
"text": "<string>"
}
}
get_reply
Ritira la risposta di una ask_agent precedente usando il request_id. Ritorna status="done" con l'emission quando pronta, oppure "pending".
Retrieve the answer of a previous ask_agent using the request_id. Returns status="done" with the emission when ready, or "pending".
Gli serve:It needs: request_idstring
{
"tool": "get_reply",
"parameters": {
"request_id": "<string>"
}
}
open-session
Apre (o riusa) una sessione di dialogo con un agente AIsuru. Passa memori_id (birthDate ha un default, password opzionale). Ritorna session_id e conversation_id.
Opens (or reuses) a dialogue session with an AIsuru agent. Pass memori_id (birthDate has a default, password is optional). Returns session_id and conversation_id.
Gli serve:It needs: memori_idstring
Puo’ usare:It may use: birthDate password
{
"tool": "open-session",
"parameters": {
"memori_id": "<string>"
}
}
send-text
Invia un messaggio a una sessione aperta (session_id) e ottieni la risposta dell'agente. Se l'agente e' lento ritorna status="pending"+request_id: in tal caso usa get_reply per ritirare la risposta.
Send a message to an open session (session_id) and get the agent's reply. If the agent is slow it returns status="pending"+request_id: in that case use get_reply to retrieve the answer.
Gli serve:It needs: session_idstring textstring
{
"tool": "send-text",
"parameters": {
"session_id": "<string>",
"text": "<string>"
}
}
get-session-info
Verifica se una sessione e' ancora valida.
Check whether a session is still valid.
Gli serve:It needs: session_idstring
{
"tool": "get-session-info",
"parameters": {
"session_id": "<string>"
}
}
list_conversations
Elenca le conversazioni aperte verso altri agenti per il chiamante corrente.
List the open conversations toward other agents for the current caller.
{
"tool": "list_conversations",
"parameters": {}
}
close_conversation
Chiude una conversazione (libera la sessione verso l'agente target).
Close a conversation (releases the session toward the target agent).
Gli serve:It needs: conversation_idstring
{
"tool": "close_conversation",
"parameters": {
"conversation_id": "<string>"
}
}
Elenco rilevato il 11/08/2026. List observed on Aug 11, 2026.