Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Déploiement d’un agent
Lorsque vous créez un agent Amazon Bedrock pour la première fois, vous disposez d’une version préliminaire (`DRAFT`) et d’un alias de test (`TSTALIASID`) qui pointe vers la version préliminaire. Lorsque vous apportez des modifications à votre agent, les modifications s’appliquent à la version préliminaire. Vous parcourez votre version préliminaire jusqu’à ce que vous soyez satisfait du comportement de l’agent. Vous pouvez ensuite configurer votre agent en vue de son déploiement et de son intégration dans votre application en créant des *alias* pour lui.
**Alias et versions**
Pour déployer votre agent, vous devez créer un *alias*. Lors de la création de l’alias, Amazon Bedrock génère une version de votre agent. L’alias pointe vers cette nouvelle version. Vous pouvez également faire pointer cet alias vers la version créée précédemment de votre agent. Configurez ensuite votre application pour qu’elle envoie des appels d’API à cet alias.
Une *version* est un instantané qui préserve la ressource telle qu’elle est au moment de sa création. Vous pouvez continuer à modifier la version préliminaire et créer d’autres alias (et, par conséquent, d’autres versions) de votre agent si nécessaire. Dans Amazon Bedrock, vous créez une nouvelle version de l’agent en créant un alias qui pointe vers la nouvelle version par défaut. Amazon Bedrock crée des versions par ordre numérique, en commençant par 1.
Les versions sont immuables, car elles constituent un instantané de votre agent au moment où vous l’avez créé. Pour mettre à jour un agent en production, vous devez créer une nouvelle version et configurer votre application pour qu’elle appelle l’alias qui pointe vers cette version.
Grâce aux alias, vous pouvez passer efficacement d’une version à l’autre de l’agent sans que l’application ait à effectuer le suivi de la version. Par exemple, vous pouvez modifier un alias pour qu’il pointe vers une version précédente de l’agent si certaines modifications doivent être rapidement annulées.
## Suspendre un agent déployé
Il se peut que vous deviez suspendre temporairement le fonctionnement d’un agent. Par exemple, lors de la maintenance, des mises à jour ou lors de la résolution de problèmes de performances. Pour suspendre un agent, vous devez utiliser l’alias de l’agent avec l’opération [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html). Pour suspendre un agent, définissez le champ `aliasInvocationState` sur `REJECT_INVOCATIONS`. Pour relancer l’exécution de l’agent, définissez `aliasInvocationState` sur `ACCEPT_INVOCATIONS`. Vous n’avez pas besoin d’apporter de modifications aux politiques IAM pour suspendre cet agent.
Pour vérifier si un agent est actuellement suspendu, appelez [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) et vérifiez le champ `aliasInvocationState`. Vous pouvez également vérifier la présence d’un alias dans le champ `aliasInvocationState` dans la réponse de [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html).
**Topics**
+ [Suspendre un agent déployé](#agent-pause)
+ [Création d’un alias pour votre agent](deploy-agent-proc.md)
+ [Affichage d’informations sur les versions d’agents dans Amazon Bedrock](agents-version-view.md)
+ [Suppression d’une version d’un agent dans Amazon Bedrock](agents-version-delete.md)
+ [Affichage d’informations sur les alias d’agents dans Amazon Bedrock](agents-alias-view.md)
+ [Modification de l’alias d’un agent dans Amazon Bedrock](agents-alias-edit.md)
+ [Suppression de l’alias d’un agent dans Amazon Bedrock](agents-alias-delete.md)
# Création d’un alias pour votre agent
La procédure suivante vous montre comment créer un alias et une version pour votre agent. Après avoir créé un alias, vous pouvez utiliser l’agent dans votre application en effectuant une demande [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) auprès d’un [point de terminaison d’exécution des agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt).
**Pour créer un alias**
+ Créez un alias et une version de votre agent. Choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes :
------
#### [ Console ]
**Pour créer un alias (et éventuellement une nouvelle version)**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Dans la section **Alias**, choisissez **Créer**.
1. Saisissez un **nom d’alias** unique et fournissez une **description** facultative.
1. Sous **Associer une version**, choisissez l’une des options suivantes :
+ Pour créer une version, choisissez **Créer une version et l’associer à cet alias**.
+ Pour utiliser une version existante, choisissez **Utiliser une version existante à associer à cet alias**. Dans le menu déroulant, choisissez la version à laquelle vous souhaitez associer l’alias.
1. Sous **Débit de sélection**, choisissez l’une des options suivantes :
+ Pour permettre à votre agent d’exécuter l’inférence de modèles aux taux définis pour votre compte, sélectionnez **À la demande (ODT)**. Pour plus d’informations, consultez [Quotas pour Amazon Bedrock](quotas.md).
+ Pour permettre à votre agent d’exécuter l’inférence de modèle à un rythme accru à l’aide d’un débit provisionné que vous avez précédemment acheté pour le modèle, sélectionnez **Débit provisionné (PT)**, puis sélectionnez un modèle provisionné. Pour plus d’informations, consultez [Augmentez la capacité d'invocation des modèles grâce au débit provisionné dans Amazon Bedrock](prov-throughput.md).
1. Sélectionnez **Créer un alias**.
------
#### [ API ]
Pour créer un alias pour un agent, envoyez une demande [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).
Les champs suivants sont obligatoires :
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/deploy-agent-proc.html)
Les champs suivants sont facultatifs :
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/deploy-agent-proc.html)
```
def create_agent_alias(self, name, agent_id):
"""
Creates an alias of an agent that can be used to deploy the agent.
:param name: The name of the alias.
:param agent_id: The unique identifier of the agent.
:return: Details about the alias that was created.
"""
try:
response = self.client.create_agent_alias(
agentAliasName=name, agentId=agent_id
)
agent_alias = response["agentAlias"]
except ClientError as e:
logger.error(f"Couldn't create agent alias. {e}")
raise
else:
return agent_alias
```
Pour plus d’informations, consultez [Bonjour agents Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------
# Affichage d’informations sur les versions d’agents dans Amazon Bedrock
Une fois que vous avez créé une version de votre agent, vous pouvez afficher des informations à son sujet ou la supprimer. Vous pouvez uniquement créer une nouvelle version d’un agent en créant un nouvel alias.
Pour découvrir comment afficher des informations sur les versions d’un agent, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes :
------
#### [ Console ]
**Pour afficher des informations sur une version d’un agent**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Sélectionnez la version à afficher dans la section **Versions**.
1. Pour afficher les détails du modèle, des groupes d’actions ou des bases de connaissances associés à la version de l’agent, choisissez le nom des informations que vous souhaitez afficher. Vous ne pouvez modifier aucune partie d’une version. Pour apporter des modifications à l’agent, utilisez la version préliminaire et créez une version.
------
#### [ API ]
Pour obtenir des informations sur la version d’un agent, envoyez une demande [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Spécifiez `agentId` et `agentVersion`.
Pour afficher les informations relatives aux versions d’un agent, envoyez une demande [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez le `agentId`. Vous pouvez préciser les paramètres facultatifs suivants :
****
| Champ | Description abrégée |
| --- | --- |
| maxResults | Nombre maximum de résultats à renvoyer en réponse. |
| nextToken | Si le nombre de résultats est supérieur à ce que vous avez spécifié dans le champ maxResults, la réponse renvoie une valeur nextToken. Pour voir le prochain lot de résultats, envoyez la valeur nextToken dans une autre demande. |
------
# Suppression d’une version d’un agent dans Amazon Bedrock
Pour découvrir comment supprimer une version d’un agent, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes :
------
#### [ Console ]
**Pour supprimer une version d’un agent**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Pour choisir la version que vous souhaitez supprimer, dans la section **Versions**, cliquez sur la case d’option en regard de la version que vous souhaitez supprimer.
1. Sélectionnez **Supprimer**.
1. Une boîte de dialogue s’affiche alors pour vous avertir des conséquences de la suppression. Pour confirmer que vous souhaitez supprimer la version, saisissez **delete** dans le champ de saisie, puis cliquez sur **Supprimer**.
1. Une bannière s’affiche alors pour vous informer que la version est en cours de suppression. Une fois la suppression terminée, une bannière de réussite s’affiche.
------
#### [ API ]
Pour supprimer une version d’un agent, envoyez une demande [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Par défaut, le paramètre `skipResourceInUseCheck` est défini sur `false`, et la suppression est arrêtée si la ressource est en cours d’utilisation. Si vous définissez `skipResourceInUseCheck` sur `true`, la ressource est supprimée même si elle est en cours d’utilisation.
------
# Affichage d’informations sur les alias d’agents dans Amazon Bedrock
Pour découvrir comment afficher des informations sur les alias d’un agent, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes :
------
#### [ Console ]
**Pour afficher les détails d’un alias**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Choisissez l’alias à afficher dans la section **Alias**.
1. Vous pouvez consulter le nom et la description de l’alias ainsi que les balises associées à l’alias.
------
#### [ API ]
Pour obtenir des informations sur un alias d’agent, envoyez une demande [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) avec un [point de terminaison pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Spécifiez `agentId` et `agentAliasId`.
Pour afficher les informations relatives aux alias d’un agent, envoyez une demande [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez le `agentId`. Vous pouvez préciser les paramètres facultatifs suivants :
****
| Champ | Description abrégée |
| --- | --- |
| maxResults | Nombre maximum de résultats à renvoyer en réponse. |
| nextToken | Si le nombre de résultats est supérieur à ce que vous avez spécifié dans le champ maxResults, la réponse renvoie une valeur nextToken. Pour voir le prochain lot de résultats, envoyez la valeur nextToken dans une autre demande. |
Pour afficher toutes les balises pour un alias, envoyez une demande [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et incluez l’Amazon Resource Name (ARN) de l’alias.
------
# Modification de l’alias d’un agent dans Amazon Bedrock
Pour savoir comment modifier l’alias d’un agent, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes :
------
#### [ Console ]
**Pour modifier un alias**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Dans la section **Alias**, cliquez sur la case d’option en regard de l’alias que vous souhaitez modifier. Puis, choisissez **Modifier**
1. Modifiez les champs existants si nécessaire. Pour plus d’informations sur ces champs, consultez [Déploiement et utilisation d’un agent Amazon Bedrock dans votre application](agents-deploy.md).
1. Sélectionnez **Save**.
**Pour ajouter ou supprimer des balises associées à un alias**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Choisissez l’alias pour lequel vous souhaitez gérer les balises dans la section **Alias**.
1. Dans la section **Tags (Balises)** choisissez **Manage tags (Gérer les balises)**.
1. Pour ajouter une balise, sélectionnez **Add new tag (Ajouter une nouvelle balise)**. Entrez ensuite une **clé** et éventuellement une **valeur**. Pour supprimer une identification, choisissez **Supprimer**. Pour plus d’informations, consultez [Balisage des ressources Amazon Bedrock](tagging.md).
1. Une fois que vous avez terminé de modifier les balises, choisissez **Envoyer**.
------
#### [ API ]
Pour modifier un alias d’agent, envoyez une demande [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Étant donné que tous les champs seront écrasés, incluez à la fois les champs que vous souhaitez mettre à jour et ceux que vous souhaitez conserver tels quels.
Pour ajouter des balises à un alias, envoyez une demande [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et incluez l’Amazon Resource Name (ARN) de l’alias. Le corps de la demande contient un champ `tags`, qui est un objet contenant une paire clé-valeur que vous spécifiez pour chaque balise.
Pour supprimer les balises d’un alias, envoyez une demande [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et incluez l’Amazon Resource Name (ARN) de l’alias. Le paramètre de demande `tagKeys` est une liste contenant les clés des balises que vous souhaitez supprimer.
------
# Suppression de l’alias d’un agent dans Amazon Bedrock
Pour découvrir comment supprimer un alias d’un agent, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes :
------
#### [ Console ]
**Pour supprimer un alias**
1. Connectez-vous à la AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ensuite, ouvrez la console Amazon Bedrock à l’adresse [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**.
1. Pour choisir l’alias que vous souhaitez supprimer, dans la section **Alias**, cliquez sur la case d’option en regard de l’alias que vous souhaitez supprimer.
1. Sélectionnez **Delete (Supprimer)**.
1. Une boîte de dialogue s’affiche alors pour vous avertir des conséquences de la suppression. Pour confirmer que vous souhaitez supprimer l’alias, saisissez **delete** dans le champ de saisie, puis choisissez **Supprimer**.
1. Une bannière s’affiche alors pour vous informer que l’alias est en cours de suppression. Une fois la suppression terminée, une bannière de réussite s’affiche.
------
#### [ API ]
Pour supprimer l’alias d’un agent, envoyez une demande [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.html) avec un [point de terminaison de compilation pour agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Par défaut, le paramètre `skipResourceInUseCheck` est défini sur `false`, et la suppression est arrêtée si la ressource est en cours d’utilisation. Si vous définissez `skipResourceInUseCheck` sur `true`, la ressource est supprimée même si elle est en cours d’utilisation.
```
def delete_agent_alias(self, agent_id, agent_alias_id):
"""
Deletes an alias of an Amazon Bedrock agent.
:param agent_id: The unique identifier of the agent that the alias belongs to.
:param agent_alias_id: The unique identifier of the alias to delete.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.delete_agent_alias(
agentId=agent_id, agentAliasId=agent_alias_id
)
except ClientError as e:
logger.error(f"Couldn't delete agent alias. {e}")
raise
else:
return response
```
Pour plus d’informations, consultez [Bonjour agents Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------