# Aino agents (IRPCAgent)

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/

Connects M-Files clients to the Aino agents of M-Files Cloud.

- **gRPC service:** `MFiles.IRPCAgent`
- **Book and level:** [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md), standard
- **Methods:** 3
- **Proto file:** [`mfiles/IRPCAgent.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/IRPCAgent.proto)

<a id="overview"></a>

## Overview

The M-Files clients use this service for Aino features. The server forwards each request to
the Aino agent service on behalf of the session's user and returns the agent's answer. The
payloads are text documents in formats defined by the M-Files clients and the agent service,
and they change with them; applications should not depend on them.

- [AgentCreateSummarization](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/AgentCreateSummarization/index.md): a summary of a
  set of objects.
- [CreateAgentResponse](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CreateAgentResponse/index.md): one turn with the
  general Aino agent.
- [CallAgentApiV2](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CallAgentApiV2/index.md): a call to version 2 of the agent
  service API.

Prerequisites: a vault session of a user, and a vault whose subscription includes Aino; without
it the calls fail with "Your current subscription does not include the specified feature.".
Methods that are not available on the server fail with "Not implemented.". When the agent
service cannot be reached, or fails, the call fails with "Aino agent request failed." (or "Aino
Summarization failed."); the details are only in the server log.

<a id="methods"></a>

## Methods

| Method | Summary | Facts |
|---|---|---|
| [AgentCreateSummarization](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/AgentCreateSummarization/index.md) | Creates an Aino summary of a set of objects. Used by M-Files clients; the request and response formats are internal to them. | `write` `session` `idempotent` `returns metadata structure version` |
| [CallAgentApiV2](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CallAgentApiV2/index.md) | Calls version 2 of the Aino agent service API for the session's user and returns the HTTP status and body. A temporary bridge for M-Files clients that cannot call the agent service directly; it will be deprecated when they can. | `write` `session` `returns metadata structure version` |
| [CreateAgentResponse](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CreateAgentResponse/index.md) | Sends one turn to the general Aino agent and returns its answer. Used by M-Files clients; the request and response formats are internal to them. | `write` `session` `idempotent` `returns metadata structure version` |