Get Started
What Is Management?
As a workflow connects to more external services, gets deployed as an API that's called from the outside, and is worked on by more people, you need a single place to safely manage all of that access and permissions. Agentria provides this as a concept called Management.
Management is made up of three parts — Credential, API Key, and Member — covering everything from the authentication info needed for external service integrations, to the access keys for deployed APIs, to the people you work with.
Management: Access and Permissions in One Place
Under the Management menu in the project sidebar, you'll find three submenus grouped together: Credential, API Key, and Member.
Credential manages the authentication info your workflow needs to access external services like Google or Slack. API Key manages the keys issued when you deploy an Ability or Agent as an API. Member manages the people you work with in a project or organization, along with their permissions.
Credential: Authentication for Accessing External Services
A Credential is the authentication info your workflow needs to call an external API or connect to an external resource like a database or cloud storage. It covers things like API keys, auth tokens, passwords, and certificates, and once you register one at the project level, you can reuse it across multiple workflows.
See 🔗What Is a Credential? for more details.
API Key: Managing Access Keys for Deployed APIs
The API Key here is the same key issued when you deploy an Ability or Agent as an API under Deploy & Operations. Where a Credential is what your workflow uses to access an external service, this API Key is the opposite — it's what an external caller uses to access your Ability or Agent.
In the API Key submenu under Management, you can view every API key you've issued so far in one place, and reissue or revoke them as needed. The process of issuing a key for the first time still follows the API Release guide under Deploy & Operations.
Member: Managing the People You Work With
Member lets you invite other users to a project or organization and manage their roles and permissions.
The Member guide is still being written.
Learn More
If you'd like to explore Management for yourself, check out the docs below.
🔗What Is a Credential? — walks through the concept and role of a Credential in detail.
🔗Google Credential Guide — walks through setting up a credential to connect with Google services.
🔗Slack Credential Guide — walks through setting up a credential to connect with Slack.
🔗API Release Guide — walks through deploying an Ability or Agent as an API and issuing an API key.
Frequently Asked Questions
What is Management?
Agentria's Management is where you handle access and permissions related to your workflows in one place. It's made up of three parts: Credential for external service integrations, API Key for access to deployed APIs, and Member for the people you work with.
When should I use Management?
Use Management when you need to register authentication info for connecting to an external service, view, reissue, or revoke the keys for an API you've deployed, or invite other people to a project so you can work together.
How is the API Key in Management different from a Credential?
A Credential is what your workflow uses to access an external service like Google or Slack. An API Key in Management is the opposite — it's what an external service uses to access your own Ability or Agent. The direction of access is reversed between the two.
How does API Key relate to the API Release process under Deploy & Operations?
They're the same key, viewed from two different angles. The API Release guide under Deploy & Operations covers issuing an API key for the first time when you deploy an Ability or Agent as an API. API Key under Management covers viewing, reissuing, and revoking the keys you've already issued, all in one place.